io.github.apollographql/graphos-mcp-tools

Official3 tools

by apollographql · Rust

GraphOS MCP Tools

Search Apollo docs, specs, and best practices

Search Apollo documentation, GraphQL specs, and best practices.

Captured live from the server via tools/list.

ApolloConnectorsSpec

This tool provides the agent with the specification which describes how to use Apollo Connectors in a graphql schema to send an HTTP request or use any REST API with a graph. A user may refer to an Apollo Connector as 'Apollo Connector', 'REST Connector', or even just 'Connector'. Treat these all as synonyms for the same thing. You MUST ALWAYS call this tool to use this specification as a guide BEFORE planning, making, or proposing ANY edits or additions to a connectors schema file and/or a graphql file containing @connect or @source. This tool is to provide the agent with guidance, not the user.

No parameters.

ApolloDocsSearch

Searches official Apollo GraphQL documentation (Apollo GraphQL, GraphOS, Apollo Router, Apollo Client, API orchestration, MCP Server, schema design, deployment best practices, connectors, and platform usage). Returns url, slug, and markdown content excerpts. For complete page content, you MUST use the returned slug with the ApolloDocsRead tool. Use this tool when you need technical information, configuration examples, best practices, and troubleshooting guides for any Apollo GraphQL technology. Use the ApolloDocsRead tool to get all of the content for a given search result using the slug, don't use a WebSearch.

Parameters (1)

querystringrequired
Use terms that would lead to broad result with a maximum of 2 keywords.

ApolloDocsRead

Fetches the complete markdown content of an Apollo documentation page using its slug, or everything after https://apollographql.com/docs. Documentation slugs can be obtained from the SearchDocs tool results. Use this after ApolloDocsSearch to read full pages rather than just excerpts. Content will be given in chunks with the totalCount field specifying the total number of chunks. Start with a chunkIndex of 0 and fetch each chunk.

Parameters (2)

slugstringrequired
The slug returned from the ApolloDocsSearch tool
chunkIndexintegerrequired
The character index to start reading from, will return up to the next 10000 characters

README.md3 KBView on GitHub

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.

Install

claude_desktop_config.json

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

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.