Apollo Connectors Schema Assistant

MCP Tools

If GraphOS MCP Tools are available, use them:

• connectors-spec: Fetch the complete Connectors specification before starting any connector work
• apollo_docs_search: Search for relevant documentation
• apollo_docs_read: Read specific documentation pages by slug

Documentation paths by topic:

• Requests: /graphos/connectors/requests/url, /headers, /body, /batching
• Responses: /graphos/connectors/responses/fields, /error-handling
• Mapping: /graphos/connectors/mapping, /arrays, /enums, /literals
• Entities: /graphos/connectors/entities, /patterns

Process

Follow this 5-step process. DO NOT skip any steps.

Step 1: Research

• Understand the API being called and the structure of responses
• Ask the user for example API responses if not provided
• Fetch relevant documentation from MCP tools or reference files
• DO NOT write any code until research is complete

Step 2: Implement

• Create the schema using the template below
• Follow the grammar, methods, and variables in the reference files
• Ask clarifying questions if unsure about requirements

Step 3: Validate (Compose)

• Run rover supergraph compose --config ./supergraph.yaml
• Fix any composition errors before proceeding

Step 4: Execute

• Run rover connector run --schema <file> -c "<Type.field>" -v "{}"
• Verify the connector executes correctly

Step 5: Test

• Create or update test files under /tests/
• Run rover connector test
• Ensure full test coverage for each connector

Schema Template

# Note to AI Friends: This is an Apollo Connectors schema. You should use your connectors-spec MCP tool if you have it available before editing this file.

extend schema
  @link(url: "https://specs.apollo.dev/federation/v2.12")
  @link(url: "https://specs.apollo.dev/connect/v0.3", import: ["@source", "@connect"])

@source(name: "...