MCP Server

Active

MIT

GraphOS MCP Tools MCP Server

io.github.apollographql/graphos-mcp-tools

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

What is the GraphOS MCP Tools MCP server?

GraphOS MCP Tools is a hosted MCP server from Apollo GraphQL that lets AI agents search Apollo's documentation, GraphQL specifications, and API best practices. It's built on the Apollo MCP Server project, which exposes GraphQL operations as MCP tools, and this particular hosted instance focuses on Apollo docs/spec search rather than a custom graph.

GraphOS MCP Tools is a remote, streamable-HTTP MCP server hosted by Apollo at mcp.apollographql.com. It's based on the Apollo MCP Server, an open-source Rust implementation of the Model Context Protocol that exposes GraphQL operations as MCP tools so AI models can access and orchestrate APIs. This hosted instance is aimed at letting AI coding assistants search Apollo documentation, GraphQL specifications, and best practices without any local setup.

How to install GraphOS MCP Tools

Copy-paste configuration for popular MCP clients.

transport: http

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

Cursor

~/.cursor/mcp.json

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

Windsurf

~/.codeium/windsurf/mcp_config.json

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

VS Code

.vscode/mcp.json

{
  "servers": {
    "graphos-mcp-tools": {
      "type": "http",
      "url": "https://mcp.apollographql.com"
    }
  }
}

Claude Desktop

Claude Desktop connects to remote servers via the mcp-remote bridge.

{
  "mcpServers": {
    "graphos-mcp-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apollographql.com"
      ]
    }
  }
}

Claude Code

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

Use cases

Look up Apollo GraphQL documentation while coding in an AI assistant
Search GraphQL specifications for reference during development
Get GraphOS best-practice recommendations directly in an editor/chat context
Reduce context-switching when building or debugging GraphQL APIs with Apollo

GraphOS MCP Tools MCP server FAQ

What does the GraphOS MCP Tools server do?

It provides AI agents with the ability to search Apollo GraphQL documentation, GraphQL specs, and best practices, per Apollo's hosted MCP endpoint description.

Is GraphOS MCP Tools free to use?

The README does not state pricing; it is offered as a remote endpoint at https://mcp.apollographql.com without documented cost details.

How do I connect to GraphOS MCP Tools in Cursor or Claude?

Add it as a remote MCP server using the streamable-http transport pointed at https://mcp.apollographql.com in your client's MCP configuration.

Does this require authentication?

The README does not specify authentication requirements for the remote endpoint.

Is this the same as the Apollo MCP Server project on GitHub?

It's built on the Apollo MCP Server open-source project (apollographql/apollo-mcp-server), which exposes GraphQL operations as MCP tools, but this hosted instance is specifically configured for searching Apollo docs and specs.

Can I self-host this instead of using the remote endpoint?

Yes, the underlying Apollo MCP Server can be built from source with Rust (cargo build) or installed following Apollo's official installation guide, then configured with your own graph and operations.

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

Apollo MCP Server

Active

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

295

Rust

MIT

View repository →