microservices.sh — Claude Code MCP server: features and setup
This MCP server equips AI coding agents to plan and deploy Cloudflare applications using pre-built modules. It helps when assembling services that require authentication and payments.
claude mcp add --transport http mcp https://api.microservices.sh/mcpWhat microservices.sh does
The server gives coding agents a structured way to assemble Cloudflare projects from catalog components. Instead of writing boilerplate from zero, the model inspects contracts for services like authentication or audit logs, outlines the architecture, and creates project files. Tools such as validate_config and run_checks verify configuration before anything touches the cloud.
Most of the workflow happens locally. Commands like compose_app and plan_add_module only draft files and project blueprints. Remote previews run through deploy_preview, which requires a valid MICROSERVICES_API_KEY. You must execute create_preview_plan first and pass confirm: "preview" to prevent accidental deployments.
Tool calls never expose stored secret values. This keeps private keys safe while the assistant drafts code.
What it helps with
- structure Cloudflare applications using modular templates
- validate project configurations before file generation
- plan additions and upgrades for backend modules
- create preview plans and trigger gated deployments
Example prompts for the agent
- Run
list_templatesand draft a Cloudflare project with user authentication. - Execute
validate_configto catch errors in our current worker setup. - Generate a
create_preview_planbefore deploying the service.
How to install microservices.sh
1Platform CLI: remote server
claude mcp add --transport http mcp https://api.microservices.sh/mcp2Platform CLI
claude mcp add microservicessh -- npx -y @microservices-sh/mcp1Platform CLI: remote server
codex mcp add microservicessh --url https://api.microservices.sh/mcp2Platform CLI
codex mcp add microservicessh -- npx -y @microservices-sh/mcpConfig file
{
"mcpServers": {
"microservicessh": {
"url": "https://api.microservices.sh/mcp"
}
}
}{
"mcpServers": {
"microservicessh": {
"command": "npx",
"args": [
"-y",
"@microservices-sh/mcp"
]
}
}
}Config file
{
"servers": {
"microservicessh": {
"type": "http",
"url": "https://api.microservices.sh/mcp"
}
}
}{
"servers": {
"microservicessh": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@microservices-sh/mcp"
]
}
}
}1Platform CLI: remote server
gemini mcp add -t http microservicessh https://api.microservices.sh/mcp2Platform CLI
gemini mcp add microservicessh npx -y @microservices-sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about microservices.sh
How do I install microservices.sh in Claude Code?
Run claude mcp add --transport http mcp https://api.microservices.sh/mcp in your terminal. This connects your Claude Code environment to the remote HTTP endpoint.
What does microservices.sh do?
It equips AI coding assistants with tools to draft and deploy Cloudflare-based applications. The server lets agents inspect verified components, generate project structures, and run readiness audits.
What is required before triggering a preview deployment?
You must supply a MICROSERVICES_API_KEY environment variable. The mutating deploy_preview tool also requires running create_preview_plan beforehand and passing confirm: "preview".
