Home / Directory / Apollo GraphOS / PublishGraphSchema
PublishGraphSchema
An MCP tool from the Apollo GraphOS server, run by Apollo.
Publish 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 succeeded, a human-readable message, and the hash of the published schema. This changes the schema registry and can change what clients see. Run RunSchemaCheck first to see the effect on client operations. Provide the graph ID, the variant name, and the schema as SDL. Optionally provide the git branch and commit to label the publication.
Name on the gateway: apollo_graphos__PublishGraphSchema.
Parameters
| Name | Type | Description |
|---|---|---|
graphId required | string | |
variant required | string | |
schemaDocument required | string | |
branch | mixed | |
commit | mixed |
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:
{
"name": "apollo_graphos__PublishGraphSchema",
"arguments": {
"graphId": "…",
"variant": "…",
"schemaDocument": "…"
}
}The first call connects Apollo GraphOS to your account automatically; nothing to set up. About this server.
Try asking
Use the publishgraphschema tool with graphId set to ….