GetTopOperations

Identify 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. Provide 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). This report is rate limited.

Parameters5

graphId	string	required
variant	string	required
from	any	required	The starting timestamp for the report. - Must be in the format: 2025-01-01T00:00:00Z (ISO 8601). - Must be within the last 549 days. - The duration between 'from' and 'to' must not exceed 31 days.
to	any	required	The ending timestamp for the report. - Must be in the format: 2025-01-01T08:00:00Z (ISO 8601). - Must be at least 6 hours from the current time. - The duration between 'from' and 'to' must not exceed 31 days.
limit	integer	required	Maximum number of records to return (default: 10)

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    },
    "from": {
      "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.",
      "$ref": "#/definitions/Timestamp"
    },
    "to": {
      "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.",
      "$ref": "#/definitions/Timestamp"
    },
    "limit": {
      "description": "Maximum number of records to return (default: 10)",
      "type": "integer"
    }
  },
  "required": [
    "graphId",
    "variant",
    "from",
    "to",
    "limit"
  ],
  "definitions": {
    "Timestamp": {
      "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
    }
  }
}

GetPersistedQueryListStatus

Check whether a graph variant has a Persisted Query List (PQL) and its current build (revision and operation count). Use to assess PQL configuration — a production variant with no PQL is a security gap. Provide the graph ID and variant name.

Parameters2

graphId	string	required
variant	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    }
  },
  "required": [
    "graphId",
    "variant"
  ]
}

GetLaunchHistory

Retrieve recent launches for a graph variant (most recent first) to detect deployment instability such as repeated failures or frequent superseded launches. Each entry includes the launch id, status, and timestamps, so you can identify a specific launch and drill into it with GetLaunch. Use to assess deployment stability. Provide the graph ID, variant name, and optionally a limit (default 20 most recent launches).

Parameters3

graphId	string	required
variant	string	required
limit	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "graphId",
    "variant",
    "limit"
  ]
}

ApolloConnectorsSpec

Returns the Apollo Connectors specification for guidance on creating or modifying GraphQL schemas that use @connect or @source.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

GetLaunch

Inspect 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 via GetLaunchHistory (pass its id here). Provide the graph ID, variant name, and launch ID.

Parameters3

graphId	string	required
variant	string	required
launchId	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    },
    "launchId": {
      "type": "string"
    }
  },
  "required": [
    "graphId",
    "variant",
    "launchId"
  ]
}

GetSubgraphMetrics

Top subgraphs/connectors by traffic/health for a graph over a time window, as compact CSV (header row + one row per subgraph per day). Columns: start timestamp, end exclusive timestamp, fetch service name, fetch count, fetch latency p50 ms, fetch latency p99 ms, fetch with errors count. Ranked by `orderBy` descending: default FETCH_COUNT (busiest); use FETCH_WITH_ERRORS_COUNT for most error-prone, FETCH_LATENCY_P99_MS for slowest. Rows are per-DAY buckets, so for a multi-day window sum a column per subgraph to get the window total. `variantName` optionally scopes to one or more variants (omit for all). Note: `to` must be at least 1 day in the past (DAY resolution).

Parameters6

graphId	string	required
from	any	required	The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601).
to	any	required	The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601).
orderBy	any	optional
variantName	array	optional
limit	integer	optional	Maximum number of records to return (default: 100, max 10000).

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "from": {
      "description": "The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601).",
      "$ref": "#/definitions/Timestamp"
    },
    "to": {
      "description": "The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601).",
      "$ref": "#/definitions/Timestamp"
    },
    "orderBy": {
      "$ref": "#/definitions/SubgraphInsightsTimeseriesReportMetric"
    },
    "variantName": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      }
    },
    "limit": {
      "description": "Maximum number of records to return (default: 100, max 10000).",
      "type": "integer"
    }
  },
  "required": [
    "graphId",
    "from",
    "to"
  ],
  "definitions": {
    "Timestamp": {
      "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
    },
    "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.",
      "type": "string",
      "enum": [
        "FETCH_COUNT",
        "FETCH_LATENCY_P50_MS",
        "FETCH_LATENCY_P90_MS",
        "FETCH_LATENCY_P99_MS",
        "FETCH_WITH_ERRORS_COUNT"
      ]
    }
  }
}

GetMyIdentity

Resolve the caller's identity from their API key. Call this FIRST when the user asks about "my graph" but has not provided a graph ID. For 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. Also handles user keys (memberships) and service-account keys.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

ApolloDocsRead

Reads an Apollo documentation page by slug in chunks. Use slugs returned by ApolloDocsSearch.

Parameters2

slug	string	required	The slug returned from the ApolloDocsSearch tool
chunkIndex	integer	required	The character index to start reading from, will return up to the next 10000 characters

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "The slug returned from the ApolloDocsSearch tool",
      "type": "string"
    },
    "chunkIndex": {
      "description": "The character index to start reading from, will return up to the next 10000 characters",
      "type": "integer"
    }
  },
  "required": [
    "slug",
    "chunkIndex"
  ]
}

GetOperationMetrics

Top operations by usage/health for a graph over a time window, as compact CSV (header row + one row per operation per day). Columns: start timestamp, end exclusive timestamp, operation name, request count, request latency p50 ms, request latency p99 ms, request with error count. Ranked by `orderBy` descending: default REQUEST_COUNT (busiest); use REQUEST_WITH_ERROR_COUNT for most error-prone, REQUEST_LATENCY_P99_MS for slowest. Rows are per-DAY buckets, so for a multi-day window sum a column per operation to get the window total. `variantName` optionally scopes to one or more variants (omit for all). Note: `to` must be at least 1 day in the past (DAY resolution).

Parameters6

graphId	string	required
from	any	required	The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601).
to	any	required	The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601).
orderBy	any	optional
variantName	array	optional
limit	integer	optional	Maximum number of records to return (default: 100, max 10000).

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "from": {
      "description": "The starting timestamp for the report. Must be in the format: 2025-01-01T00:00:00Z (ISO 8601).",
      "$ref": "#/definitions/Timestamp"
    },
    "to": {
      "description": "The ending timestamp for the report. Must be in the format: 2025-01-01T08:00:00Z (ISO 8601).",
      "$ref": "#/definitions/Timestamp"
    },
    "orderBy": {
      "$ref": "#/definitions/OperationInsightsTimeseriesReportMetric"
    },
    "variantName": {
      "type": "array",
      "items": {
        "oneOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ]
      }
    },
    "limit": {
      "description": "Maximum number of records to return (default: 100, max 10000).",
      "type": "integer"
    }
  },
  "required": [
    "graphId",
    "from",
    "to"
  ],
  "definitions": {
    "Timestamp": {
      "description": "ISO 8601, extended format with nanoseconds, Zulu (or \"[+-]seconds\" as a string or number relative to now)"
    },
    "OperationInsightsTimeseriesReportMetric": {
      "description": "\n\nValues:\nREQUEST_COUNT: \nREQUEST_LATENCY_P50_MS: \nREQUEST_LATENCY_P90_MS: \nREQUEST_LATENCY_P99_MS: \nREQUEST_WITH_ERROR_COUNT: ",
      "type": "string",
      "enum": [
        "REQUEST_COUNT",
        "REQUEST_LATENCY_P50_MS",
        "REQUEST_LATENCY_P90_MS",
        "REQUEST_LATENCY_P99_MS",
        "REQUEST_WITH_ERROR_COUNT"
      ]
    }
  }
}

GetLatestLaunch

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). Use to assess schema composition health and the impact of recent schema changes. Also returns the latest approved launch for comparison. Provide the graph ID and variant name.

Parameters2

graphId	string	required
variant	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    }
  },
  "required": [
    "graphId",
    "variant"
  ]
}

GetVariantDetails

Retrieve detailed metadata for a graph variant: federation version, subgraph inventory (names), router status and any pending router version, and the current router configuration (raw YAML). Use this to assess a variant's health — router config gaps, subgraph inventory, and federation version compliance. Provide the graph ID and variant name (e.g., "production").

Parameters2

graphId	string	required
variant	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    }
  },
  "required": [
    "graphId",
    "variant"
  ]
}

ApolloDocsSearch

Searches official Apollo documentation for GraphQL, GraphOS, Apollo Router, Apollo Client, MCP Server, schema design, deployment, and Connectors. Returns URLs, slugs, and excerpts.

Parameters1

query

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Use terms that would lead to broad result with a maximum of 2 keywords.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ]
}

GetLintResults

Retrieve schema lint violations from a graph's most recent check workflows: each diagnostic's coordinate, severity level, message, rule, and source location, plus error/warning/total/ignored counts. Use to assess schema quality and naming/best-practice violations. Provide the graph ID and optionally a limit (default 5 most recent check workflows).

Parameters2

graphId	string	required
limit	integer	required

Raw schema

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    }
  },
  "required": [
    "graphId",
    "limit"
  ]
}

GraphOS MCP Server

io.github.apollographql/graphos-mcp-server MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

GetTopOperations

GetPersistedQueryListStatus

GetLaunchHistory

ApolloConnectorsSpec

GetLaunch

GetSubgraphMetrics

GetMyIdentity

ApolloDocsRead

GetOperationMetrics

GetLatestLaunch

GetVariantDetails

ApolloDocsSearch

GetLintResults

Install

Remote endpoint