subagent

mcp-server-architect — Claude Code subagent: build MCP servers

Q: How do I install mcp-server-architect in Claude Code?

Run `npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect`, then confirm the file `.claude/agents/mcp-server-architect.md` is in place.

Q: Which tools can the subagent use?

`Read`, `Write`, `Edit` and `Bash`. That is enough to create server files and run a build or tests while it works.

A subagent that designs and writes MCP servers: tools, transports, sessions, security. Useful when you need a working server, not a sketch.

Install into Claude Code · claude-code-templates All methods and platforms ↓

npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect

Open on GitHub

What mcp-server-architect does

The subagent walks an MCP server from design to deployment. It studies the domain first, then proposes tool interfaces with JSON Schema validation, annotations (read-only, destructive, idempotent, open-world) and value hints through completion/complete. Transport work follows: JSON-RPC 2.0 over stdio and Streamable HTTP, with an SSE fallback for older clients.

Its standards are spelled out. Code comes in TypeScript with @modelcontextprotocol/sdk (1.10.0 or newer) or in Python with type hints. Sessions get non-deterministic IDs tied to a user identity, and every Streamable HTTP request has its Origin header checked. Caching, connection pooling and multi-region deployment are part of the brief. Logs go to stderr — send them to stdout and the protocol breaks.

The subagent holds Read, Write, Edit and Bash, so it edits files and runs commands on its own. It targets the 2025-06-18 MCP specification; on an older protocol version you will have to discard some of its advice by hand. Without a grasp of JSON-RPC and the session lifecycle, the output is hard to debug.

What it helps with

lay out a server's tool set with input validation
run stdio and Streamable HTTP transports side by side
wire up argument suggestions via completion/complete
harden sessions and Origin checks without leaking IDs
keep protocol output and logs on separate streams

Example prompts for the agent

Design an MCP server for our internal knowledge base: tools, resources, prompts
Add completion/complete support for the arguments of the search tool
Check that the server returns proper errors and keeps logs out of stdout

How to install mcp-server-architect

1claude-code-templates

npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect

2Manually: put the files in place

.claude/agents/mcp-server-architect.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Manually: put the files in place

.codex/agents/mcp-server-architect.toml

Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

Manually: put the files in place

.cursor/agents/mcp-server-architect.md

Cursor also reads .claude/agents/

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about mcp-server-architect

How do I install mcp-server-architect in Claude Code?

Run npx claude-code-templates@latest --agent mcp-dev-team/mcp-server-architect, then confirm the file .claude/agents/mcp-server-architect.md is in place.

What does mcp-server-architect do?

It is an MCP server architect subagent. It designs tools and resources, writes transports, sets up sessions and keeps the implementation aligned with the specification.

Which tools can the subagent use?

Read, Write, Edit and Bash. That is enough to create server files and run a build or tests while it works.

Similar subagents

All subagents for Agent setup: memory, context, orchestration →

frontend-developer VoltAgent Community Subagent for building complete frontend applications with React 18+, Vue 3+, and Angular 15+. Handles component architecture, state management, testing, and accessibility. 40,905installs dx-optimizer VoltAgent Community Subagent profiles and accelerates your entire development cycle: build times, feedback loops, testing. Use it when the project is slow or developers waste time waiting. 1,198installs mlops-engineer VoltAgent Community This subagent designs ML infrastructure, model CI/CD, and versioning workflows. Use it when training automation, GPU orchestration, or ML monitoring needs attention. 1,009installs postgres-pro VoltAgent Community A PostgreSQL subagent for query tuning, replication design, backups, and database troubleshooting. Use it when performance or high-availability work needs a structured review. 897installs agent-installer VoltAgent Community Subagent for discovering, browsing, and installing Claude Code agents from the awesome-claude-code-subagents repository. Simplifies finding and integrating new tools into your workflow. 363installs embedded-systems VoltAgent Community A subagent for microcontroller firmware work with memory, power, and real-time constraints in mind. Use it for RTOS tasks, drivers, and peripheral integration. 279installs

From the same set361

The whole set →

finish Automates Git Flow branch completion by validating tests, merging into target branches, and handling release tagging. 1,712installs monitoring-specialist This subagent helps plan metrics, logs, tracing, alerts, and SLA monitoring. Use it while building observability for an infrastructure project. 1,677installs research-coordinator This subagent turns a broad research brief into specialist assignments and a coordination plan. Use it when a question spans several research disciplines. 1,673installs release Automates Git Flow release branches from develop. It validates semver, bumps package.json, compiles a grouped changelog, and pushes to remote. 1,664installs hotfix Creates a Git Flow hotfix branch from main for urgent production fixes. It checks the branch name, repository state, and whether the issue is critical. 1,611installs game-designer Structures gameplay mechanics, calculates economy balance, and shapes progression curves. It drafts design specifications and balance sheets directly in your workspace. 1,598installs project-supervisor-orchestrator A subagent that runs a chain of other agents step by step and returns the result as JSON. Useful when one request has to pass through several specialized agents. 1,563installs competitive-intelligence-analyst A Claude subagent that gathers competitor and market data: company profiles, SWOT, industry trends. Useful before a product launch or when shaping strategy. 1,561installs