prepare release v0.6.0

[nicholascioli]

[0.6.0] - 2025-07-14

❗ BREAKING ❗

Replace CLI flags with a configuration file - @nicholascioli PR #162

All command line arguments are now removed and replaced with equivalent configuration
options. The Apollo MCP server only accepts a single argument which is a path to a
configuration file. An empty file may be passed, as all options have sane defaults
that follow the previous argument defaults.

All options can be overridden by environment variables. They are of the following
form:

• Prefixed by APOLLO_MCP_
• Suffixed by the config equivalent path, with __ marking nested options.

E.g. The environment variable to change the config option introspection.execute.enabled
would be APOLLO_MCP_INTROSPECTION__EXECUTE__ENABLED.

Below is a valid configuration file with some options filled out:

custom_scalars: /path/to/custom/scalars
endpoint: http://127.0.0.1:4000
graphos:
  apollo_key: some.key
  apollo_graph_ref: example@graph
headers:
  X-Some-Header: example-value
introspection:
  execute:
    enabled: true
  introspect:
    enabled: false
logging: 
  level: info
operations:
  source: local
  paths:
    - /path/to/operation.graphql
    - /path/to/other/operation.graphql
overrides:
  disable_type_description: false
  disable_schema_description: false
  enable_explorer: false
  mutation_mode: all
schema:
  source: local
  path: /path/to/schema.graphql
transport:
  type: streamable_http
  address: 127.0.0.1
  port: 5000

🚀 Features

Add search tool - @pubmodmatt PR #171

A new experimental search tool has been added that allows the AI model to specify a set of terms to search for in the GraphQL schema. The top types matching that search are returned, as well as enough information to enable creation of GraphQL operations involving those types.

[apollo-librarian]

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 4 changed, 0 removed

* (developer-tools)/apollo-mcp-server/(latest)/best-practices.mdx
* (developer-tools)/apollo-mcp-server/(latest)/command-reference.mdx
* (developer-tools)/apollo-mcp-server/(latest)/quickstart.mdx
* (developer-tools)/apollo-mcp-server/(latest)/guides/index.mdx

Build ID: 8c2d4302dcb3fab2aae22500
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/8c2d4302dcb3fab2aae22500

[DaleSeo]

We need to update our user guide to use the config file instead of the CLI flags unless, unless there's a separate PR for that. I've captured the example commands that need changes from the preview.

[nicholascioli]

I've rebased and updated the docs.

[DaleSeo]

Same question as apollographql/rover#2665 (comment).

[nicholascioli]

Answered that question. If that solution works with you then I'll update this PR to not have the --mcp flag in this example.

[DaleSeo]

The config options look quite off in the preview. Can you double-check the markdown formatting?

[alocay]

LGTM

[alocay]

The markdown in the deploy preview for the command reference is a bit off

Edit: Fixed now