claude-code icon indicating copy to clipboard operation
claude-code copied to clipboard

[BUG] HTTP MCP Servers Not Available in Conversation Interface (mcp__server__tool format fails)

Open yapxue opened this issue 4 months ago • 1 comments

Preflight Checklist

  • [x] I have searched existing issues and this hasn't been reported yet
  • [x] This is a single bug report (please file separate reports for different bugs)
  • [x] I am using the latest version of Claude Code

What's Wrong?

HTTP MCP servers connect successfully via CLI (claude mcp list shows "✓ Connected") but tools are not available in conversation interface using the mcp__server__tool format. STDIO MCP servers work correctly.

Environment:

  • Claude Code Version: 2.0.76 (from server logs)
  • OS: macOS Darwin 23.2.0
  • MCP Protocol Version: 2025-11-25

Steps to Reproduce:

  1. Create HTTP MCP server implementing MCP 2025-11-25 protocol
  2. Add server: claude mcp add --transport http api5io http://localhost:8090/mcp
  3. Verify connection: claude mcp list shows "✓ Connected"
  4. Try to use tool in conversation: mcp__api5io__toolname
  5. Result: "No such tool available" error

Expected Behavior: HTTP MCP tools should be available in conversation interface just like STDIO MCP tools.

Actual Behavior:

  • ✅ CLI shows MCP server as "✓ Connected"
  • ✅ MCP protocol communication works (initialize, tools/list, resources/list)
  • ✅ /mcp UI shows server but no "View Tools" option
  • ❌ Tools not available with mcp__server__tool format in conversation
  • ❌ Tools not accessible for direct use in conversations

Technical Details:

Working MCP Protocol Responses: // tools/list response (works correctly) { "jsonrpc": "2.0", "id": 1, "result": { "tools": [ { "name": "api5io_status", "description": "Get the status of API5IO services", "inputSchema": { "type": "object", "properties": { "service": { "type": "string", "description": "The service name to check" } } } } // ... other tools ] } }

Server Logs Show Successful Communication: INFO: MCP request received: {"method": "initialize", "params": {"protocolVersion": "2025-11-25", "capabilities": {"roots": {}}, "clientInfo": {"name": "claude-code", "version": "2.0.76"}}} INFO: MCP request received: {"method": "tools/list", "jsonrpc": "2.0", "id": 1} INFO: MCP request received: {"method": "resources/list", "jsonrpc": "2.0", "id": 2}

Comparison with Working STDIO Servers:

  • STDIO servers (git-server, jira-server, etc.) work perfectly in conversation interface
  • HTTP servers connect but don't integrate with conversation tools

Impact: HTTP MCP servers cannot be used for conversational AI assistance, limiting their practical utility compared to STDIO servers.

What Should Happen?

there should be View Tools option for /mcp, but not. Claude codo also donot know the tool to use.

Error Messages/Logs


Steps to Reproduce

a python based remote server

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.0.76

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

No response

yapxue avatar Dec 25 '25 10:12 yapxue

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/2682
  2. https://github.com/anthropics/claude-code/issues/12164
  3. https://github.com/anthropics/claude-code/issues/14807

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

github-actions[bot] avatar Dec 25 '25 10:12 github-actions[bot]

This issue has been automatically closed as a duplicate of #2682.

If this is incorrect, please re-open this issue or create a new one.

🤖 Generated with Claude Code

github-actions[bot] avatar Dec 29 '25 09:12 github-actions[bot]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.

github-actions[bot] avatar Jan 05 '26 14:01 github-actions[bot]