🔧 MCP Config Generator

Generate, validate, and convert MCP configuration files for every MCP-compatible platform. Built by AgentPay Labs.

Your AI agent can now manage MCP server configs without touching JSON. Generate configs for Claude Desktop, Cursor, Windsurf, and more — all from natural language.

✨ Features

• 6 tools for complete MCP config management
• 7 platforms supported: Claude Desktop, Cursor, Windsurf, Cline, Continue.dev, Roo Code, Claude Code CLI
• 9+ popular server templates pre-configured
• Zero dependencies beyond Python stdlib — no API keys needed
• Offline-capable — all generation happens locally
• Rate limiting built-in — Free: 50 calls/session, Pro: unlimited ($19/mo)
• Dual response format — markdown (human) and JSON (programmatic)

🛠 Tools

| Tool | Description | |------|-------------| | mcp_generate_config | Generate MCP config JSON for any platform from server definitions | | mcp_list_platforms | List all supported platforms with config file locations | | mcp_validate_config | Validate existing MCP config for errors and warnings | | mcp_add_server | Add a server to an existing config | | mcp_get_server_template | Get pre-configured templates for 9+ popular MCP servers | | mcp_batch_generate | Generate configs for multiple servers across multiple platforms |

📦 Installation

# Clone
git clone https://github.com/Rumblingb/mcp-config-generator.git
cd mcp-config-generator

# Install
pip install -r requirements.txt

🚀 Quick Start

As an MCP Server

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-config-generator": {
      "command": "python3",
      "args": ["/path/to/mcp-config-generator/server.py"]
    }
  }
}

Example: Generate a Config

Ask your agent:

"Use mcp-config-generator to create a Claude Desktop config with the filesystem, github, and postgres servers."

The agent will call mcp_batch_generate with server_ids: ["filesystem", "github", "postgres"] and return a complete, validated JSON config.

Example: Validate a Config

"Validate my MCP config: [paste JSON]"

The agent calls mcp_validate_config and returns issues, warnings, and a verdict.

💰 Pricing

| Tier | Price | Limits | |------|-------|--------| | Free | $0 | 50 calls per session (resets on restart) | | Pro | $19/mo | Unlimited calls, priority support |

⬆️ Upgrade to Pro →

🔌 Supported Platforms

| Platform | Config File | Notes | |----------|------------|-------| | Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | macOS default | | Cursor | ~/.cursor/mcp.json | | | Windsurf | ~/.codeium/windsurf/mcp.json | | | Cline (VS Code) | VS Code settings | | | Continue.dev | ~/.continue/config.json | Nested under experimental.mcpServers | | Roo Code | VS Code settings | | | Claude Code CLI | ~/.claude/settings.json | |

Pre-configured Server Templates

| Server | Command | Description | |--------|---------|-------------| | filesystem | npx @modelcontextprotocol/server-filesystem | File system access | | github | npx @modelcontextprotocol/server-github | GitHub API | | postgres | npx @modelcontextprotocol/server-postgres | PostgreSQL database | | brave-search | npx @modelcontextprotocol/server-brave-search | Web search | | puppeteer | npx @modelcontextprotocol/server-puppeteer | Browser automation | | memory | npx @modelcontextprotocol/server-memory | Knowledge graph | | fetch | uvx mcp-server-fetch | URL fetching | | sequential-thinking | npx @modelcontextprotocol/server-sequential-thinking | Reasoning | | sqlite | uvx mcp-server-sqlite | SQLite database |

🏗 Architecture

┌──────────────────────────────────────────────────┐
│                 AI Agent                         │
│  "Generate a config for Claude Desktop with      │
│   filesystem, github, and brave-search"          │
└──────────────────┬───────────────────────────────┘
                   │ MCP stdio
                   ▼
┌──────────────────────────────────────────────────┐
│           MCP Config Generator                    │
│                                                  │
│  ┌─────────────┐  ┌──────────────┐              │
│  │ Generate    │  │ Validate     │              │
│  │ Config      │  │ Config       │              │
│  └─────────────┘  └──────────────┘              │
│  ┌─────────────┐  ┌──────────────┐              │
│  │ List        │  │ Add Server   │              │
│  │ Platforms   │  │ to Config    │              │
│  └─────────────┘  └──────────────┘              │
│  ┌─────────────┐  ┌──────────────┐              │
│  │ Server      │  │ Batch        │              │
│  │ Templates   │  │ Generate     │              │
│  └─────────────┘  └──────────────┘              │
│                                                  │
│  Pure Python stdlib — zero network calls         │
└──────────────────────────────────────────────────┘

📄 API Reference

mcp_generate_config

Generate a complete MCP config JSON from server definitions.

servers: [{name, command, args?, env?, disabled?, timeout?}]
platform: "claude-desktop" | "cursor" | "windsurf" | ...
response_format: "markdown" | "json"

mcp_validate_config

Validate an existing MCP config JSON string.

config_json: string

mcp_add_server

Add a single server to an existing config.

config_json: string
server_name: string
command: string
args?: string[]
env?: object
disabled?: boolean
platform?: string

mcp_get_server_template

Get a ready-to-use config snippet for a known server.

server_id: "filesystem" | "github" | "postgres" | ...
platform?: string
response_format?: "markdown" | "json"

mcp_batch_generate

Generate configs for multiple servers across multiple platforms.

server_ids: string[]
platforms?: string[]
response_format?: "markdown" | "json"

🧪 Quality Standards

• ✅ Service-prefixed naming: mcp_generate_config, mcp_validate_config
• ✅ Dual response format: Markdown for humans, JSON for agents
• ✅ Pagination contract: Paginated results with total, count, offset, has_more
• ✅ CHARACTER_LIMIT truncation: Auto-truncates at 25K chars
• ✅ Error as result: Errors returned inside tool response, never thrown
• ✅ Rate limiting: Free tier with Stripe upgrade path
• ✅ Tool annotations: readOnlyHint, destructiveHint, idempotentHint, openWorldHint

🔗 Related Products

• MCP Server Directory — 60+ MCP servers
• AgentPay Labs — All products

📄 License

MIT — © 2026 AgentPay Labs