← The evidence ledger
Evidence row 578333
Observed , by probe.mcp/1.
- Kind
- mcp.tools
- About
- endpoint c7e4878b-f7e9-4cb9-be38-f0f2ee5ea4df
- Recorded
- Previous row
- None: the first of its kind about this subject
- Body SHA-256
- 6985cb5a938333a6d1bb5a0376f3ea89932bbb3af38df4d0c8bf346a3dbf108b
- Leaf
- 0xf5aaf486f7b9289e1d5bd1668f537b16b4ef77f6e333accee8288004994f49aa
What was observed
{
"count": 48,
"tools": [
{
"description": "Add a comment to a schema proposal, the same action as commenting in GraphOS Studio.\nWith no other options, the comment is a general comment on the proposal.\nTo comment on one change, pass the schema coordinate (for example Query.products) and the subgraph name as schemaScope.\nTo reply, pass the parent comment's ID.\nReturns the new comment's ID and message, or an error with a message.\nProvide the graph ID, the proposal variant name and latestRevision.id from GetProposal, and the message.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"message": {
"type": "string"
},
"parentCommentId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"proposalVariant": {
"type": "string"
},
"revisionId": {
"type": "string"
},
"schemaCoordinate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"schemaScope": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId",
"proposalVariant",
"revisionId",
"message"
],
"type": "object"
},
"name": "AddProposalComment"
},
{
"description": "Returns the Apollo Connectors specification for guidance on creating or modifying GraphQL schemas that use @connect or @source.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "ApolloConnectorsSpec"
},
{
"description": "Reads an Apollo documentation page by slug in chunks.\nUse slugs returned by ApolloDocsSearch.",
"inputSchema": {
"properties": {
"chunkIndex": {
"description": "The character index to start reading from, will return up to the next 10000 characters",
"type": "integer"
},
"slug": {
"description": "The slug returned from the ApolloDocsSearch tool",
"type": "string"
}
},
"required": [
"slug",
"chunkIndex"
],
"type": "object"
},
"name": "ApolloDocsRead"
},
{
"description": "Searches official Apollo documentation for GraphQL, GraphOS, Apollo Router, Apollo Client, MCP Server, schema design, deployment, and Connectors.\nReturns URLs, slugs, and excerpts.",
"inputSchema": {
"properties": {
"query": {
"description": "Use terms that would lead to broad result with a maximum of 2 keywords.",
"type": "string"
}
},
"required": [
"query"
],
"type": "object"
},
"name": "ApolloDocsSearch"
},
{
"description": "Create an API key for an organization.\nThe response contains the new key's value in token.\nIt 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 another tool.\nWhich key types you can create depends on how you authenticate.\nWith the GraphOS sign-in (OAuth), you can create OPERATOR, SCIM, and GATEWAY keys.\nSUBGRAPH and VARIANT keys need a personal API key in the x-api-key header.\nWith an operator key in x-api-key, you can create only GATEWAY keys, and a graph key can create none.\nNo credential can create ROUTER keys.\nOPERATOR, SCIM, and GATEWAY keys also require the Org Admin role.\nGATEWAY keys are used by Apollo Gateway instances.\nChoose the narrowest type that does the job, and confirm the type and its resources with the user before you call this tool.\nProvide the organization ID, the key name, and the type.\nFor a SUBGRAPH key, list each graphId, variantName, and subgraphName in resources.subgraphs.\nFor a VARIANT key, list each graphId and variantName in resources.variants.",
"inputSchema": {
"definitions": {
"ApiKeyResourceInput": {
"description": "The target resource(s) that a key has access to",
"properties": {
"gateways": {
"anyOf": [
{
"items": {
"$ref": "#/definitions/GatewayIdentifierInput"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "One or more gateways that a key has access to"
},
"subgraphs": {
"anyOf": [
{
"items": {
"$ref": "#/definitions/SubgraphIdentifierInput"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "One or more subgraphs that a key has access to"
},
"variants": {
"anyOf": [
{
"items": {
"$ref": "#/definitions/GraphVariantIdentifierInput"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "One or more variants that a key has access to"
}
},
"type": "object"
},
"GatewayIdentifierInput": {
"description": "Details to identify a gateway",
"properties": {
"gatewayId": {
"description": "The gateway id",
"type": "string"
},
"graphId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Optional graph id associated with this gateway key. When omitted, gatewayId is used."
}
},
"required": [
"gatewayId"
],
"type": "object"
},
"GraphOsKeyType": {
"description": "\n\nValues:\nGATEWAY: A key used by a Gateway instance\nOPERATOR: \nROUTER: \nSCIM: \nSUBGRAPH: A key with one or more subgraphs as its target resource(s)\nVARIANT: A key with one or more variants as its target resource(s)",
"enum": [
"GATEWAY",
"OPERATOR",
"ROUTER",
"SCIM",
"SUBGRAPH",
"VARIANT"
],
"type": "string"
},
"GraphVariantIdentifierInput": {
"description": "Details to identify a graph variant",
"properties": {
"graphId": {
"description": "The graph id",
"type": "string"
},
"variantName": {
"description": "The variant name",
"type": "string"
}
},
"required": [
"graphId",
"variantName"
],
"type": "object"
},
"SubgraphIdentifierInput": {
"description": "Details to identify a subgraph",
"properties": {
"graphId": {
"description": "The graph id",
"type": "string"
},
"subgraphName": {
"description": "The subgraph name",
"type": "string"
},
"variantName": {
"description": "The variant name",
"type": "string"
}
},
"required": [
"graphId",
"subgraphName",
"variantName"
],
"type": "object"
}
},
"properties": {
"name": {
"type": "string"
},
"organizationId": {
"type": "string"
},
"resources": {
"anyOf": [
{
"$ref": "#/definitions/ApiKeyResourceInput"
},
{
"type": "null"
}
]
},
"type": {
"$ref": "#/definitions/GraphOsKeyType"
}
},
"required": [
"organizationId",
"name",
"type"
],
"type": "object"
},
"name": "CreateApiKey"
},
{
"description": "Create a schema proposal against a source variant, the same action as Create proposal in GraphOS Studio.\nGraphOS creates a proposal variant that starts as a copy of the source variant's schema, and the proposal starts in DRAFT.\nReturns the proposal variant's name and the new proposal's ID and status, or an error with a message.\nTo add schema changes, call PublishProposalRevision next.\nProvide the graph ID, the title, and the source variant name.\nOptionally provide a description.",
"inputSchema": {
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"displayName": {
"type": "string"
},
"graphId": {
"type": "string"
},
"sourceVariant": {
"type": "string"
}
},
"required": [
"graphId",
"displayName",
"sourceVariant"
],
"type": "object"
},
"name": "CreateProposal"
},
{
"description": "Delete an API key from an organization, the same write that `rover api-key delete` performs.\nThis cannot be undone, and every client that uses the key stops authenticating.\nReturns the deleted key's ID.\nProvide the organization ID and the key ID, which GetApiKeys returns.",
"inputSchema": {
"properties": {
"keyId": {
"type": "string"
},
"organizationId": {
"type": "string"
}
},
"required": [
"organizationId",
"keyId"
],
"type": "object"
},
"name": "DeleteApiKey"
},
{
"description": "Delete a graph, the same write that `rover graph delete` performs.\nThis is a soft delete: the data is not removed permanently and Apollo support can restore the graph.\nEvery variant of the graph stops serving, so confirm the graph ID with the user before you call this.\nReturns null on success.\nProvide the graph ID.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
}
},
"required": [
"graphId"
],
"type": "object"
},
"name": "DeleteGraph"
},
{
"description": "Remove a subgraph from a variant and start composition, the same write that `rover subgraph delete` performs.\nReturns the composition errors that the removal causes.\nThis deletes the subgraph from the variant and can break the running router.\nSet dryRun to true first: the response then reports the composition result that the removal would produce, including updatedGateway, and deletes nothing.\nProvide the graph ID, the variant name, and the subgraph name.",
"inputSchema": {
"properties": {
"dryRun": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": false,
"description": "Do not remove the service, but recompose without it and report any errors."
},
"graphId": {
"type": "string"
},
"subgraphName": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"subgraphName"
],
"type": "object"
},
"name": "DeleteSubgraph"
},
{
"description": "List the API keys and client-credential pairs of an organization.\nFor each key: its ID, name, type, creation, expiry, last use, revocation time, and the resources it can access.\nFor each client-credential pair (an OAuth client that authenticates with the client credentials grant): its client ID, name, creation time, creator, grant types, scopes, and the resources it can access.\nKey values and client secrets are never returned.\nPass a key's ID to RenameApiKey or DeleteApiKey.\nThose tools do not work on pairs, so manage pairs in GraphOS Studio or with `rover api-key`.\nProvide the organization ID, which GetMyIdentity returns.\nOptionally filter keys by status (ACTIVE by default, or ALL, EXPIRED, REVOKED) and type (OPERATOR, SUBGRAPH, VARIANT, GATEWAY, SCIM).\nThe filters do not apply to pairs.\nThe two lists page separately: page keys with first and after, and pairs with pairsFirst and pairsAfter.",
"inputSchema": {
"definitions": {
"ApiKeyStatusFilter": {
"description": "Filter API keys by their status\n\nValues:\nACTIVE: Only return active keys that are active, not revoked, expired, or deleted\nALL: Filter for all non-deleted keys\nEXPIRED: Only return expired keys that are not deleted\nREVOKED: Only return revoked keys that are not deleted",
"enum": [
"ACTIVE",
"ALL",
"EXPIRED",
"REVOKED"
],
"type": "string"
},
"ApiKeyTypeFilter": {
"description": "Filter API keys by their type\n\nValues:\nGATEWAY: Filter for Gateway keys\nOPERATOR: Filter for Operator keys\nSCIM: Filter for SCIM keys\nSUBGRAPH: Filter for Subgraph keys\nVARIANT: Filter for Variant keys",
"enum": [
"GATEWAY",
"OPERATOR",
"SCIM",
"SUBGRAPH",
"VARIANT"
],
"type": "string"
}
},
"properties": {
"after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"first": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50
},
"organizationId": {
"type": "string"
},
"pairsAfter": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The cursor to start the page after."
},
"pairsFirst": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50,
"description": "The maximum number of clients to return."
},
"status": {
"anyOf": [
{
"$ref": "#/definitions/ApiKeyStatusFilter"
},
{
"type": "null"
}
]
},
"type": {
"anyOf": [
{
"$ref": "#/definitions/ApiKeyTypeFilter"
},
{
"type": "null"
}
]
}
},
"required": [
"organizationId"
],
"type": "object"
},
"name": "GetApiKeys"
},
{
"description": "Read the outcome of one schema check run: the overall status, and for each task in the run the composition errors, lint diagnostics, schema changes with the client operations they affect, downstream variant results, and custom check violations.\nUse this after GetSchemaChecks gives you a check ID.\nProvide the graph ID and the check ID.\nThe affected operations are paged with affectedOperationsLimit and affectedOperationsOffset; the change list is capped by the server, and areChangesTruncated reports when that happened.",
"inputSchema": {
"properties": {
"affectedOperationsLimit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 20,
"description": "The maximum number of affected queries to return. Must be 50 or fewer.#The maximum number of affected queries to return. Must be 50 or fewer.#The maximum number of affected queries to return. Must be 50 or fewer.#The maximum number of affected queries to return. Must be 50 or fewer."
},
"affectedOperationsOffset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 0,
"description": "How many items to skip before starting to return results.\nFor example, with `limit: 10` and `offset: 10`, you get items 11–20.#How many items to skip before starting to return results.\nFor example, with `limit: 10` and `offset: 10`, you get items 11–20.#How many items to skip before starting to return results.\nFor example, with `limit: 10` and `offset: 10`, you get items 11–20.#How many items to skip before starting to return results.\nFor example, with `limit: 10` and `offset: 10`, you get items 11–20."
},
"checkId": {
"type": "string"
},
"graphId": {
"type": "string"
}
},
"required": [
"graphId",
"checkId"
],
"type": "object"
},
"name": "GetCheckResults"
},
{
"description": "Traffic broken down by client for a graph over a time window, as compact CSV.\nColumns: start timestamp, end exclusive timestamp, client name, client version, operation name, request count, request latency p50 ms, request latency p99 ms, request with error count.\nAnswers which clients call a graph, which client versions are still on the wire, and which client drives errors or latency.\nClients that do not report `apollographql-client-name`/`-version` come back with empty name and version columns.\nRanked by `orderBy` descending: default REQUEST_COUNT (busiest); REQUEST_WITH_ERROR_COUNT for most error-prone, REQUEST_LATENCY_P99_MS for slowest.\n`variantName` and `operationName` scope to one or more variants or operations by exact name (omit for all).\nRows are one per client + version + operation, so a busy graph has far more groups than the other metrics tools: scope by `operationName` or raise `limit` when a breakdown looks truncated.\nKeep the default `resolution` of ENTIRE_RANGE for totals and top-N, which gives one row per group ranked over the whole window.\nDAY/HOUR/MINUTE give one row per group per bucket ranked within each bucket, so a window total then needs a per-group sum plus a `limit` big enough to cover every bucket; too small a `limit` silently undercounts.\nOnly HOUR and MINUTE accept a `to` of now, so use them for bursts in the last 24 hours.\nAvoid MONTH: it labels buckets by calendar month, not by the requested window.",
"inputSchema": {
"definitions": {
"OperationInsightsTimeseriesReportMetric": {
"description": "\n\nValues:\nREQUEST_COUNT: \nREQUEST_LATENCY_P50_MS: \nREQUEST_LATENCY_P90_MS: \nREQUEST_LATENCY_P99_MS: \nREQUEST_WITH_ERROR_COUNT: ",
"enum": [
"REQUEST_COUNT",
"REQUEST_LATENCY_P50_MS",
"REQUEST_LATENCY_P90_MS",
"REQUEST_LATENCY_P99_MS",
"REQUEST_WITH_ERROR_COUNT"
],
"type": "string"
},
"TimeseriesReportResolution": {
"description": "The size of each time bucket in a timeseries report.\n\nValues:\nDAY: One-day buckets.\nENTIRE_RANGE: Single bucket containing the entire time range.\nHOUR: One-hour buckets.\nMINUTE: One-minute buckets.\nMONTH: One-month buckets.",
"enum": [
"DAY",
"ENTIRE_RANGE",
"HOUR",
"MINUTE",
"MONTH"
],
"type": "string"
},
"Timestamp": {
"description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
}
},
"properties": {
"from": {
"$ref": "#/definitions/Timestamp",
"description": "The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601). This timestamp cannot exceed your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing)."
},
"graphId": {
"type": "string"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50,
"description": "Maximum number of records to return (default: 100, max 10000)."
},
"operationName": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
},
"orderBy": {
"anyOf": [
{
"$ref": "#/definitions/OperationInsightsTimeseriesReportMetric"
},
{
"type": "null"
}
],
"default": "REQUEST_COUNT"
},
"resolution": {
"anyOf": [
{
"$ref": "#/definitions/TimeseriesReportResolution"
},
{
"type": "null"
}
],
"default": "ENTIRE_RANGE",
"description": "The resolution of the time groups for the report. This resolution will affect the range of times that can be used for the 'from' and\n'to' timestamps:\n- For the MINUTE resolution, the total time between 'from' and 'to' must be no more than 1 day, and the 'from' time must be no earlier than 30 days ago.\n- For the HOUR resolution, the total time between 'from' and 'to' must be no more than 7 days, and the 'from' time must be no earlier than 90 days ago.\n- For the DAY, MONTH, and ENTIRE_RANGE resolutions, the 'from' time must be no earlier than 549 days ago (approx 18 months), and the 'to' time must be no later than 1 day ago.\n- These time ranges are further constrained by your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing).\nIf these criteria are not met, this will return a REQUEST_INVALID error."
},
"to": {
"$ref": "#/definitions/Timestamp",
"description": "The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601). This timestamp cannot exceed your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing)."
},
"variantName": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId",
"from",
"to"
],
"type": "object"
},
"name": "GetClientMetrics"
},
{
"description": "Read 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.\nThis is the same read that `rover contract describe` performs.\nA contract variant is a filtered view of another variant's schema, built by including and excluding schema elements by tag.\nThe filter configuration does not include whether unreachable types are hidden.\nThe description states it, so read it there before you update a contract with PublishContract.\nA variant that is not a contract returns null for the filter configuration.\nProvide the graph ID and the contract variant name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetContractConfig"
},
{
"description": "Fetch a graph artifact by its digest, the same lookup that `rover graph-artifact fetch --digest` performs.\nA graph artifact is the build output, such as the composed supergraph schema, that GraphOS Router fetches from Apollo's OCI registry.\nReturns the artifact's ID, digest, status (GRAPH_ARTIFACT_COMPLETED, GRAPH_ARTIFACT_PENDING, or GRAPH_ARTIFACT_FAILED), build errors, timestamps, variant, the launch that produced it, its registry URI, and the tags assigned to it.\nTo find a digest from a tag name, use GetGraphArtifactTags.\nProvide the graph ID and the digest.",
"inputSchema": {
"properties": {
"digest": {
"description": "The digest (SHA) of the graph artifact",
"type": "string"
},
"graphId": {
"description": "The ID of the graph the graph artifact belongs to",
"type": "string"
}
},
"required": [
"graphId",
"digest"
],
"type": "object"
},
"name": "GetGraphArtifact"
},
{
"description": "List the graph artifact tags on a graph and the artifact each tag points to: the artifact's ID, digest, status, creation time, and variant.\nGraphOS Router can fetch an artifact by tag name instead of by digest.\nIt is similar to `rover graph-artifact list-tags`, which filters by artifact digest instead of variant.\nUse it to find a tag or a digest before you call GetGraphArtifact, TagGraphArtifact, or UntagGraphArtifact.\nProvide the graph ID.\nOptionally filter by variant name, and page with first (at most 20) and after.",
"inputSchema": {
"properties": {
"after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The cursor to start pagination after (for forward pagination)"
},
"first": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 20,
"description": "The number of tags to return (for forward pagination), defaults to 10, maximum is 20"
},
"graphId": {
"description": "The ID of the graph where the tags reside",
"type": "string"
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The optional graph variant name, used to filter the results to a single variant"
}
},
"required": [
"graphId"
],
"type": "object"
},
"name": "GetGraphArtifactTags"
},
{
"description": "Read the schema (SDL) that is currently published to a graph variant, with its hash and publication time.\nThis is the same read that `rover graph fetch` performs.\nThe response holds the whole document and is not truncated.\nA large federated graph measured over 800,000 characters, roughly 200,000 tokens, which exceeds the context window of most models.\nPrefer GetSubgraphSchema, which reads one subgraph at a time, and use this tool only when you need the whole API schema.\nProvide the graph ID and the variant name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetGraphSchema"
},
{
"description": "Inspect 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 operations).\nUse to assess schema composition health and the impact of recent schema changes.\nAlso returns the latest approved launch for comparison.\nProvide the graph ID and variant name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetLatestLaunch"
},
{
"description": "Inspect a single launch by ID for full detail: status, timestamps, which subgraphs changed, composition errors, and the schema diff summary.\nUse to drill into a specific launch — e.g. a failed or superseded one found via GetLaunchHistory (pass its id here).\nProvide the graph ID, variant name, and launch ID.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"launchId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"launchId"
],
"type": "object"
},
"name": "GetLaunch"
},
{
"description": "Retrieve recent launches for a graph variant (most recent first) to detect deployment instability such as repeated failures or frequent superseded launches.\nEach entry includes the launch id, status, and timestamps, so you can identify a specific launch and drill into it with GetLaunch.\nUse to assess deployment stability.\nProvide the graph ID, variant name, and optionally a limit (default 20 most recent launches, max 100 per page) and an offset to page further back.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"limit": {
"default": 20,
"type": "integer"
},
"offset": {
"default": 0,
"type": "integer"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetLaunchHistory"
},
{
"description": "Retrieve 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.\nUse to assess schema quality and naming/best-practice violations.\nProvide the graph ID and optionally a limit (default 5 most recent schema checks).",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"limit": {
"default": 5,
"type": "integer"
}
},
"required": [
"graphId"
],
"type": "object"
},
"name": "GetLintResults"
},
{
"description": "Resolve the caller's identity from their API key or OAuth token.\nCall this FIRST when the user asks about \"my graph\" but has not provided a graph ID.\nFor a graph/service key, `me` resolves to a Graph: use `id` as the graphId and `variants[].name` as the variant for the graph-scoped health-check tools, so the user does not have to supply either.\nFor a user (personal key or OAuth), `me` resolves to a User instead: there's no single graph, so each org membership's `graphs[].id` / `graphs[].variants[].name` lists the graphId/variant options the graph-scoped tools need, across every org the user belongs to.\nAlso handles service-account keys.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "GetMyIdentity"
},
{
"description": "Fetch the offline Enterprise license for the organization that owns a graph, the same data that `rover license fetch` returns.\nThe license is a signed JWT that lets GraphOS Router enable Enterprise features while it runs disconnected from GraphOS.\nReturns null when the organization does not have offline licenses enabled, which requires a request to Apollo.\nProvide the graph ID.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
}
},
"required": [
"graphId"
],
"type": "object"
},
"name": "GetOfflineLicense"
},
{
"description": "Top operations by usage/health for a graph over a time window, as compact CSV.\nColumns: start timestamp, end exclusive timestamp, operation name, request count, request latency p50 ms, request latency p99 ms, request with error count.\nRanked by `orderBy` descending: default REQUEST_COUNT (busiest); REQUEST_WITH_ERROR_COUNT for most error-prone, REQUEST_LATENCY_P99_MS for slowest.\n`variantName` scopes to one or more variants (omit for all).\n`clients` scopes to one or more clients; omit `clientVersion` to match every version of that client, and use GetClientMetrics to discover the names a graph sees.\nKeep the default `resolution` of ENTIRE_RANGE for totals and top-N, which gives one row per operation ranked over the whole window.\nDAY/HOUR/MINUTE give one row per operation per bucket ranked within each bucket, so a window total then needs a per-operation sum plus a `limit` big enough to cover every bucket; too small a `limit` silently undercounts.\nOnly HOUR and MINUTE accept a `to` of now, so use them for bursts in the last 24 hours.\nAvoid MONTH: it labels buckets by calendar month, not by the requested window.",
"inputSchema": {
"definitions": {
"OperationInsightsTimeseriesReportClientFilterInInput": {
"description": "The named type and version of the clients to include or exclude in the operation timeseries report.",
"properties": {
"clientName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The client name."
},
"clientVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The client version."
}
},
"type": "object"
},
"OperationInsightsTimeseriesReportMetric": {
"description": "\n\nValues:\nREQUEST_COUNT: \nREQUEST_LATENCY_P50_MS: \nREQUEST_LATENCY_P90_MS: \nREQUEST_LATENCY_P99_MS: \nREQUEST_WITH_ERROR_COUNT: ",
"enum": [
"REQUEST_COUNT",
"REQUEST_LATENCY_P50_MS",
"REQUEST_LATENCY_P90_MS",
"REQUEST_LATENCY_P99_MS",
"REQUEST_WITH_ERROR_COUNT"
],
"type": "string"
},
"TimeseriesReportResolution": {
"description": "The size of each time bucket in a timeseries report.\n\nValues:\nDAY: One-day buckets.\nENTIRE_RANGE: Single bucket containing the entire time range.\nHOUR: One-hour buckets.\nMINUTE: One-minute buckets.\nMONTH: One-month buckets.",
"enum": [
"DAY",
"ENTIRE_RANGE",
"HOUR",
"MINUTE",
"MONTH"
],
"type": "string"
},
"Timestamp": {
"description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
}
},
"properties": {
"clients": {
"anyOf": [
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/OperationInsightsTimeseriesReportClientFilterInInput"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
},
"from": {
"$ref": "#/definitions/Timestamp",
"description": "The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601). This timestamp cannot exceed your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing)."
},
"graphId": {
"type": "string"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50,
"description": "Maximum number of records to return (default: 100, max 10000)."
},
"orderBy": {
"anyOf": [
{
"$ref": "#/definitions/OperationInsightsTimeseriesReportMetric"
},
{
"type": "null"
}
],
"default": "REQUEST_COUNT"
},
"resolution": {
"anyOf": [
{
"$ref": "#/definitions/TimeseriesReportResolution"
},
{
"type": "null"
}
],
"default": "ENTIRE_RANGE",
"description": "The resolution of the time groups for the report. This resolution will affect the range of times that can be used for the 'from' and\n'to' timestamps:\n- For the MINUTE resolution, the total time between 'from' and 'to' must be no more than 1 day, and the 'from' time must be no earlier than 30 days ago.\n- For the HOUR resolution, the total time between 'from' and 'to' must be no more than 7 days, and the 'from' time must be no earlier than 90 days ago.\n- For the DAY, MONTH, and ENTIRE_RANGE resolutions, the 'from' time must be no earlier than 549 days ago (approx 18 months), and the 'to' time must be no later than 1 day ago.\n- These time ranges are further constrained by your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing).\nIf these criteria are not met, this will return a REQUEST_INVALID error."
},
"to": {
"$ref": "#/definitions/Timestamp",
"description": "The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601). This timestamp cannot exceed your plan's operation-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing)."
},
"variantName": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId",
"from",
"to"
],
"type": "object"
},
"name": "GetOperationMetrics"
},
{
"description": "Check whether a graph variant has a Persisted Query List (PQL), and return its ID, its name, and its current build (revision and operation count).\nPass the ID to PublishPersistedQueries.\nUse to assess PQL configuration — a production variant with no PQL is a security gap.\nProvide the graph ID and variant name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetPersistedQueryListStatus"
},
{
"description": "Read one schema proposal by its ID: title, description, status, author, the source variant, and the proposal variant with the ID of its latest launch.\nAlso returns the latest revision (its ID, summary, schema check, and launch), every review with its decision and comment, and whether the source variant changed since the proposal was created.\nThe write tools for a proposal take the graph ID and the proposal variant name from this response.\nReviewProposal and AddProposalComment take latestRevision.id, and PublishProposalRevision takes backingVariant.latestLaunch.id as previousLaunchId.\nProvide the proposal ID, which GetProposals returns.",
"inputSchema": {
"properties": {
"proposalId": {
"type": "string"
}
},
"required": [
"proposalId"
],
"type": "object"
},
"name": "GetProposal"
},
{
"description": "List 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 its changes, plus the total count for the filter.\nA schema proposal is a reviewable set of schema changes that GraphOS stores on its own variant.\nPass a proposal's id to GetProposal for its revisions and reviews.\nProvide the graph ID.\nOptionally filter by status, source variant names, or subgraph names, and page with limit and offset.",
"inputSchema": {
"definitions": {
"ProposalStatus": {
"description": "\n\nValues:\nAPPROVED: \nCLOSED: \nDRAFT: \nIMPLEMENTED: \nOPEN: ",
"enum": [
"APPROVED",
"CLOSED",
"DRAFT",
"IMPLEMENTED",
"OPEN"
],
"type": "string"
}
},
"properties": {
"graphId": {
"type": "string"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 20
},
"offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 0
},
"sourceVariants": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"items": {
"$ref": "#/definitions/ProposalStatus"
},
"type": "array"
},
{
"type": "null"
}
]
},
"subgraphs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId"
],
"type": "object"
},
"name": "GetProposals"
},
{
"description": "Read the README of a graph variant, with the time it was last updated and who updated it.\nThis is the same read that `rover readme fetch` performs.\nThe README is the Markdown document shown on the variant's page in GraphOS Studio.\nProvide the graph ID and the variant name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetReadme"
},
{
"description": "List 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.\nUse this to find a check, then pass its ID to GetCheckResults for failure details.\nProvide the graph ID.\nOptionally filter by status (PASSED, FAILED, PENDING), subgraph names, branches, variants, authors, or check IDs, and page with limit and offset.",
"inputSchema": {
"definitions": {
"CheckFilterInputStatusOption": {
"description": "Options for filtering CheckWorkflows by status\nThis should always match CheckWorkflowStatus\n\nValues:\nFAILED: \nPENDING: \nPASSED: ",
"enum": [
"FAILED",
"PENDING",
"PASSED"
],
"type": "string"
}
},
"properties": {
"authors": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"branches": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"ids": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 20
},
"offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 0
},
"status": {
"anyOf": [
{
"$ref": "#/definitions/CheckFilterInputStatusOption"
},
{
"type": "null"
}
]
},
"subgraphs": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
},
"variants": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId"
],
"type": "object"
},
"name": "GetSchemaChecks"
},
{
"description": "Top subgraphs/connectors by traffic/health for a graph over a time window, as compact CSV.\nColumns: start timestamp, end exclusive timestamp, fetch service name, fetch count, fetch latency p50 ms, fetch latency p99 ms, fetch with errors count.\nRanked by `orderBy` descending: default FETCH_COUNT (busiest); FETCH_WITH_ERRORS_COUNT for most error-prone, FETCH_LATENCY_P99_MS for slowest.\n`variantName` scopes to one or more variants (omit for all).\n`subgraphName` scopes to one or more subgraphs by exact name (omit for all); pattern/substring matching is not supported.\n`clients` scopes to the fetches driven by one or more clients; omit `clientVersion` to match every version of that client, and use GetClientMetrics to discover the names a graph sees.\nKeep the default `resolution` of ENTIRE_RANGE for totals and top-N, which gives one row per subgraph ranked over the whole window.\nDAY/HOUR/MINUTE give one row per subgraph per bucket ranked within each bucket, so a window total then needs a per-subgraph sum plus a `limit` big enough to cover every bucket; too small a `limit` silently undercounts.\nOnly HOUR and MINUTE accept a `to` of now, so use them for bursts in the last 24 hours.\nAvoid MONTH: it labels buckets by calendar month, not by the requested window.",
"inputSchema": {
"definitions": {
"SubgraphInsightsTimeseriesReportClientFilterInInput": {
"description": "The named type and version of the clients to include or exclude in the subgraph and connector timeseries report.",
"properties": {
"clientName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The client name."
},
"clientVersion": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The client version."
}
},
"type": "object"
},
"SubgraphInsightsTimeseriesReportMetric": {
"description": "Metrics available for subgraph and connector timeseries fetches, representing aggregated data\ncollected over the given time window for the selected dimensions. Each request from the router to a downstream subgraph\nor connector service is counted as a fetch.\n\nValues:\nFETCH_COUNT: The total number of fetch requests sent from the router to the downstream subgraph or connector service as part of its query plan execution.\nFETCH_LATENCY_P50_MS: The 50th percentile (median) latency of fetches (in milliseconds).\nFETCH_LATENCY_P90_MS: The 90th percentile latency of fetch requests (in milliseconds).\nFETCH_LATENCY_P99_MS: The 99th percentile latency of fetch requests (in milliseconds).\nFETCH_WITH_ERRORS_COUNT: The number of fetch requests that resulted in error responses from the downstream service.",
"enum": [
"FETCH_COUNT",
"FETCH_LATENCY_P50_MS",
"FETCH_LATENCY_P90_MS",
"FETCH_LATENCY_P99_MS",
"FETCH_WITH_ERRORS_COUNT"
],
"type": "string"
},
"TimeseriesReportResolution": {
"description": "The size of each time bucket in a timeseries report.\n\nValues:\nDAY: One-day buckets.\nENTIRE_RANGE: Single bucket containing the entire time range.\nHOUR: One-hour buckets.\nMINUTE: One-minute buckets.\nMONTH: One-month buckets.",
"enum": [
"DAY",
"ENTIRE_RANGE",
"HOUR",
"MINUTE",
"MONTH"
],
"type": "string"
},
"Timestamp": {
"description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
}
},
"properties": {
"clients": {
"anyOf": [
{
"items": {
"anyOf": [
{
"$ref": "#/definitions/SubgraphInsightsTimeseriesReportClientFilterInInput"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
},
"from": {
"$ref": "#/definitions/Timestamp",
"description": "The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601). This timestamp cannot exceed your plan's field-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing)."
},
"graphId": {
"type": "string"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": 50,
"description": "Maximum number of records to return (default: 100, max 10000)."
},
"orderBy": {
"anyOf": [
{
"$ref": "#/definitions/SubgraphInsightsTimeseriesReportMetric"
},
{
"type": "null"
}
],
"default": "FETCH_COUNT"
},
"resolution": {
"anyOf": [
{
"$ref": "#/definitions/TimeseriesReportResolution"
},
{
"type": "null"
}
],
"default": "ENTIRE_RANGE",
"description": "The resolution of the time groups for the report. This resolution will affect the range of times that can be used for the 'from' and\n'to' timestamps:\n- For the MINUTE resolution, the total time between 'from' and 'to' must be no more than 1 day, and the 'from' time must be no earlier than 30 days ago.\n- For the HOUR resolution, the total time between 'from' and 'to' must be no more than 7 days, and the 'from' time must be no earlier than 90 days ago.\n- For the DAY, MONTH, and ENTIRE_RANGE resolutions, the 'from' time must be no earlier than 549 days ago (approx 18 months), and the 'to' time must be no later than 1 day ago.\n- These time ranges are further constrained by your plan's field-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing).\nIf these criteria are not met, this will return a REQUEST_INVALID error."
},
"subgraphName": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
},
"to": {
"$ref": "#/definitions/Timestamp",
"description": "The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601). This timestamp cannot exceed your plan's field-level data retention as defined in the Apollo GraphQL pricing page (https://www.apollographql.com/pricing)."
},
"variantName": {
"anyOf": [
{
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId",
"from",
"to"
],
"type": "object"
},
"name": "GetSubgraphMetrics"
},
{
"description": "Read one subgraph's published schema (SDL) from a variant, with its routing URL, revision, and last update time.\nThis is the same read that `rover subgraph fetch` performs.\nRead one subgraph at a time: a whole supergraph document is much larger and can pass the token limit of the model.\nProvide the graph ID, the variant name, and the subgraph name.\nUse GetVariantDetails first if you do not know the subgraph names.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"subgraphName": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"subgraphName"
],
"type": "object"
},
"name": "GetSubgraphSchema"
},
{
"description": "Read the composed supergraph schema (SDL) for a graph variant, with the composition ID and any composition errors.\nThis is the same read that `rover supergraph fetch` performs.\nA supergraph schema is the single schema that composition builds from every subgraph, and it carries federation directives that the API schema does not.\nThe response holds the whole document and is not truncated, and a supergraph schema is larger than the API schema it produces.\nExpect the same order of size: a large federated graph exceeds 800,000 characters, roughly 200,000 tokens.\nA variant that is not federated has no composition result, and the tool returns null for it rather than an empty document.\nProvide the graph ID and the variant name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetSupergraphSchema"
},
{
"description": "Identify the most-used operations on a graph variant for a time range, with request counts, types, and signatures.\nUse to find high-traffic operations, detect unused operations, and prioritize findings by traffic impact.\nProvide graph ID, variant, and a from/to time range (ISO 8601 timestamps; `to` must be at least 6 hours before now), plus an optional limit (default 50).\nThis report is rate limited.",
"inputSchema": {
"definitions": {
"Timestamp": {
"description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
}
},
"properties": {
"from": {
"$ref": "#/definitions/Timestamp",
"description": "The starting timestamp for the report.\n\n- Must be in the format: 2025-01-01T00:00:00Z (ISO 8601).\n - Must be within the last 549 days.\n - The duration between 'from' and 'to' must not exceed 31 days."
},
"graphId": {
"type": "string"
},
"limit": {
"default": 50,
"description": "Maximum number of records to return (default: 10)",
"type": "integer"
},
"to": {
"$ref": "#/definitions/Timestamp",
"description": "The ending timestamp for the report.\n\n- Must be in the format: 2025-01-01T08:00:00Z (ISO 8601).\n- Must be at least 6 hours from the current time.\n - The duration between 'from' and 'to' must not exceed 31 days."
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"from",
"to"
],
"type": "object"
},
"name": "GetTopOperations"
},
{
"description": "Retrieve metadata for a graph variant: its identifier, federation version, the URL of its GraphQL endpoint, and its subgraph inventory (names only).\nUse this to assess a variant's composition setup, such as subgraph inventory and federation version compliance.\nProvide the graph ID and variant name (e.g., \"production\").",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant"
],
"type": "object"
},
"name": "GetVariantDetails"
},
{
"description": "Lint 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.\nThis is the same check that `rover graph lint` and `rover subgraph lint` run.\nNothing is published and no state changes.\nProvide the graph ID and the schema as SDL.\nOptionally provide baseSdl to report only the diagnostics that the new schema introduces against that base.",
"inputSchema": {
"properties": {
"baseSdl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The schema to diff rule violations against, if not provided the full set of rule violations will be returned for the proposed sdl."
},
"graphId": {
"type": "string"
},
"sdl": {
"description": "The schema to lint.",
"type": "string"
}
},
"required": [
"graphId",
"sdl"
],
"type": "object"
},
"name": "LintSchema"
},
{
"description": "Create or update a contract variant and start a launch for it, the same write that `rover contract publish` performs.\nA contract variant is a filtered view of another variant's schema, built by including and excluding schema elements by tag.\nThe filter configuration replaces the previous one in full, so send the complete include and exclude lists rather than only the tags you want to change.\nThe same applies to hideUnreachableTypes, which has no default: when you update a contract, pass the value it has now.\nGetContractConfig states that value in its description.\nReturns the contract variant and a link to the launch, or the error messages that stopped it.\nProvide the graph ID, the contract variant name, the source variant, the include and exclude tag lists, and whether to hide unreachable types.",
"inputSchema": {
"properties": {
"contractVariant": {
"description": "The name of the contract variant, e.g. `public-api`. Once set, this value cannot be changed.",
"type": "string"
},
"exclude": {
"items": {
"type": "string"
},
"type": "array"
},
"graphId": {
"type": "string"
},
"hideUnreachableTypes": {
"type": "boolean"
},
"include": {
"items": {
"type": "string"
},
"type": "array"
},
"initiateLaunch": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": true,
"description": "Whether a launch and schema publish should be initiated after updating configuration. Defaults to `true`."
},
"sourceVariant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The graphRef of the variant the contract will be derived from, e.g. `my-graph@production`. Once set, this value cannot be changed."
}
},
"required": [
"graphId",
"contractVariant",
"include",
"exclude",
"hideUnreachableTypes"
],
"type": "object"
},
"name": "PublishContract"
},
{
"description": "Publish a schema to a graph variant, the same write that `rover graph publish` performs.\nUse this for a monograph; use PublishSubgraph for one subgraph of a federated graph.\nReturns a result code, whether the publish succeeded, a human-readable message, and the hash of the published schema.\nThis changes the schema registry and can change what clients see.\nRun RunSchemaCheck first to see the effect on client operations.\nProvide the graph ID, the variant name, and the schema as SDL.\nOptionally provide the git branch and commit to label the publication.",
"inputSchema": {
"properties": {
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"commit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"schemaDocument": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"schemaDocument"
],
"type": "object"
},
"name": "PublishGraphSchema"
},
{
"description": "Publish operations to a persisted query list, the same write that `rover persisted-queries publish` performs.\nA persisted query list is the set of operations a router accepts when it is configured to reject anything else.\nOperations you do not mention stay in the list unchanged: pass operations to add or replace entries, and remove to drop them.\nReturns the new revision and the total operation count, or reports that nothing changed.\nUse GetPersistedQueryListStatus to find the list ID and its current revision.\nProvide the graph ID and the persisted query list ID.",
"inputSchema": {
"definitions": {
"GraphQLDocument": {
"description": "A GraphQL document, such as a schema in SDL syntax.",
"type": "string"
},
"OperationType": {
"description": "\n\nValues:\nMUTATION: \nQUERY: \nSUBSCRIPTION: ",
"enum": [
"MUTATION",
"QUERY",
"SUBSCRIPTION"
],
"type": "string"
},
"PersistedQueryIdInput": {
"description": "Full identifier for an operation in a Persisted Query List.",
"properties": {
"clientName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "An optional client name to associate with the operation. Two operations with the same ID but different client names are treated as distinct operations. An operation with the same ID and a null client name is treated as a distinct operation as well."
},
"id": {
"description": "An opaque identifier for this operation. For a given client name, this should map uniquely to an operation body; editing the body should generally result in a new ID. Apollo's tools generally use the lowercase hex SHA256 of the operation body.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"PersistedQueryInput": {
"description": "Operations to be published to the Persisted Query List.",
"properties": {
"body": {
"$ref": "#/definitions/GraphQLDocument",
"description": "The GraphQL document for this operation, including all necessary fragment definitions."
},
"clientName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "An optional client name to associate with the operation. Two operations with the same ID but different client names are treated as distinct operations."
},
"id": {
"description": "An opaque identifier for this operation. This should map uniquely to an operation body; editing the body should generally result in a new ID. Apollo's tools generally use the lowercase hex SHA256 of the operation body.",
"type": "string"
},
"name": {
"description": "A name for the operation. Typically this is the name of the actual GraphQL operation in the body. This does not need to be unique within a Persisted Query List; as a client project evolves and its operations change, multiple operations with the same name (but different body and id) can be published.",
"type": "string"
},
"type": {
"$ref": "#/definitions/OperationType",
"description": "The operation's type."
}
},
"required": [
"body",
"id",
"name",
"type"
],
"type": "object"
}
},
"properties": {
"allowOverwrittenOperations": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"listId": {
"type": "string"
},
"operations": {
"anyOf": [
{
"items": {
"$ref": "#/definitions/PersistedQueryInput"
},
"type": "array"
},
{
"type": "null"
}
]
},
"remove": {
"anyOf": [
{
"items": {
"$ref": "#/definitions/PersistedQueryIdInput"
},
"type": "array"
},
{
"type": "null"
}
]
}
},
"required": [
"graphId",
"listId"
],
"type": "object"
},
"name": "PublishPersistedQueries"
},
{
"description": "Save 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.\nGraphOS composes the proposal variant, records the diff against the source variant, and runs schema checks on it.\nThe source variant does not change.\nSend only the subgraphs that change, each with its full SDL. previousLaunchId must be the proposal variant's latest launch ID from GetProposal.\nIf someone saved a revision since, the call fails, so read the proposal again before you retry.\nGraphOS saves the revision even when the schema does not compose, so this call succeeding does not mean the change is valid.\nCall GetProposal after the check finishes: latestRevision.checkWorkflow.status and latestRevision.launch.status show the result, and GetCheckResults takes the check ID for the details.\nReturns the proposal's new latest revision, or an error with a message.\nProvide the graph ID, the proposal variant name, previousLaunchId, a unique revision label, a summary of the change, and the subgraphs.",
"inputSchema": {
"definitions": {
"GitContextInput": {
"description": "This is stored with a schema when it is uploaded",
"properties": {
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The Git repository branch used in the check."
},
"commit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The ID of the Git commit used in the check."
},
"committer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The username of the user who created the Git commit used in the check."
},
"message": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The commit message of the Git commit used in the check."
},
"remoteUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The Git repository's remote URL."
}
},
"type": "object"
},
"PartialSchemaInput": {
"description": "Input for registering a partial schema to an implementing service.\nOne of the fields must be specified (validated server-side).\n\nIf a new partialSchemaSDL is passed in, this operation will store it before\ncreating the association.\n\nIf both the sdl and hash are specified, an error will be thrown if the provided\nhash doesn't match our hash of the sdl contents. If the sdl field is specified,\nthe hash does not need to be and will be computed server-side.",
"properties": {
"hash": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Hash of the partial schema to associate; error is thrown if only the hash is\nspecified and the hash has not been seen before"
},
"sdl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Contents of the partial schema in SDL syntax, but may reference types\nthat aren't defined in this document"
}
},
"type": "object"
},
"PublishSubgraphsSubgraphInput": {
"properties": {
"activePartialSchema": {
"$ref": "#/definitions/PartialSchemaInput"
},
"name": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"activePartialSchema",
"name"
],
"type": "object"
}
},
"properties": {
"gitContext": {
"anyOf": [
{
"$ref": "#/definitions/GitContextInput"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"previousLaunchId": {
"type": "string"
},
"proposalVariant": {
"type": "string"
},
"revision": {
"type": "string"
},
"subgraphs": {
"items": {
"$ref": "#/definitions/PublishSubgraphsSubgraphInput"
},
"type": "array"
},
"summary": {
"type": "string"
}
},
"required": [
"graphId",
"proposalVariant",
"previousLaunchId",
"revision",
"summary",
"subgraphs"
],
"type": "object"
},
"name": "PublishProposalRevision"
},
{
"description": "Replace the README of a graph variant, the same write that `rover readme publish` performs.\nThe README is the Markdown document shown on the variant's page in GraphOS Studio.\nThe new text replaces the whole README, so read the current one with GetReadme first if you intend to keep any of it.\nProvide the graph ID, the variant name, and the full README text.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"readme": {
"description": "The full new text of the README, as a Markdown-formatted string.",
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"readme"
],
"type": "object"
},
"name": "PublishReadme"
},
{
"description": "Publish a subgraph schema to a variant and start composition, the same write that `rover subgraph publish` performs.\nReturns whether the subgraph was created or updated, any composition errors, and the launch that started.\nThis changes the schema registry and can change what the router serves.\nRun RunSubgraphCheck first to see the effect on client operations.\nProvide the graph ID, the variant name, the subgraph name, and the schema as SDL.\nProvide the routing URL when you add a subgraph or move its endpoint.\nOptionally provide a revision label and the git branch and commit.",
"inputSchema": {
"properties": {
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"commit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"revision": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": ""
},
"sdl": {
"type": "string"
},
"subgraphName": {
"type": "string"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"subgraphName",
"sdl"
],
"type": "object"
},
"name": "PublishSubgraph"
},
{
"description": "Rename an API key in an organization, the same write that `rover api-key rename` performs.\nThe key value and its access do not change.\nReturns the key's ID and new name.\nProvide the organization ID, the key ID, which GetApiKeys returns, and the new name.",
"inputSchema": {
"properties": {
"keyId": {
"type": "string"
},
"name": {
"type": "string"
},
"organizationId": {
"type": "string"
}
},
"required": [
"organizationId",
"keyId",
"name"
],
"type": "object"
},
"name": "RenameApiKey"
},
{
"description": "Approve or reject a revision of a schema proposal, with an optional comment, the same action as Review in GraphOS Studio.\nOnly a requested reviewer can review, and calling this again replaces the caller's earlier review.\nReturns the proposal's status and its reviews, or an error with a message.\nProvide the graph ID, the proposal variant name and latestRevision.id from GetProposal, and the decision (APPROVED or NOT_APPROVED).",
"inputSchema": {
"definitions": {
"ReviewDecision": {
"description": "\n\nValues:\nAPPROVED: \nNOT_APPROVED: ",
"enum": [
"APPROVED",
"NOT_APPROVED"
],
"type": "string"
}
},
"properties": {
"comment": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"decision": {
"$ref": "#/definitions/ReviewDecision"
},
"graphId": {
"type": "string"
},
"proposalVariant": {
"type": "string"
},
"revisionId": {
"type": "string"
}
},
"required": [
"graphId",
"proposalVariant",
"revisionId",
"decision"
],
"type": "object"
},
"name": "ReviewProposal"
},
{
"description": "Start a schema check of a proposed schema against a variant, the same check that `rover graph check` starts.\nUse this for a monograph or for a whole supergraph schema; use RunSubgraphCheck for one subgraph.\nThe check runs in the background, so this returns a workflow ID and a Studio URL, not a result.\nPass the returned workflowID to GetCheckResults to read the outcome.\nProvide the graph ID, the variant name, and the proposed schema as SDL.\nOptionally provide the git branch and commit to label the run in Studio.",
"inputSchema": {
"properties": {
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"commit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"proposedSchema": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"proposedSchema"
],
"type": "object"
},
"name": "RunSchemaCheck"
},
{
"description": "Start a schema check of one proposed subgraph schema against a variant, the same check that `rover subgraph check` starts.\nThe check runs in the background, so this returns a workflow ID and a Studio URL, not a result.\nPass the returned workflowID to GetCheckResults to read the outcome.\nProvide the graph ID, the variant name, the subgraph name, and the proposed subgraph schema as SDL.\nOptionally provide the git branch and commit to label the run in Studio.",
"inputSchema": {
"definitions": {
"GraphQLDocument": {
"description": "A GraphQL document, such as a schema in SDL syntax.",
"type": "string"
}
},
"properties": {
"branch": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"commit": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"graphId": {
"type": "string"
},
"proposedSchema": {
"$ref": "#/definitions/GraphQLDocument"
},
"subgraphName": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"graphId",
"variant",
"subgraphName",
"proposedSchema"
],
"type": "object"
},
"name": "RunSubgraphCheck"
},
{
"description": "Assign a tag to a graph artifact, the same write that `rover graph-artifact tag` performs.\nIf the tag does not exist, it is created.\nIf it exists, it moves to this artifact, and any router that fetches by that tag receives the new artifact.\nReturns the artifact's ID and digest, or an error with a message.\nProvide the graph ID, the tag name, and the artifact digest.",
"inputSchema": {
"properties": {
"digest": {
"type": "string"
},
"graphId": {
"type": "string"
},
"tag": {
"type": "string"
}
},
"required": [
"graphId",
"tag",
"digest"
],
"type": "object"
},
"name": "TagGraphArtifact"
},
{
"description": "Delete a graph artifact tag from a graph, the same write that `rover graph-artifact untag` performs.\nThe tag and its full history are removed, and any router that fetches by that tag can no longer resolve it.\nThe artifact itself stays.\nTags that Apollo manages, such as a variant's latest tag, cannot be deleted.\nReturns the deleted tag name, or an error with a message.\nProvide the graph ID and the tag name.",
"inputSchema": {
"properties": {
"graphId": {
"type": "string"
},
"tag": {
"type": "string"
}
},
"required": [
"graphId",
"tag"
],
"type": "object"
},
"name": "UntagGraphArtifact"
},
{
"description": "Change the status of a schema proposal, the same action as the status menu in GraphOS Studio.\nDRAFT is for work in progress, OPEN asks reviewers to review, and CLOSED abandons the proposal.\nGraphOS accepts APPROVED only when the proposal has as many approvals as the graph requires, and it never accepts IMPLEMENTED from this tool.\nBoth return a ValidationError that names the rule.\nReturns the proposal's ID and new status.\nProvide the graph ID, the proposal variant name from GetProposal, and the new status.",
"inputSchema": {
"definitions": {
"ProposalStatus": {
"description": "\n\nValues:\nAPPROVED: \nCLOSED: \nDRAFT: \nIMPLEMENTED: \nOPEN: ",
"enum": [
"APPROVED",
"CLOSED",
"DRAFT",
"IMPLEMENTED",
"OPEN"
],
"type": "string"
}
},
"properties": {
"graphId": {
"type": "string"
},
"proposalVariant": {
"type": "string"
},
"status": {
"$ref": "#/definitions/ProposalStatus"
}
},
"required": [
"graphId",
"proposalVariant",
"status"
],
"type": "object"
},
"name": "UpdateProposalStatus"
},
{
"description": "Validate client GraphQL operations against a variant's published schema and return each problem's type (FAILURE, WARNING, INVALID), code, description, and the name of the operation it came from.\nThis is the same check that `rover client check` runs.\nNothing is published and no state changes.\nProvide the graph ID and the operations, each one a body and an optional name.\nOptionally name the variant to validate against; the default is \"current\".",
"inputSchema": {
"definitions": {
"OperationDocumentInput": {
"properties": {
"body": {
"description": "Operation document body",
"type": "string"
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "Operation name"
}
},
"required": [
"body"
],
"type": "object"
}
},
"properties": {
"graphId": {
"type": "string"
},
"operations": {
"items": {
"$ref": "#/definitions/OperationDocumentInput"
},
"type": "array"
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": "current"
}
},
"required": [
"graphId",
"operations"
],
"type": "object"
},
"name": "ValidateOperations"
}
]
}What the leaf hashes
{"body":"6985cb5a938333a6d1bb5a0376f3ea89932bbb3af38df4d0c8bf346a3dbf108b","id":578333,"kind":"mcp.tools","method":"probe.mcp/1","observed_us":1793142938786182,"prev":null,"subject":"c7e4878b-f7e9-4cb9-be38-f0f2ee5ea4df","subject_kind":"endpoint"}Proof
Fold these into the leaf in order, hashing each sorted pair with keccak256, to reach the root of (273461 rows).
- 0xf5aaf3ee0c39e9c44718d8b63b3608f4810672bdc2e822b3ca9323b4ed08152b
- 0xfebd83aa97cc53441a5c5a84918b5957e43e0fa601a0c73eeab9426b9e696846
- 0x461ae645cfba768e2a35212bb011a0e63a0b0615947a4de60c05e54258bde585
- 0x0f2eb53885bb84ddba75f05788c9ceea749e9442e119038fc27cbc9260f04393
- 0x16b9b2c1729e184542ba7763eb57bb58aa14c34f55480e2dbd71fbfd0832ba4f
- 0xcf3735af64e9d47d2b96167b51f420c17d5aa799310e5406c414695f8d24c986
- 0x0e4fca8fe2b1028532baebeda5554a967574dfb4af18777c272b7b0b300816e9
- 0x3861ec3e96e34d9daeb4deda27c459e58ac41f3d2d66c67618670b56f4b38315
- 0x9cc6c3b255a43d420a48404421763646ab1503f87eed86989afe31c01f9f7d4d
- 0x2f63abd8161e1650deec05401c58aef6c022c70f7608fa2721658cdc4c8319e1
- 0xb3ff7369d12615d3036b48b1396a793b1d0d84a56c22090d510b0219bcb8a827
- 0xb841380b5d51818d39ebd0d89624396bb243f73c55b9f61e4f4bcddf15ebdec2
- 0x2cba9be288dab78cb9c5f54fa13242712b2493da9f833a7c3cdd92cde60662b0
- 0x94d3785ce9330e4580bccada5459380aa2aac76a0bf11354d1353b375afc17d2
- 0xb5b652bba4a5afca56c21031d89b1c06361563aaf54ccc8541c296ceeb2b66fa
- Day root
- 0xdd77e5e99da32c3f154180d63e3c3e6fe11e896a2c6896412ef6b5c4bcf7e795
- Chained
- 0x23bb4dfd09f55c15ac3962f53578e02c6114d5bfd9bb451cf8794fb6e2817ef4
- Published
- On Arc Testnet, block 69414147: 0xb2ebd83aafeb765a0ce66e76aefb133ed06606c98038fd56191e2bcd1dcb77b4