# Apollo MCP Server

> Apollo MCP Server is an open-source MCP server for developer tools. Turn GraphQL operations into MCP tools that AI clients can call against your API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, API
- **Website:** https://www.apollographql.com/docs/apollo-mcp-server/
- **Repository:** https://github.com/apollographql/apollo-mcp-server
- **MCP Registry name:** io.github.apollographql/apollo-mcp-server
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

The server sits in front of an existing GraphQL API and needs no change to the graph. Tools come from operation files, GraphOS operation collections, persisted query manifests or schema introspection, and it also supports MCP prompts for guided workflows. When a tool is called, it sends a structured GraphQL request to your endpoint with the configured headers and authentication, so the API's own authorisation and data policies still apply.

A setup needs a graph, definitions of the operations to expose, a configuration file and an MCP client. It talks over stdio for local use or Streamable HTTP, runs locally through Rover or as a container, and can be built from source with Rust or installed with cargo install --locked apollo-mcp-server. The documentation's example has Claude calling a GetAstronautsCurrentlyInSpace operation.

The code is MIT licensed, and Apollo maintains the quickstart and config reference in its docs.

## Features

- **Operations as tools:** Expose chosen queries and mutations as MCP tools.
- **Multiple tool sources:** Operation files, collections, persisted manifests or introspection.
- **Policy reuse:** Your API's auth and data rules keep applying.
- **Prompts support:** Offer reusable multi-step prompts.
- **Flexible deployment:** Run locally or as a container.

## Good for

- Let an assistant query a GraphQL API with fixed operations
- Expose a GraphOS operation collection to agents
- Test an MCP client against an existing graph

## Install

### Claude Code (Terminal)

```sh
claude mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.1.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v2.1.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v2.1.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "apollo-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v2.1.0"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v2.1.0"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v2.1.0"
      ]
    }
  }
}
```

## FAQ

### Do I need to change my GraphQL API?

No. It acts as a bridge and your API handles requests normally.

### Which transports are available?

stdio for local development and Streamable HTTP.

### What is the licence?

MIT.

### How is it installed?

Through cargo install --locked, a source build, Rover or a container image.

### Is Apollo MCP Server free?

Yes. Apollo MCP Server is open source, so you can use and self-host it for free.

### How do I add Apollo MCP Server to Claude Code?

Run this command in your terminal: claude mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v2.1.0

### What are the best alternatives to Apollo MCP Server?

The closest alternatives to Apollo MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/apollo-mcp-server
