Architect Your MCP Server
This tool exists to force good MCP thinking before bad MCP code exists. Generate a professional boilerplate based on senior architect decisions.
1. MCP Type
Determine the primary interaction model for your server.
Data-only
Exposes resources (read-only) but no tools for actions.
Action-only
Exposes tools for actions but no data resources.
Hybrid
Full flexibility with both data reading and action tools.
2. State Model
How should the server handle data persistence between requests?
Stateless
No internal memory. Simple, reliable, and horizontally scalable.
Stateful
Maintains context between calls. Ideal for multi-step workflows.
3. Intended Consumer
Who will be the primary entity interacting with your server?
Human Developer
Optimized for humans using LLM interfaces (Claude Chat, etc).
Autonomous Agent
High-precision patterns for programmatic agent use.
Hybrid Use
A balanced approach for both direct and agent interaction.
4. Side Effects
Does your server modify external systems or just read data?
None (Safe)
Strictly read-only. No risk of accidental system changes.
Controlled Effects
Allows writes/actions. Requires strict parameter validation.
5. Expected Size
How many tools or resources do you expect to build?
Small
1–3 tools. Simple flat structure for speed.
Medium
4–10 tools. Grouped folders for better organization.
Large / Enterprise
10+ tools. Full Domain-Driven Design (DDD).
6. Implementation Language
What tech stack do you prefer for your MCP server?
TypeScript
Standard Node.js SDK. Type-safe and widely used in MCP.
Python
FastAPI powered. Excellent for data & AI heavy servers.
7. Architectural Pattern
Which design pattern fits your specific implementation goal?
The Bridge
Specialized patterns for wrapping existing REST/GraphQL APIs.
The Librarian
RAG optimized. Focus on context retrieval and resource search.
The Executor
Side-effect heavy. Focused on task execution and feedback loops.
Stateless Logic
Calculations & transformations. Focused on pure domain logic.
Assembling Architecture
Consulting best practices and patterns...
Blueprint Ready
Your professional MCP architecture has been assembled.
Folder Structure