GraphOS MCP Server
by @apollographql · io.github.apollographql/graphos-mcp-server
Search Apollo docs, specs, and best practices
- Category
- Cloud and DevOps
- Connection
- Remote (HTTP)
- Tools
- 48 reported
- Status
- Online
Connect it to your AI
Claude Code
claude mcp add --transport http graphos-mcp-server https://mcp.apollographql.com/Claude, ChatGPT, Cursor and other apps
Add it as a custom connector with this URL (Streamable HTTP):
https://mcp.apollographql.com/Cursor, VS Code and other apps (mcp.json)
{
"mcpServers": {
"graphos-mcp-server": {
"url": "https://mcp.apollographql.com/"
}
}
}Tools it offers
48 tools, as the server itself reported during our check on Oct 31, 2026.
GetGraphArtifactTagsList the graph artifact tags on a graph and the artifact each tag points to: the artifact's ID, digest, status, creation time, and variant. GraphOS Router can fetch an artifact by tag name instead of by digest. It is simLintSchemaLint a GraphQL schema document against the graph's lint rules and return each diagnostic's coordinate, severity level, message, rule, and source location, plus the error, warning, total, and ignored counts. This is the sDeleteApiKeyDelete an API key from an organization, the same write that `rover api-key delete` performs. This cannot be undone, and every client that uses the key stops authenticating. Returns the deleted key's ID. Provide the organGetLatestLaunchInspect the most recent launch for a graph variant: status, completion time, subgraph changes, composition errors, and a schema diff summary vs the previous launch (additions/removals/edits/deprecations plus affected opePublishPersistedQueriesPublish operations to a persisted query list, the same write that `rover persisted-queries publish` performs. A persisted query list is the set of operations a router accepts when it is configured to reject anything elseGetProposalsList the schema proposals on a graph: each proposal's ID, title, status (DRAFT, OPEN, APPROVED, IMPLEMENTED, CLOSED), timestamps, author, the source variant it proposes changes to, and the proposal variant that holds itsPublishReadmeReplace the README of a graph variant, the same write that `rover readme publish` performs. The README is the Markdown document shown on the variant's page in GraphOS Studio. The new text replaces the whole README, so reGetTopOperationsIdentify the most-used operations on a graph variant for a time range, with request counts, types, and signatures. Use to find high-traffic operations, detect unused operations, and prioritize findings by traffic impact.GetSupergraphSchemaRead the composed supergraph schema (SDL) for a graph variant, with the composition ID and any composition errors. This is the same read that `rover supergraph fetch` performs. A supergraph schema is the single schema thRunSchemaCheckStart a schema check of a proposed schema against a variant, the same check that `rover graph check` starts. Use this for a monograph or for a whole supergraph schema; use RunSubgraphCheck for one subgraph. The check runDeleteSubgraphRemove a subgraph from a variant and start composition, the same write that `rover subgraph delete` performs. Returns the composition errors that the removal causes. This deletes the subgraph from the variant and can breRunSubgraphCheckStart a schema check of one proposed subgraph schema against a variant, the same check that `rover subgraph check` starts. The check runs in the background, so this returns a workflow ID and a Studio URL, not a result. PAddProposalCommentAdd a comment to a schema proposal, the same action as commenting in GraphOS Studio. With no other options, the comment is a general comment on the proposal. To comment on one change, pass the schema coordinate (for examPublishGraphSchemaPublish a schema to a graph variant, the same write that `rover graph publish` performs. Use this for a monograph; use PublishSubgraph for one subgraph of a federated graph. Returns a result code, whether the publish sucRenameApiKeyRename an API key in an organization, the same write that `rover api-key rename` performs. The key value and its access do not change. Returns the key's ID and new name. Provide the organization ID, the key ID, which GetReviewProposalApprove or reject a revision of a schema proposal, with an optional comment, the same action as Review in GraphOS Studio. Only a requested reviewer can review, and calling this again replaces the caller's earlier review.GetGraphArtifactFetch a graph artifact by its digest, the same lookup that `rover graph-artifact fetch --digest` performs. A graph artifact is the build output, such as the composed supergraph schema, that GraphOS Router fetches from ApGetSchemaChecksList past schema checks for a graph: each check's ID, status, timestamps, the subgraph it checked, the variant it ran against, the commit, and the status of each task in the check, plus the total count for the filter. UsGetSubgraphMetricsTop subgraphs/connectors by traffic/health for a graph over a time window, as compact CSV. Columns: start timestamp, end exclusive timestamp, fetch service name, fetch count, fetch latency p50 ms, fetch latency p99 ms, fDeleteGraphDelete a graph, the same write that `rover graph delete` performs. This is a soft delete: the data is not removed permanently and Apollo support can restore the graph. Every variant of the graph stops serving, so confirmGetVariantDetailsRetrieve metadata for a graph variant: its identifier, federation version, the URL of its GraphQL endpoint, and its subgraph inventory (names only). Use this to assess a variant's composition setup, such as subgraph invePublishProposalRevisionSave a new revision of a schema proposal by publishing changed subgraph schemas to its proposal variant, the same action as Save revision in GraphOS Studio. GraphOS composes the proposal variant, records the diff againstUpdateProposalStatusChange the status of a schema proposal, the same action as the status menu in GraphOS Studio. DRAFT is for work in progress, OPEN asks reviewers to review, and CLOSED abandons the proposal. GraphOS accepts APPROVED onlyGetLintResultsRetrieve schema lint violations from a graph's most recent schema checks: each diagnostic's coordinate, severity level, message, rule, and source location, plus error/warning/total/ignored counts. Use to assess schema quGetContractConfigRead the filter configuration of a contract variant: the tags it includes, the tags it excludes, the source variant it is built from, and a human-readable description of the configuration. This is the same read that `rovGetPersistedQueryListStatusCheck whether a graph variant has a Persisted Query List (PQL), and return its ID, its name, and its current build (revision and operation count). Pass the ID to PublishPersistedQueries. Use to assess PQL configuration —GetClientMetricsTraffic broken down by client for a graph over a time window, as compact CSV. Columns: start timestamp, end exclusive timestamp, client name, client version, operation name, request count, request latency p50 ms, requestCreateApiKeyCreate an API key for an organization. The response contains the new key's value in token. It is a live credential, so give it to the user to store in a secret manager, and do not repeat it, log it, or pass it to anotherGetSubgraphSchemaRead one subgraph's published schema (SDL) from a variant, with its routing URL, revision, and last update time. This is the same read that `rover subgraph fetch` performs. Read one subgraph at a time: a whole supergraphTagGraphArtifactAssign a tag to a graph artifact, the same write that `rover graph-artifact tag` performs. If the tag does not exist, it is created. If it exists, it moves to this artifact, and any router that fetches by that tag receivApolloConnectorsSpecReturns the Apollo Connectors specification for guidance on creating or modifying GraphQL schemas that use @connect or @source.ApolloDocsSearchSearches official Apollo documentation for GraphQL, GraphOS, Apollo Router, Apollo Client, MCP Server, schema design, deployment, and Connectors. Returns URLs, slugs, and excerpts.GetProposalRead one schema proposal by its ID: title, description, status, author, the source variant, and the proposal variant with the ID of its latest launch. Also returns the latest revision (its ID, summary, schema check, andGetApiKeysList the API keys and client-credential pairs of an organization. For each key: its ID, name, type, creation, expiry, last use, revocation time, and the resources it can access. For each client-credential pair (an OAuthPublishSubgraphPublish a subgraph schema to a variant and start composition, the same write that `rover subgraph publish` performs. Returns whether the subgraph was created or updated, any composition errors, and the launch that starteGetGraphSchemaRead the schema (SDL) that is currently published to a graph variant, with its hash and publication time. This is the same read that `rover graph fetch` performs. The response holds the whole document and is not truncateGetLaunchInspect a single launch by ID for full detail: status, timestamps, which subgraphs changed, composition errors, and the schema diff summary. Use to drill into a specific launch — e.g. a failed or superseded one found viaGetReadmeRead the README of a graph variant, with the time it was last updated and who updated it. This is the same read that `rover readme fetch` performs. The README is the Markdown document shown on the variant's page in GraphGetOperationMetricsTop operations by usage/health for a graph over a time window, as compact CSV. Columns: start timestamp, end exclusive timestamp, operation name, request count, request latency p50 ms, request latency p99 ms, request witApolloDocsReadReads an Apollo documentation page by slug in chunks. Use slugs returned by ApolloDocsSearch.
Questions
What is the GraphOS MCP server?
Search Apollo docs, specs, and best practices. It is made by @apollographql and listed in the official MCP Registry as io.github.apollographql/graphos-mcp-server. MCP (Model Context Protocol) is the open standard that lets AI apps like Claude, ChatGPT and Cursor use outside tools.
How do I add GraphOS to Claude?
In the Claude app or claude.ai, open Settings, then Connectors, choose "Add custom connector" and paste https://mcp.apollographql.com/. In Claude Code, run: claude mcp add --transport http graphos-mcp-server https://mcp.apollographql.com/
How do I add GraphOS to ChatGPT?
ChatGPT can use remote MCP servers as connectors. In ChatGPT settings, under Apps and Connectors, turn on developer mode if asked, create a new connector and paste https://mcp.apollographql.com/.
How do I add GraphOS to Cursor?
Open Cursor settings, go to MCP, choose "Add new MCP server" (or edit ~/.cursor/mcp.json) and add: { "mcpServers": { "graphos-mcp-server": { "url": "https://mcp.apollographql.com/" } } }
Does GraphOS work right now?
Yes. It responded when we last checked on 31 Oct 2026. We check remote MCP servers every day.
What can GraphOS do?
It gives your AI 48 tools, including GetGraphArtifactTags, LintSchema, DeleteApiKey, GetLatestLaunch, PublishPersistedQueries. The full list is on this page.
Is this your server? Get the badge for your README
Markdown (GitHub README)
[](https://chen.media/mcp/github-apollographql-graphos-mcp-server)HTML (switches to dark mode on its own)
<a href="https://chen.media/mcp/github-apollographql-graphos-mcp-server"><picture><source media="(prefers-color-scheme: dark)" srcset="https://chen.media/mcp/badge/github-apollographql-graphos-mcp-server.svg?theme=dark"><img src="https://chen.media/mcp/badge/github-apollographql-graphos-mcp-server.svg" alt="Listed on chen.media/mcp" height="40"></picture></a>More in Cloud and DevOps
See allPostman MCP ServerVerified maker
postman.comGive your AI agents trusted access to the full Postman platform.
Atlassian Rovo MCP ServerVerified maker
atlassian.comConnect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
ZapierVerified maker
zapier.comHosted MCP server connecting AI assistants to 9,000+ apps and 40,000+ actions via Zapier.
Vercel MCPVerified maker
vercel.comAn MCP server for Vercel
WixVerified maker
wix.comA Model Context Protocol server for Wix AI tools
Microsoft MCP Server for EnterpriseVerified maker
@microsoftOfficial Microsoft MCP Server to query Microsoft Entra data using natural language