# 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](https://wakeshift.ai/docs/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](https://wakeshift.ai/docs/other-languages) works from any server.

## TypeScript

| Framework | Wakeshift | How |
| --- | --- | --- |
| `@modelcontextprotocol/server` 2.x (2.3 or later) | Supported | [TypeScript SDK](https://wakeshift.ai/docs/sdk), `wake.attach` |
| `@modelcontextprotocol/sdk` 1.x (1.23 or later) | Supported | [Using @modelcontextprotocol/sdk 1.x](https://wakeshift.ai/docs/sdk#using-modelcontextprotocolsdk-1x) |
| Vercel `mcp-handler` | Supported | `wake.attach` on the server its `createMcpHandler` hands you, as with [2.x's](https://wakeshift.ai/docs/sdk) |
| Cloudflare `agents`, `createMcpHandler` | Supported | [Cloudflare Workers](https://wakeshift.ai/docs/sdk#cloudflare-workers) |
| Mastra `MCPServer` (`@mastra/mcp` 2.7 or later) | Supported | [Mastra](https://wakeshift.ai/docs/sdk#mastra), `attachMastra` from `@wakeshift/sdk/mastra` (0.7.0 or later) |
| xmcp | Supported, without MCP Events | [xmcp](https://wakeshift.ai/docs/sdk#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](https://wakeshift.ai/docs/python), `wake.attach` |
| `mcp` 2.x, low-level `Server` | Supported | [Low-level Server](https://wakeshift.ai/docs/python#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](https://wakeshift.ai/docs/python#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](https://wakeshift.ai/docs/go), `wake.Attach` |
| `github.com/mark3labs/mcp-go` | Supported | [mcp-go](https://wakeshift.ai/docs/go#mcp-go), `mcpgo.Attach` |