Skip to content

Conversation

@dcramer
Copy link
Member

@dcramer dcramer commented Jan 31, 2026

Summary

Changes

This is a minimal upgrade that only bumps the MCP SDK version. The agents package remains at 0.2.23 to avoid requiring the AI SDK v6 upgrade that agents 0.3.x requires.

Key SDK changes (1.21.0 → 1.25.3)

Notable changes from the changelog:

  • v1.25.0: SPEC COMPLIANCE - Remove loose/passthrough types not allowed/defined by MCP spec
  • Various bug fixes and improvements

Risk Assessment

Test plan

  • All unit tests pass (628 tests)
  • Type checking passes
  • Deploy to staging and verify MCP connections work
  • Monitor Sentry logs for any 400 errors with empty grantedSkills

Closes #756

🤖 Generated with Claude Code

This upgrades the MCP SDK from ^1.21.0 to ^1.25.3, bringing in the
latest spec compliance fixes and improvements.

Part of investigation into #756 - the diagnostic logging from PR #758
will help identify if any issues arise from this upgrade.

Note: The agents package remains at 0.2.23 to avoid requiring the
AI SDK v6 upgrade that agents 0.3.x requires.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@dcramer dcramer merged commit 486becd into main Jan 31, 2026
13 checks passed
@dcramer dcramer deleted the upgrade-mcp-sdk-1.25.3 branch January 31, 2026 02:43
dcramer added a commit that referenced this pull request Jan 31, 2026
dcramer added a commit that referenced this pull request Jan 31, 2026
## Summary
Reverts #759 to restore MCP server functionality.

## Problem
The MCP SDK upgrade caused a **protocol version mismatch**:
- Claude Code sends: `MCP-Protocol-Version: 2025-11-25`
- Our server (via `agents@0.2.23`) only supports: `2025-03-26,
2025-06-18`

The SDK upgrade alone doesn't help because protocol version support
comes from the `agents` package, not the MCP SDK.

## Root Cause
Supporting protocol `2025-11-25` requires:
- `agents@0.3.5+` (uses MCP SDK 1.25.2 with the newer protocol)
- `ai@6.x` (required by agents 0.3.x)
- This is a significant migration with breaking changes

## Next Steps
- AI SDK 6 migration tracked separately in #756
- This revert restores service for users on older Claude Code versions

Fixes #756

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Investigate: 400 error on MCP endpoint - empty grantedSkills after SDK upgrade

2 participants