mcp-handler

Name: mcp-handler
Author: Vercel

Frameworks & Libraries

Adapter for serving Model Context Protocol servers from Next.js, Nuxt and other web framework routes.

Latest v2.1.1 · Aug 13, 2026by VercelWebsite vercel/mcp-handler

Release activity

Release activity — 10 releases across 9 days since Oct 10, 2025. Each cell is one day; darker means more releases that day. Nothing is recorded before Oct 10, 2025. Older weeks are hidden at this screen width.
	Oct				Nov					Dec				Jan				Feb				Mar					Apr				May					Jun				Jul				Aug
Sunday		No releases on Oct 12, 2025	No releases on Oct 19, 2025	No releases on Oct 26, 2025	No releases on Nov 2, 2025	No releases on Nov 9, 2025	No releases on Nov 16, 2025	No releases on Nov 23, 2025	No releases on Nov 30, 2025	No releases on Dec 7, 2025	No releases on Dec 14, 2025	No releases on Dec 21, 2025	No releases on Dec 28, 2025	No releases on Jan 4, 2026	No releases on Jan 11, 2026	No releases on Jan 18, 2026	No releases on Jan 25, 2026	No releases on Feb 1, 2026	No releases on Feb 8, 2026	No releases on Feb 15, 2026	No releases on Feb 22, 2026	No releases on Mar 1, 2026	No releases on Mar 8, 2026	No releases on Mar 15, 2026	No releases on Mar 22, 2026	No releases on Mar 29, 2026	No releases on Apr 5, 2026	No releases on Apr 12, 2026	No releases on Apr 19, 2026	No releases on Apr 26, 2026	No releases on May 3, 2026	No releases on May 10, 2026	No releases on May 17, 2026	No releases on May 24, 2026	No releases on May 31, 2026	No releases on Jun 7, 2026	No releases on Jun 14, 2026	No releases on Jun 21, 2026	No releases on Jun 28, 2026	No releases on Jul 5, 2026	No releases on Jul 12, 2026	No releases on Jul 19, 2026	No releases on Jul 26, 2026	No releases on Aug 2, 2026	No releases on Aug 9, 2026	No releases on Aug 16, 2026
Monday		No releases on Oct 13, 2025	No releases on Oct 20, 2025	No releases on Oct 27, 2025	No releases on Nov 3, 2025	No releases on Nov 10, 2025	No releases on Nov 17, 2025	No releases on Nov 24, 2025	No releases on Dec 1, 2025	No releases on Dec 8, 2025	No releases on Dec 15, 2025	No releases on Dec 22, 2025	No releases on Dec 29, 2025	1 release on Jan 5, 2026	No releases on Jan 12, 2026	No releases on Jan 19, 2026	No releases on Jan 26, 2026	No releases on Feb 2, 2026	No releases on Feb 9, 2026	No releases on Feb 16, 2026	No releases on Feb 23, 2026	No releases on Mar 2, 2026	No releases on Mar 9, 2026	No releases on Mar 16, 2026	No releases on Mar 23, 2026	No releases on Mar 30, 2026	No releases on Apr 6, 2026	No releases on Apr 13, 2026	No releases on Apr 20, 2026	No releases on Apr 27, 2026	No releases on May 4, 2026	No releases on May 11, 2026	No releases on May 18, 2026	No releases on May 25, 2026	No releases on Jun 1, 2026	No releases on Jun 8, 2026	No releases on Jun 15, 2026	No releases on Jun 22, 2026	No releases on Jun 29, 2026	No releases on Jul 6, 2026	No releases on Jul 13, 2026	No releases on Jul 20, 2026	No releases on Jul 27, 2026	No releases on Aug 3, 2026	No releases on Aug 10, 2026	No releases on Aug 17, 2026
Tuesday		No releases on Oct 14, 2025	No releases on Oct 21, 2025	No releases on Oct 28, 2025	No releases on Nov 4, 2025	No releases on Nov 11, 2025	No releases on Nov 18, 2025	No releases on Nov 25, 2025	No releases on Dec 2, 2025	No releases on Dec 9, 2025	No releases on Dec 16, 2025	No releases on Dec 23, 2025	No releases on Dec 30, 2025	No releases on Jan 6, 2026	No releases on Jan 13, 2026	No releases on Jan 20, 2026	No releases on Jan 27, 2026	No releases on Feb 3, 2026	No releases on Feb 10, 2026	No releases on Feb 17, 2026	No releases on Feb 24, 2026	No releases on Mar 3, 2026	No releases on Mar 10, 2026	No releases on Mar 17, 2026	1 release on Mar 24, 2026	No releases on Mar 31, 2026	No releases on Apr 7, 2026	No releases on Apr 14, 2026	No releases on Apr 21, 2026	No releases on Apr 28, 2026	No releases on May 5, 2026	No releases on May 12, 2026	No releases on May 19, 2026	No releases on May 26, 2026	No releases on Jun 2, 2026	No releases on Jun 9, 2026	No releases on Jun 16, 2026	No releases on Jun 23, 2026	No releases on Jun 30, 2026	No releases on Jul 7, 2026	No releases on Jul 14, 2026	No releases on Jul 21, 2026	No releases on Jul 28, 2026	No releases on Aug 4, 2026	No releases on Aug 11, 2026	No releases on Aug 18, 2026
Wednesday		No releases on Oct 15, 2025	No releases on Oct 22, 2025	No releases on Oct 29, 2025	No releases on Nov 5, 2025	No releases on Nov 12, 2025	No releases on Nov 19, 2025	No releases on Nov 26, 2025	No releases on Dec 3, 2025	No releases on Dec 10, 2025	No releases on Dec 17, 2025	No releases on Dec 24, 2025	No releases on Dec 31, 2025	No releases on Jan 7, 2026	No releases on Jan 14, 2026	No releases on Jan 21, 2026	No releases on Jan 28, 2026	No releases on Feb 4, 2026	No releases on Feb 11, 2026	No releases on Feb 18, 2026	No releases on Feb 25, 2026	No releases on Mar 4, 2026	No releases on Mar 11, 2026	No releases on Mar 18, 2026	No releases on Mar 25, 2026	No releases on Apr 1, 2026	No releases on Apr 8, 2026	No releases on Apr 15, 2026	No releases on Apr 22, 2026	No releases on Apr 29, 2026	No releases on May 6, 2026	No releases on May 13, 2026	No releases on May 20, 2026	No releases on May 27, 2026	No releases on Jun 3, 2026	No releases on Jun 10, 2026	No releases on Jun 17, 2026	No releases on Jun 24, 2026	No releases on Jul 1, 2026	No releases on Jul 8, 2026	No releases on Jul 15, 2026	No releases on Jul 22, 2026	2 releases on Jul 29, 2026	No releases on Aug 5, 2026	No releases on Aug 12, 2026	No releases on Aug 19, 2026
Thursday		No releases on Oct 16, 2025	No releases on Oct 23, 2025	No releases on Oct 30, 2025	No releases on Nov 6, 2025	No releases on Nov 13, 2025	1 release on Nov 20, 2025	No releases on Nov 27, 2025	No releases on Dec 4, 2025	No releases on Dec 11, 2025	No releases on Dec 18, 2025	No releases on Dec 25, 2025	No releases on Jan 1, 2026	No releases on Jan 8, 2026	No releases on Jan 15, 2026	No releases on Jan 22, 2026	No releases on Jan 29, 2026	No releases on Feb 5, 2026	No releases on Feb 12, 2026	No releases on Feb 19, 2026	No releases on Feb 26, 2026	No releases on Mar 5, 2026	No releases on Mar 12, 2026	No releases on Mar 19, 2026	No releases on Mar 26, 2026	No releases on Apr 2, 2026	No releases on Apr 9, 2026	No releases on Apr 16, 2026	No releases on Apr 23, 2026	No releases on Apr 30, 2026	No releases on May 7, 2026	No releases on May 14, 2026	No releases on May 21, 2026	No releases on May 28, 2026	No releases on Jun 4, 2026	No releases on Jun 11, 2026	No releases on Jun 18, 2026	No releases on Jun 25, 2026	No releases on Jul 2, 2026	No releases on Jul 9, 2026	No releases on Jul 16, 2026	No releases on Jul 23, 2026	1 release on Jul 30, 2026	No releases on Aug 6, 2026	1 release on Aug 13, 2026
Friday	1 release on Oct 10, 2025	No releases on Oct 17, 2025	No releases on Oct 24, 2025	No releases on Oct 31, 2025	No releases on Nov 7, 2025	No releases on Nov 14, 2025	No releases on Nov 21, 2025	No releases on Nov 28, 2025	No releases on Dec 5, 2025	No releases on Dec 12, 2025	No releases on Dec 19, 2025	No releases on Dec 26, 2025	No releases on Jan 2, 2026	1 release on Jan 9, 2026	No releases on Jan 16, 2026	No releases on Jan 23, 2026	No releases on Jan 30, 2026	No releases on Feb 6, 2026	No releases on Feb 13, 2026	No releases on Feb 20, 2026	No releases on Feb 27, 2026	No releases on Mar 6, 2026	No releases on Mar 13, 2026	No releases on Mar 20, 2026	No releases on Mar 27, 2026	No releases on Apr 3, 2026	No releases on Apr 10, 2026	No releases on Apr 17, 2026	No releases on Apr 24, 2026	No releases on May 1, 2026	No releases on May 8, 2026	No releases on May 15, 2026	No releases on May 22, 2026	No releases on May 29, 2026	No releases on Jun 5, 2026	No releases on Jun 12, 2026	No releases on Jun 19, 2026	No releases on Jun 26, 2026	No releases on Jul 3, 2026	No releases on Jul 10, 2026	No releases on Jul 17, 2026	No releases on Jul 24, 2026	No releases on Jul 31, 2026	No releases on Aug 7, 2026	No releases on Aug 14, 2026
Saturday	No releases on Oct 11, 2025	No releases on Oct 18, 2025	No releases on Oct 25, 2025	No releases on Nov 1, 2025	No releases on Nov 8, 2025	No releases on Nov 15, 2025	No releases on Nov 22, 2025	No releases on Nov 29, 2025	No releases on Dec 6, 2025	No releases on Dec 13, 2025	No releases on Dec 20, 2025	No releases on Dec 27, 2025	1 release on Jan 3, 2026	No releases on Jan 10, 2026	No releases on Jan 17, 2026	No releases on Jan 24, 2026	No releases on Jan 31, 2026	No releases on Feb 7, 2026	No releases on Feb 14, 2026	No releases on Feb 21, 2026	No releases on Feb 28, 2026	No releases on Mar 7, 2026	No releases on Mar 14, 2026	No releases on Mar 21, 2026	No releases on Mar 28, 2026	No releases on Apr 4, 2026	No releases on Apr 11, 2026	No releases on Apr 18, 2026	No releases on Apr 25, 2026	No releases on May 2, 2026	No releases on May 9, 2026	No releases on May 16, 2026	No releases on May 23, 2026	No releases on May 30, 2026	No releases on Jun 6, 2026	No releases on Jun 13, 2026	No releases on Jun 20, 2026	No releases on Jun 27, 2026	No releases on Jul 4, 2026	No releases on Jul 11, 2026	No releases on Jul 18, 2026	No releases on Jul 25, 2026	No releases on Aug 1, 2026	No releases on Aug 8, 2026	No releases on Aug 15, 2026

10 releases since Oct 10, 2025, busiest day 2

Changelog

v2.1.1

LatestAug 13, 2026 · 5 days ago

Changed 1

Forward maxSubscriptions to the MCP SDK handler so applications can bound or disable subscription streams

From mcp-handler

Patch Changes

e38a932: Forward maxSubscriptions to the MCP SDK handler so applications can bound or disable subscription streams.

View originalPermalink

v2.1.0

Jul 30, 2026 · 19 days ago

Changed 1

Replace createMcpHandler(initialize, serverOptions, config) with createMcpHandler(initialize, options) using a single options object combining ServerOptions with serverInfo, verboseLogs, and onEvent, exported as McpHandlerOptions

Removed 1

Remove deprecated 1.x compatibility shims: basePath, streamableHttpEndpoint, sseEndpoint, sseMessageEndpoint, disableSse, redisUrl, maxDuration, and sessionIdGenerator

From mcp-handler

Minor Changes

8398dbd: createMcpHandler(initialize, serverOptions, config) is now createMcpHandler(initialize, options) — a single options object combining the SDK's ServerOptions with serverInfo, verboseLogs, and onEvent (exported as McpHandlerOptions). The deprecated 1.x compatibility shims (basePath, streamableHttpEndpoint, sseEndpoint, sseMessageEndpoint, disableSse, redisUrl, maxDuration, sessionIdGenerator) are removed.

View originalPermalink

v2.0.1

Jul 29, 2026 · 20 days ago

Changed 2

Mount the MCP handler directly at a framework route instead of using legacy transport endpoint routing
CLI now generates app/api/mcp/route.ts for the MCP handler

Deprecated 1

Legacy route, SSE, Redis, and session config keys remain accepted as ignored 2.x compatibility shims

From mcp-handler

Patch Changes

e6e6378: Mount the MCP handler directly at a framework route and remove legacy transport endpoint routing. The CLI now generates app/api/mcp/route.ts; deprecated route, SSE, Redis, and session config keys remain accepted as ignored 2.x compatibility shims.

View originalPermalink

v2.0.0

Jul 29, 2026 · 20 days ago

Changed 7

Upgrade to MCP SDK v2 and the 2026-07-28 MCP specification
Handler now serves the stateless 2026-07-28 protocol with per-request _meta envelope and server/discover natively
SDK's stateless legacy fallback answers 2025-era Streamable HTTP clients from the same handler
The /sse and /message endpoints answer 410 Gone
Tool/prompt/resource registration follows SDK v2 with registerTool using z.object(...) Standard Schemas
extra.authInfo is now ctx.http?.authInfo
withMcpAuth now builds 401/403 challenges with the SDK's consolidated OAuthError/bearerAuthChallengeResponse

Removed 2

Legacy HTTP+SSE transport (protocol 2024-11-05) has been removed
Variadic server.tool(...) is gone

Deprecated 2

redis dependency and redisUrl, maxDuration, and sessionIdGenerator config options are deprecated no-ops
Dynamic Client Registration is deprecated by the spec in favor of Client ID Metadata Documents

From mcp-handler

Major Changes

33c06b6: Upgrade to MCP SDK v2 and the 2026-07-28 MCP specification (CIMD era).
- The handler now serves the stateless 2026-07-28 protocol (per-request _meta envelope, server/discover) natively, with the SDK's stateless legacy fallback answering 2025-era Streamable HTTP clients from the same handler.
- Breaking: requires @modelcontextprotocol/server ^2.0.0 (replaces the @modelcontextprotocol/sdk peer dependency), zod ^4.2.0 for schemas, and Node.js 20+.
- Breaking: the legacy HTTP+SSE transport (protocol 2024-11-05) has been removed. /sse and /message endpoints answer 410 Gone; the redis dependency and redisUrl, maxDuration, and sessionIdGenerator config options are deprecated no-ops.
- Breaking: tool/prompt/resource registration follows SDK v2 (registerTool with z.object(...) Standard Schemas; variadic server.tool(...) is gone; extra.authInfo is now ctx.http?.authInfo).
- withMcpAuth now builds its 401/403 challenges with the SDK's consolidated OAuthError/bearerAuthChallengeResponse, keeping RFC 9728 resource_metadata discovery in place for CIMD-era authorization flows. Dynamic Client Registration is deprecated by the spec in favor of Client ID Metadata Documents — see README.