# microservices.sh

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: microservices-sh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/microservices-sh/mcp
- Updated: 2026-09-14
- HTML: https://affpapa.org/en/nevibecode/mcp/microservicessh

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.microservices.sh/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.microservices.sh/mcp
```

2. **Platform CLI**
```bash
claude mcp add microservicessh -- npx -y @microservices-sh/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add microservicessh --url https://api.microservices.sh/mcp
```

2. **Platform CLI**
```bash
codex mcp add microservicessh -- npx -y @microservices-sh/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "microservicessh": {
            "url": "https://api.microservices.sh/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "microservicessh": {
            "command": "npx",
            "args": [
                "-y",
                "@microservices-sh/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "microservicessh": {
            "type": "http",
            "url": "https://api.microservices.sh/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "microservicessh": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@microservices-sh/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http microservicessh https://api.microservices.sh/mcp
```

2. **Platform CLI**
```bash
gemini mcp add microservicessh npx -y @microservices-sh/mcp
```

## When to use it
- 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
- Run `list_templates` and draft a Cloudflare project with user authentication.
- Execute `validate_config` to catch errors in our current worker setup.
- Generate a `create_preview_plan` before deploying the service.

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [firebase-mcp](https://affpapa.org/en/nevibecode/mcp/firebase-mcp.md) — MCP server · ★ 4482
- [Radar Kubernetes MCP Server](https://affpapa.org/en/nevibecode/mcp/radar-kubernetes-mcp-server.md) — MCP server · ★ 3918
- [Supabase](https://affpapa.org/en/nevibecode/mcp/supabase.md) — MCP server · ★ 2974
- [Microsoft Fabric MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-fabric-mcp-server.md) — MCP server · ★ 3804

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md