MCP Server

Active

MIT

Apollo MCP Server MCP Server

io.github.apollographql/apollo-mcp-server

Turns your GraphQL operations into MCP tools so AI models can query your Apollo graph.

What is the Apollo MCP Server MCP server?

Apollo MCP Server is a Model Context Protocol server that exposes GraphQL operations running on Apollo-managed graphs as MCP tools. It lets AI models discover and invoke predefined GraphQL queries and mutations as callable tools, standardizing how LLMs orchestrate access to GraphQL APIs.

Apollo MCP Server bridges GraphQL APIs and AI models via the Model Context Protocol. It sits in front of a GraphQL graph (e.g. one running with Apollo) and exposes defined GraphQL operations as MCP tools, letting LLMs and MCP clients like MCP Inspector call your API in a structured, discoverable way. Setup requires a graph, operation definitions to expose as tools, and a configuration file describing server behavior.

How to install Apollo MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v1.15.0",
        "--mount",
        "type=bind,src={config_path},dst=/config.yaml,readonly",
        "--mount",
        "type=bind,src={data_path},dst=/data",
        "-p",
        "8000:8000",
        "/config.yaml"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v1.15.0",
        "--mount",
        "type=bind,src={config_path},dst=/config.yaml,readonly",
        "--mount",
        "type=bind,src={data_path},dst=/data",
        "-p",
        "8000:8000",
        "/config.yaml"
      ]
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apollo-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v1.15.0",
        "--mount",
        "type=bind,src={config_path},dst=/config.yaml,readonly",
        "--mount",
        "type=bind,src={data_path},dst=/data",
        "-p",
        "8000:8000",
        "/config.yaml"
      ]
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "apollo-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/apollographql/apollo-mcp-server:v1.15.0",
        "--mount",
        "type=bind,src={config_path},dst=/config.yaml,readonly",
        "--mount",
        "type=bind,src={data_path},dst=/data",
        "-p",
        "8000:8000",
        "/config.yaml"
      ]
    }
  }
}

Claude Code

claude mcp add apollo-mcp-server -- docker run -i --rm ghcr.io/apollographql/apollo-mcp-server:v1.15.0 --mount type=bind,src={config_path},dst=/config.yaml,readonly --mount type=bind,src={data_path},dst=/data -p 8000:8000 /config.yaml

Use cases

Expose existing GraphQL queries and mutations to an LLM as callable tools
Let AI agents orchestrate calls against an Apollo-managed GraphQL API
Connect MCP clients (e.g. Claude, MCP Inspector) to a GraphQL backend without custom tool-building code
Run a containerized MCP gateway in front of a GraphQL graph for AI-driven API access

Apollo MCP Server MCP server FAQ

What does the Apollo MCP Server do?

It exposes GraphQL operations (queries and mutations) defined against your Apollo graph as MCP tools, so AI models can discover and call your API through the Model Context Protocol.

Is Apollo MCP Server free to use?

Yes, it is open source and licensed under the MIT License.

How do I install Apollo MCP Server?

You can run it via the published container image (ghcr.io/apollographql/apollo-mcp-server), build it from source with `cargo build` if you have Rust installed, or follow the official installation guide on the Apollo documentation site.

What do I need to configure before running it?

You need a GraphQL graph for the server to sit in front of, definitions of the GraphQL operations to expose as tools, and a configuration file describing how the server runs.

Does it require authentication?

The README does not specify authentication details beyond needing a configured graph; refer to the config file reference and user guide for connection and auth options.

How do I connect it to an MCP client like Claude or Cursor?

Once configured with your graph and operations, the server connects to any MCP client, such as an LLM integration or the MCP Inspector tool, following the setup described in the quickstart tutorial and user guide.

README (reference)

Source of truth, from the repository.

version ci workflow status release binaries workflow status release container workflow status license

Apollo MCP Server

Apollo MCP Server is a Model Context Protocol server that exposes GraphQL operations as MCP tools. It provides a standard way for AI models to access and orchestrate your APIs running with Apollo.

Documentation

See the documentation for full details. This README shows the basics of getting this MCP server running. More details are available on the documentation site.

Installation

You can either build this server from source, if you have Rust installed on your workstation, or you can follow the installation guide. To build from source, run cargo build from the root of this repository and the server will be built in the target/debug directory.

Getting started

Follow the quickstart tutorial to get started with this server.

Usage

Full usage of Apollo MCP Server is documented on the user guide. There are a few items that are necessary for this server to function. Specifically, the following things must be configured:

A graph for the MCP server to sit in front of.
Definitions for the GraphQL operations that should be exposed as MCP tools.
A configuration file describing how the MCP server should run.
A connection to an MCP client, such as an LLM or MCP inspector.

These are all described on the user guide. Specific configuration options for the configuration file are documented in the config file reference.

Contributions

Checkout the contributor guidelines for more information.

Licensing

This project is licensed under the MIT License. See the LICENSE file for the full license text.

Security

Refer to our security policy.

[!IMPORTANT]
Do not open up a GitHub issue if a found bug is a security vulnerability, and instead to refer to our security policy.

Related MCP servers

GraphOS MCP Tools

Active

Search Apollo GraphQL docs, specs, and best practices directly from your AI agent.

295

Rust

MIT

View repository →