Home / Directory / Apollo GraphOS / GetGraphSchema

GetGraphSchema

An MCP tool from the Apollo GraphOS server, run by Apollo.

Read 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 truncated. A large federated graph measured over 800,000 characters, roughly 200,000 tokens, which exceeds the context window of most models. Prefer GetSubgraphSchema, which reads one subgraph at a time, and use this tool only when you need the whole API schema. Provide the graph ID and the variant name.

Name on the gateway: apollo_graphos__GetGraphSchema.

Parameters

NameTypeDescription
graphId requiredstring
variant requiredstring

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "apollo_graphos__GetGraphSchema",
  "arguments": {
    "graphId": "…",
    "variant": "…"
  }
}

The first call connects Apollo GraphOS to your account automatically; nothing to set up. About this server.

Try asking

Use the getgraphschema tool with graphId set to ….

More from Apollo GraphOS