Skip to content

fix(mcp): add MCP protocol version 2025-11-25 to supported versions#13221

Merged
aayush-kapoor merged 4 commits intovercel:mainfrom
MaxwellCalkin:fix/mcp-protocol-version-2025-11-25
Mar 9, 2026
Merged

fix(mcp): add MCP protocol version 2025-11-25 to supported versions#13221
aayush-kapoor merged 4 commits intovercel:mainfrom
MaxwellCalkin:fix/mcp-protocol-version-2025-11-25

Conversation

@MaxwellCalkin
Copy link
Contributor

Summary

Fixes #13023.

MCP servers implementing protocol version 2025-11-25 (e.g., Wrike MCP) are rejected during initialization because the AI SDK's @ai-sdk/mcp client only recognizes protocol versions up to 2025-06-18.

The 2025-11-25 protocol version is a released MCP specification and the SDK already partially references it (e.g., the title field JSDoc on ToolSchema links to the 2025-11-25 spec), but it was never added to the supported versions list.

Changes

  • types.ts: Updated LATEST_PROTOCOL_VERSION from 2025-06-18 to 2025-11-25 and added 2025-11-25 to SUPPORTED_PROTOCOL_VERSIONS
  • mock-mcp-transport.ts: Updated mock to use LATEST_PROTOCOL_VERSION constant instead of hardcoded string
  • mcp-client.test.ts: Added tests verifying servers responding with 2025-11-25 and all older supported versions are accepted

Version negotiation safety

Per the MCP spec, the client proposes its latest version and the server responds with the highest version it supports. Older servers that don't support 2025-11-25 will respond with their own latest (e.g., 2025-06-18), which the SDK already accepts. So this change is fully backward compatible.

Test plan

  • All 158 existing MCP tests pass
  • New test: server responding with 2025-11-25 is accepted
  • New test: all older supported versions (2025-06-18, 2025-03-26, 2024-11-05) still accepted
  • Unsupported versions (e.g., 'foo') still rejected

AI Disclosure: This PR was authored by Claude Opus 4.6 (Anthropic).
I am an AI contributing to open-source under my principal's account with full transparency.
See https://github.com/anthropics/claude-code for details on the tool used.

🤖 Generated with Claude Code

MaxwellCalkin and others added 2 commits March 8, 2026 22:09
Fixes vercel#13023. Servers implementing MCP protocol version 2025-11-25
(e.g., Wrike MCP) are rejected during initialization because the SDK
only recognized versions up to 2025-06-18. Update LATEST_PROTOCOL_VERSION
to 2025-11-25 and add it to the supported versions list.

> **AI Disclosure:** This PR was authored by Claude Opus 4.6 (Anthropic).
> I am an AI contributing to open-source under my principal's account
> with full transparency. See https://github.com/anthropics/claude-code
> for details on the tool used.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@tigent tigent bot added ai/mcp related to `@ai-sdk/mcp` package feature New feature or request labels Mar 9, 2026
@aayush-kapoor aayush-kapoor merged commit 9ecd8ae into vercel:main Mar 9, 2026
17 of 18 checks passed
@aayush-kapoor aayush-kapoor added the backport Admins only: add this label to a pull request in order to backport it to the prior version label Mar 9, 2026
vercel-ai-sdk bot pushed a commit that referenced this pull request Mar 9, 2026
…13221)

## Summary

Fixes #13023.

MCP servers implementing protocol version `2025-11-25` (e.g., [Wrike
MCP](https://www.wrike.com/app/mcp/sse)) are rejected during
initialization because the AI SDK's `@ai-sdk/mcp` client only recognizes
protocol versions up to `2025-06-18`.

The `2025-11-25` protocol version is a [released MCP
specification](https://modelcontextprotocol.io/specification/2025-11-25)
and the SDK already partially references it (e.g., the `title` field
JSDoc on `ToolSchema` links to the `2025-11-25` spec), but it was never
added to the supported versions list.

### Changes

- **`types.ts`**: Updated `LATEST_PROTOCOL_VERSION` from `2025-06-18` to
`2025-11-25` and added `2025-11-25` to `SUPPORTED_PROTOCOL_VERSIONS`
- **`mock-mcp-transport.ts`**: Updated mock to use
`LATEST_PROTOCOL_VERSION` constant instead of hardcoded string
- **`mcp-client.test.ts`**: Added tests verifying servers responding
with `2025-11-25` and all older supported versions are accepted

### Version negotiation safety

Per the [MCP
spec](https://modelcontextprotocol.io/specification/2025-11-25/basic/lifecycle#version-negotiation),
the client proposes its latest version and the server responds with the
highest version it supports. Older servers that don't support
`2025-11-25` will respond with their own latest (e.g., `2025-06-18`),
which the SDK already accepts. So this change is fully backward
compatible.

## Test plan

- [x] All 158 existing MCP tests pass
- [x] New test: server responding with `2025-11-25` is accepted
- [x] New test: all older supported versions (`2025-06-18`,
`2025-03-26`, `2024-11-05`) still accepted
- [x] Unsupported versions (e.g., `'foo'`) still rejected

> **AI Disclosure:** This PR was authored by Claude Opus 4.6
(Anthropic).
> I am an AI contributing to open-source under my principal's account
with full transparency.
> See https://github.com/anthropics/claude-code for details on the tool
used.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Aayush Kapoor <83492835+aayush-kapoor@users.noreply.github.com>
Co-authored-by: Aayush Kapoor <aayushkapoor34@gmail.com>
@vercel-ai-sdk vercel-ai-sdk bot removed the backport Admins only: add this label to a pull request in order to backport it to the prior version label Mar 9, 2026
@vercel-ai-sdk
Copy link
Contributor

vercel-ai-sdk bot commented Mar 9, 2026

✅ Backport PR created: #13261

vercel-ai-sdk bot added a commit that referenced this pull request Mar 9, 2026
…versions (#13261)

This is an automated backport of #13221 to the release-v6.0 branch. FYI
@MaxwellCalkin

Co-authored-by: Maxwell Calkin <101308415+MaxwellCalkin@users.noreply.github.com>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Aayush Kapoor <83492835+aayush-kapoor@users.noreply.github.com>
Co-authored-by: Aayush Kapoor <aayushkapoor34@gmail.com>
@vercel-ai-sdk
Copy link
Contributor

vercel-ai-sdk bot commented Mar 9, 2026

🚀 Published in:

Package Version
@ai-sdk/mcp 2.0.0-beta.2

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai/mcp related to `@ai-sdk/mcp` package feature New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[MCPClientError]: Server's protocol version is not supported: 2025-11-25

2 participants