MCP frameworks

Wakeshift's SDKs work inside the MCP server you already have. This page lists the MCP server frameworks for TypeScript, Python and Go, whether Wakeshift works with each one, and where to find how. On a supported framework, your server gets everything on the events page: the subscribe_events tools, your own tools that subscribe, MCP Events for clients that speak it, and the wake paths for every agent.

Not listed, or not supported yet? The HTTP API works from any server.

TypeScript

Framework	Wakeshift	How
`@modelcontextprotocol/server` 2.x (2.3 or later)	Supported	TypeScript SDK, `wake.attach`
`@modelcontextprotocol/sdk` 1.x (1.23 or later)	Supported	Using @modelcontextprotocol/sdk 1.x
Vercel `mcp-handler`	Supported	`wake.attach` on the server its `createMcpHandler` hands you, as with 2.x's
Cloudflare `agents`, `createMcpHandler`	Supported	Cloudflare Workers
Mastra `MCPServer` (`@mastra/mcp` 2.7 or later)	Supported	Mastra, `attachMastra` from `@wakeshift/sdk/mastra` (0.7.0 or later)
xmcp	Supported, without MCP Events	xmcp, `attachXmcp` from `@wakeshift/sdk/xmcp` (0.7.0 or later). Clients that only subscribe natively, such as ChatGPT, can't subscribe there
Cloudflare `agents`, `McpAgent`	Not supported	It keeps a session per client, so it refuses MCP protocol 2026-07-28. Use `createMcpHandler`
`fastmcp` (punkpeye)	Not supported	It refuses MCP protocol 2026-07-28

Python

Framework	Wakeshift	How
`mcp` 2.x, `MCPServer`	Supported	Python SDK, `wake.attach`
`mcp` 2.x, low-level `Server`	Supported	Low-level Server, `wake.attach` with `wrapped_tool` and `attached.call` (0.6.0 or later)
FastMCP 4 (`fastmcp` 4.1 or later)	Supported	FastMCP, `wake.attach` with `pip install 'wakeshift[fastmcp]'` (0.6.0 or later)
FastMCP 2.x and 3.x	Not supported	They're built on `mcp` 1.x. Use FastMCP 4

Go

Framework	Wakeshift	How
`github.com/modelcontextprotocol/go-sdk`	Supported	Go SDK, `wake.Attach`
`github.com/mark3labs/mcp-go`	Supported	mcp-go, `mcpgo.Attach`