{"name":"mcp serve","slug":"mcp-serve","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Programs connected through `claude mcp serve` can now see and use your subagent types through the Agent tool","description_source":"entry","described_by":{"version":"2.1.288","anchor":"per-agent-type-listing-and-subagent-definitions-in-claude-m"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":null},"aliases":[],"entries":[{"version":"2.1.304","anchor":"mcp-serve-http-enabled-plugins-via-env-org-config-gate-a","heading":"Choose which plugins load when Claude Code runs as an MCP server","line":"`CLAUDE_CODE_MCP_SERVE_ENABLED_PLUGINS` lets a program that launches `claude mcp serve` pick which plugins are turned on","released_at":"2026-10-19 19:47:15","reason":"named in this entry"},{"version":"2.1.302","anchor":"mcp-serve-gains-a-one-shot-workspace-root-env-var-that-can-r","heading":"claude mcp serve can be limited to a subfolder with a one-time variable","line":"Programs that launch `claude mcp serve` can set `CLAUDE_CODE_MCP_SERVE_WORKSPACE_ROOT` so that only folders below a given folder can be registered","released_at":"2026-10-16 16:48:28","reason":"named in this entry"},{"version":"2.1.302","anchor":"mcp-serve-gains-a-readcalls-tool-and-repo-rule-transport","heading":"claude mcp serve can report on tool calls and accept rules from the client","line":"`claude mcp serve` gains a ReadCalls tool that reports on running and finished tool calls, and clients can pass in deny and ask rules","released_at":"2026-10-16 16:48:28","reason":"named in this entry"},{"version":"2.1.299","anchor":"mcp-server-tags-calls-with-anthropicsession-metadata","heading":"claude mcp serve reads a session id sent with each tool call","line":"When Claude Code runs as an MCP server, it reads a session id from each call's `anthropic\/session` metadata and warns when it is invalid","released_at":"2026-10-14 00:23:19","reason":"named in this entry"},{"version":"2.1.295","anchor":"claude-mcp-serve-gains-an-http-transport-port-and-ses","heading":"claude mcp serve gains an HTTP mode, limited to remote cloud sessions","line":"In remote cloud sessions only, `claude mcp serve` can now listen over HTTP with `--transport`, `--port` and `--session-tunnel`","released_at":"2026-10-08 18:22:58","reason":"named in this entry"},{"version":"2.1.295","anchor":"mcp-serve-session-tunnel-and-tool-output-protocol","heading":"mcp serve gains a session tunnel mode and can return tool output","line":"`claude mcp serve` has a new `--session-tunnel` mode that connects through a relay, and can return tool output and relay permission asks","released_at":"2026-10-08 18:22:58","reason":"named in this entry"},{"version":"2.1.295","anchor":"mcp-tool-server-registers-extra-capabilities-when-serving-in","heading":"claude mcp serve declares extra capabilities in its remote mode","line":"Run in its remote mode, the MCP server started by `claude mcp serve` now declares more capabilities and accepts session details with each tool call","released_at":"2026-10-08 18:22:58","reason":"named in this entry"},{"version":"2.1.288","anchor":"per-agent-type-listing-and-subagent-definitions-in-claude-m","heading":"claude mcp serve now offers your custom subagents","line":"Programs connected through `claude mcp serve` can now see and use your subagent types through the Agent tool","released_at":"2026-10-02 18:30:40","reason":"named in this entry"},{"version":"2.1.288","anchor":"mcp-serve-honours-strict-mcp-config","heading":"claude mcp serve now takes --strict-mcp-config into account","line":"Running `claude mcp serve` now passes the `--strict-mcp-config` option along before the server starts","released_at":"2026-10-02 18:30:40","reason":"named in this entry"}],"entries_total":9,"docs":[{"source":"api","path":"about-claude\/glossary","title":"glossary","documented":false},{"source":"api","path":"about-claude\/models\/optimizing-for-cost-and-intelligence","title":"optimizing-for-cost-and-intelligence","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/best-practices","title":"PDF Processing","documented":false},{"source":"api","path":"agents-and-tools\/agent-skills\/enterprise","title":"enterprise","documented":false},{"source":"api","path":"agents-and-tools\/mcp-connector","title":"mcp-connector","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/concepts","title":"concepts","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/console","title":"console","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/deploy-compose","title":"Edit docker-compose.yaml: increment the integer in the setup service's","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/deploy-helm","title":"deploy-helm","documented":false},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/overview","title":"overview","documented":false}],"docs_total":12,"gates":[],"related":[{"name":"mcp","slug":"mcp","description":"Internal build versions get trimmed before metrics are sent, so daily builds report one value."},{"name":"mcp add","slug":"mcp-add","description":"After adding or removing a user or local MCP server, Claude Code rereads its config file and fails with an error if the change did not stick"},{"name":"mcp add-json","slug":"mcp-add-json","description":null},{"name":"mcp get","slug":"mcp-get","description":"Failed MCP connections now tell you why, with the error detail shown in list and get output."},{"name":"mcp list","slug":"mcp-list","description":"claude mcp list now tells you why a server failed, like a timeout or HTTP error, not just \"Failed to connect\"."},{"name":"mcp login","slug":"mcp-login","description":"When sign-in fails in claude mcp login, Claude Code can now offer a claude.ai link to connect the server there instead"},{"name":"mcp marketplace list","slug":"mcp-marketplace-list","description":"Marketplace listing now also shows claude.ai-hosted marketplaces you haven't added locally, plus browse-only ones."},{"name":"mcp remove","slug":"mcp-remove","description":"claude mcp remove now refuses org-managed servers with an explicit message instead of reporting them as not found."},{"name":"mcp status","slug":"mcp-status","description":null}],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/mcp-serve","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}