Skip to content

Conversation

@groksrc
Copy link
Contributor

@groksrc groksrc commented Dec 20, 2025

Summary

  • Pin FastMCP to 2.12.3 to prevent automatic upgrades to 2.14.x
  • FastMCP 2.14.x breaks MCP tools visibility in Claude Desktop

Problem

Users reported MCP tools not appearing in Claude Desktop despite being registered correctly server-side. Investigation revealed:

  • Production had FastMCP 2.14.1 (auto-upgraded from >=2.10.2)
  • Lockfile had FastMCP 2.12.3
  • User confirmed pinning to 2.12.3 fixes the issue

User Report

Discord conversation confirming the fix: https://discord.com/channels/1368009106061000777/1381294195553341531/1451703784165343426

Changes

  • pyproject.toml: Change fastmcp>=2.10.2 to fastmcp==2.12.3
  • uv.lock: Updated to reflect pinned version

Test plan

  • Verify MCP tools visible in Claude Desktop after deployment
  • Confirm all 17 tools register correctly

Fixes #463

🤖 Generated with Claude Code

FastMCP 2.14.x breaks MCP tools visibility in Claude Desktop.
Users report tools not appearing despite being registered correctly
server-side.

Pinning to 2.12.3 which is confirmed working.

Fixes #463

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

Co-Authored-By: Claude <noreply@anthropic.com>
Signed-off-by: Drew Cain <groksrc@gmail.com>
@groksrc groksrc requested a review from phernandez December 20, 2025 01:20
@groksrc groksrc merged commit f227ef6 into main Dec 20, 2025
21 checks passed
@groksrc groksrc deleted the fix-pin-fastmcp-2.12.3 branch December 20, 2025 14:54
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.

Pin FastMCP to 2.12.3 - Version 2.14.x breaks MCP tools visibility

3 participants