GraphOS MCP Tools

GraphOS MCP Tools provide access to Apollo's documentation and graph-building capabilities through Model Context Protocol (MCP). Connect these tools to your AI assistants to access Apollo's documentation and best practices directly in your agentic development workflows.

These tools help you build and evolve graphs, prototype API integrations, and experiment with different design approaches through natural language interactions with your AI assistant.

You can access GraphOS MCP Tools at https://mcp.apollographql.com.

Available tools

Apollo Docs Search

Purpose: Search across Apollo's official documentation to find the most relevant guides, examples, and best practices for GraphQL, GraphOS, schema design, deployment best practices, connectors, and more.

Example: "How do I enable entity caching with the Apollo Router?"

Result:

Apollo Docs Read

Purpose: Retrieve the full Markdown content of any Apollo documentation page so your agent can go beyond code snippets and provide complete, detailed guidance.

Example: "Fetch the Router YAML config reference and list the top level properties."

Result:

Apollo Connectors Spec

Purpose: Access the official specification for Apollo Connectors, giving your agent the knowledge it needs to create and modify Connectors in a schema.

Examples: "Add weather details to my schema using https://api.weather.gov so I can expose weather conditions for airport cities."

Result: The output is too large to show, but your agentic coding tool will use the Apollo Connectors Spec tool to generate a graph that integrates with the https://api.weather.gov REST API.

Connect your AI agents to GraphOS MCP Tools

You need an MCP-compatible coding client or agentic runtime (for example, Claude Code, Cursor, Codex, Gemini CLI, etc).

Note: GraphOS MCP Tools require clients that support Streamable HTTP.

Using Claude Code

If you're using Claude Code, run the following command in your terminal:

claude mcp add --transport http graphos-tools https://mcp.apollographql.com

Using Cursor

If you're using Cursor, click the following button to open the installation dialog:

Click Install to complete the process.

Using VS Code

If you're using VS Code, add the following to your MCP settings configuration file:

{
  "mcpServers": {
    "graphos-tools": {
      "url": "https://mcp.apollographql.com"
    }
  }
}

Alternatively, you can run the following command in your terminal to add the server globally:

code --add-mcp "{\"name\":\"graphos-tools\",\"url\": \"https://mcp.apollographql.com\"}"

Using Codex CLI

If you're using OpenAI Codex CLI, run the following command in your terminal to add the server globally:

codex mcp add graphos-tools --url https://mcp.apollographql.com

You may also need to enable the RMCP feature in your configuration file to use streamable HTTP. Add the following to your Codex configuration:

experimental_use_rmcp_client = true

Using Gemini CLI

If you're using Google Gemini CLI, add the following to your MCP configuration file:

{
  "mcpServers": {
    "graphos-tools": {
      "httpUrl": "https://mcp.apollographql.com"
    }
  }
}

Using other MCP-compatible clients

You can connect GraphOS MCP Tools to any other MCP-compatible client that supports Streamable HTTP. Use the endpoint https://mcp.apollographql.com and follow your client's documentation for adding MCP servers.

Verify the connection

Try a question to confirm the connection is working:

What is the Apollo Router config file option to control health checks?

This triggers a response from the documentation tools similar to the following:

You're ready to use GraphOS MCP Tools in your agentic development workflows.