Enables AI agents to plan, verify, and deploy Cloudflare-native applications using reusable microservices modules.
Also known as microservices-sh/mcp, mcp, @microservices-sh/mcp
- Stars
- 1
- Tools
- 17
- Downloads, 30 days
- —
- Latest version
- 0.1.3
- Last commit
- Sep 14, 2026
- License
- MIT
What is microservices.sh MCP?
microservices.sh enables AI agents to plan, verify, and deploy Cloudflare-native applications using reusable microservices modules. It exposes 17 tools, such as list_templates, inspect_template, list_modules.
Summary generated from the project's README
About microservices.sh MCP server
Building production-ready Cloudflare applications using pre-built modules is what this MCP server enables for AI agents. It provides a typed planning layer that allows agents to discover verified templates and inspect module contracts for features like payments, auth, and audit logs. By using this server, agents can move beyond writing code from scratch to composing structured application plans and validating configurations.
Developers set up this standalone stdio server by configuring a command like microservices-mcp and providing a MICROSERVICES_API_KEY for remote operations. The server includes read-only tools for local planning, such as list_templates, inspect_module, and compose_app, alongside remote control-plane tools. While most tools focus on discovery and readiness checks, the deploy_preview tool allows for mutating actions through the microservices.sh control plane after a preview plan is created.
What you can do with it
- 1Discovering verified application templatesAsk the agent to find available templates to start a new Cloudflare project.
- 2Composing complex application plansInstruct the agent to build a plan for an app that includes authentication and payment modules.
- 3Deploying preview environmentsRequest the agent to prepare and execute a preview deployment for a new application plan.
Written from the project's README. Every use case is checked against a quote from it.
How to install microservices.sh MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall microservices.sh MCP in Claude Code
$ claude mcp add mcp -- npx -y @microservices-sh/mcpInstall microservices.sh MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@microservices-sh/mcp"
]
}
}
}Install microservices.sh MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@microservices-sh/mcp"
]
}
}
}Install microservices.sh MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@microservices-sh/mcp"]}'Install microservices.sh MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@microservices-sh/mcp"
]
}
}
}Install microservices.sh MCP in Codex
$ codex mcp add mcp -- npx -y @microservices-sh/mcpInstall microservices.sh MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@microservices-sh/mcp"]
Install microservices.sh MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y @microservices-sh/mcpInstall microservices.sh MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@microservices-sh/mcp"
]
}
}
}microservices.sh MCP tools 17
Detected from the READMElist_templatesinspect_templatelist_modulesinspect_modulelist_module_docsget_module_doccompose_appvalidate_configgenerate_projectrun_checksplan_add_modulecheck_updates
| list_templates | — | |
| inspect_template | — | |
| list_modules | — | |
| inspect_module | — | |
| list_module_docs | — | |
| get_module_doc | — | |
| compose_app | — | |
| validate_config | — | |
| generate_project | — | |
| run_checks | — | |
| plan_add_module | — | |
| check_updates | — |
Show all 17 toolsShow fewer tools
plan_module_upgradeget_secrets_statuscreate_preview_plandeploy_previewget_deployment_status
| plan_module_upgrade | — | |
| get_secrets_status | — | |
| create_preview_plan | — | |
| deploy_preview | — | |
| get_deployment_status | — |
Configuration
MICROSERVICES_API_KEYMICROSERVICES_API_URL
| Name | Description | |
|---|---|---|
| MICROSERVICES_API_KEY | — | |
| MICROSERVICES_API_URL | — |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablemicroservices-sh/mcp is public and reachablegithub.com/microservices-sh/mcp ↗Pass
- Package names this repository as its source@microservices-sh/mcp names microservices-sh/mcp as sourcenpmjs.com/package/@microservices-sh/mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @microservices-sh/mcpnpmjs.com/package/@microservices-sh/mcp/v/0.1.3#provenance ↗Pass
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-14github.com/microservices-sh/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @microservices-sh/mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHub@microservices-sh/mcp
MCP server for AI agents that generate, verify, and deploy Cloudflare-native apps from reusable microservices.sh modules.
This package is a standalone stdio MCP server. It vendors a small microservices.sh SDK/module-contract snapshot until the public SDK is split out.
Why Agents Use It
@microservices-sh/mcp gives coding agents a typed planning layer for building production-oriented Cloudflare apps. Agents can discover verified templates and modules, inspect module contracts, compose an app plan, validate configuration, generate project files for review, run readiness checks, and prepare approval-gated preview deployments through the microservices.sh control plane.
It is useful when an agent needs to build apps with common product modules such as auth, booking, customer records, payments, files, and audit logs without inventing each integration from scratch.
Install
pnpm add -D @microservices-sh/mcp
Or run it directly after publish:
pnpm dlx @microservices-sh/mcp
Or install from Glama:
MCP Client Config
{
"mcpServers": {
"microservices": {
"command": "microservices-mcp",
"env": {
"MICROSERVICES_API_URL": "https://api.microservices.sh",
"MICROSERVICES_API_KEY": "favored-secret-manager-reference"
}
}
}
}
For local development inside this repo:
{
"mcpServers": {
"microservices-local": {
"command": "node",
"args": ["/absolute/path/to/mcp/dist/index.js"]
}
}
}
Build the local package first:
pnpm build
For agent-oriented one-click install guidance, see llms-install.md.
Tools
Read-only and local planning tools:
list_templatesinspect_templatelist_modulesinspect_modulelist_module_docsget_module_doccompose_appvalidate_configgenerate_projectrun_checksplan_add_modulecheck_updatesplan_module_upgradeget_secrets_statuscreate_preview_plan
Remote control-plane tools:
deploy_previewget_deployment_status
deploy_preview is mutating and requires confirm: "preview". Run create_preview_plan first.
Environment
| Variable | Purpose |
|---|---|
MICROSERVICES_API_URL |
Remote control-plane URL. Defaults to https://api.microservices.sh. |
MICROSERVICES_API_KEY |
Bearer token for remote tools. |
MICROSERVICES_TOKEN |
Fallback bearer token. |
Secret values are never returned by the MCP tools.
Registry Notes
The package is published to npm, listed in the official MCP Registry, and verified by Glama:
- npm:
@microservices-sh/mcp - MCP Registry:
sh.microservices/mcp - Glama:
@microservices-sh/mcp - awesome-mcp-servers: PR #8249
- Remote endpoint:
https://api.microservices.sh/mcp
The package declares "mcpName": "sh.microservices/mcp" in package.json. Docker/OCI packaging should wrap this same stdio server rather than forking behavior.
microservices.sh MCP questions
How do I add microservices.sh MCP to Claude Code?
Run claude mcp add mcp -- npx -y @microservices-sh/mcp in your terminal. Add --scope user to make it available in every project.
How do I add microservices.sh MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does microservices.sh MCP provide?
It exposes 17 tools, including list_templates, inspect_template, list_modules, inspect_module, list_module_docs.
What can AI agents do with this server?
Agents can discover verified templates, inspect module contracts, compose app plans, validate configurations, and prepare preview deployments.
Are secret values exposed through the tools?
No, the MCP tools are designed so that secret values are never returned.