# Multi MCP server

> Orchestrates multiple AI models to perform automated code reviews, security analysis, and multi-agent debates within development workflows.

- Repository: https://github.com/religa/multi_mcp
- Page: https://hostedmcp.org/servers/religa/multi-mcp
- Transport: stdio
- Stars: 37
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' --env 'OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY>' multi-mcp -- uvx multi-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "multi-mcp": {
      "command": "uvx",
      "args": [
        "multi-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "multi-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "multi-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"multi-mcp","type":"stdio","command":"uvx","args":["multi-mcp"],"env":{"ANTHROPIC_API_KEY":"<YOUR_ANTHROPIC_API_KEY>","GEMINI_API_KEY":"<YOUR_GEMINI_API_KEY>","OPENAI_API_KEY":"<YOUR_OPENAI_API_KEY>","OPENROUTER_API_KEY":"<YOUR_OPENROUTER_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "multi-mcp": {
      "command": "uvx",
      "args": [
        "multi-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add multi-mcp --env 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' --env 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' --env 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' --env 'OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY>' -- uvx multi-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.multi-mcp]
command = "uvx"
args = ["multi-mcp"]

[mcp_servers.multi-mcp.env]
ANTHROPIC_API_KEY = "<YOUR_ANTHROPIC_API_KEY>"
GEMINI_API_KEY = "<YOUR_GEMINI_API_KEY>"
OPENAI_API_KEY = "<YOUR_OPENAI_API_KEY>"
OPENROUTER_API_KEY = "<YOUR_OPENROUTER_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'ANTHROPIC_API_KEY=<YOUR_ANTHROPIC_API_KEY>' -e 'GEMINI_API_KEY=<YOUR_GEMINI_API_KEY>' -e 'OPENAI_API_KEY=<YOUR_OPENAI_API_KEY>' -e 'OPENROUTER_API_KEY=<YOUR_OPENROUTER_API_KEY>' multi-mcp uvx -- multi-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "multi-mcp": {
      "command": "uvx",
      "args": [
        "multi-mcp"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "<YOUR_ANTHROPIC_API_KEY>",
        "GEMINI_API_KEY": "<YOUR_GEMINI_API_KEY>",
        "OPENAI_API_KEY": "<YOUR_OPENAI_API_KEY>",
        "OPENROUTER_API_KEY": "<YOUR_OPENROUTER_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ANTHROPIC_API_KEY` | no | yes | Anthropic API key for Claude models (optional - at least one provider required) |
| `GEMINI_API_KEY` | no | yes | Google API key for Gemini models (optional - at least one provider required) |
| `OPENAI_API_KEY` | no | yes | OpenAI API key for GPT models (optional - at least one provider required) |
| `OPENROUTER_API_KEY` | no | yes | OpenRouter API key for additional models (optional) |
| `AWS_ACCESS_KEY_ID` | no | no |  |
| `AWS_REGION_NAME` | no | no |  |
| `AWS_SECRET_ACCESS_KEY` | no | no |  |
| `AZURE_API_BASE` | no | no |  |
| `AZURE_API_KEY` | no | no |  |
| `DEFAULT_MODEL` | no | no | Default model to use (defaults to gpt-5-mini) |
| `DEFAULT_MODEL_LIST` | no | no | Default models for multi-model comparison (comma-separated, defaults to gpt-5-mini,gemini-3-flash) |
| `LOG_LEVEL` | no | no |  |
| `MCP_TIMEOUT` | no | no |  |
| `MCP_TOOL_TIMEOUT` | no | no |  |

## FAQ

### Do I need all three AI providers?

No, you only need one API key from OpenAI, Anthropic, or Google to begin using the server.

### Does it truly run in parallel?

Yes, tools like codereview, compare, and debate execute models concurrently using asyncio, so response time equals the slowest model rather than the sum of all models.

### How many models can I run at the same time?

There is no hard limit to the number of models you can run in parallel, though 2-5 models is typically recommended for most use cases.
