Skip to content

Conversation

@apollo-bot2
Copy link
Contributor

[1.1.0] - 2025-10-16

❗ BREAKING ❗

Change default port from 5000 to 8000 - @DaleSeo PR #417

The default server port has been changed from 5000 to 8000 to avoid conflicts with common development tools and services that typically use port 5000 (such as macOS AirPlay, Flask development servers, and other local services).

Migration: If you were relying on the default port 5000, you can continue using it by explicitly setting the port in your configuration file or command line arguments.

  • Before
transport: type: streamable_http
  • After
transport: type: streamable_http port: 5000

🚀 Features

feat: Add configuration option for metric temporality - @swcollard PR #413

Creates a new configuration option for telemetry to set the Metric temporality to either Cumulative (default) or Delta.

  • Cumulative - The metric value will be the overall value since the start of the measurement.
  • Delta - The metric will be the difference in the measurement since the last time it was reported.

Some observability vendors require that one is used over the other so we want to support the configuration in the MCP Server.

Add support for forwarding headers from MCP clients to GraphQL APIs - @DaleSeo PR #428

Adds opt-in support for dynamic header forwarding, which enables metadata for A/B testing, feature flagging, geo information from CDNs, or internal instrumentation to be sent from MCP clients to downstream GraphQL APIs. It automatically blocks hop-by-hop headers according to the guidelines in RFC 7230, section 6.1, and it only works with the Streamable HTTP transport.

You can configure using the forward_headers setting:

forward_headers: - x-tenant-id - x-experiment-id - x-geo-country

Please note that this feature is not intended for passing through credentials as documented in the best practices page.

feat: Add mcp-session-id header to HTTP request trace attributes - @swcollard PR #421

Includes the value of the Mcp-Session-Id HTTP header as an attribute of the trace for HTTP requests to the MCP Server

🐛 Fixes

Fix compatibility issue with VSCode/Copilot - @DaleSeo PR #447

This updates Apollo MCP Server’s tool schemas from Draft 2020-12 to Draft‑07 which is more widely supported across different validators. VSCode/Copilot still validate against Draft‑07, so rejects Apollo MCP Server’s tools. Our JSON schemas don’t rely on newer features, so downgrading improves compatibility across MCP clients with no practical impact.

🛠 Maintenance

Update rmcp sdk to version 0.8.x - @swcollard PR #433

Bumping the Rust MCP SDK version used in this server up to 0.8.x

chore: Only initialize a single HTTP client for graphql requests - @swcollard PR #412

Currently the MCP Server spins up a new HTTP client every time it wants to make a request to the downstream graphql endpoint. This change creates a static reqwest client that gets initialized using LazyLock and reused on each graphql request.

This change is based on the suggestion from the reqwest documentation

"The Client holds a connection pool internally, so it is advised that you create one and reuse it."

apollo-bot2 and others added 30 commits October 2, 2025 17:55
chore: Only initialize a single HTTP client for graphql requests
@apollo-bot2 apollo-bot2 added the release Indicates a release related PR label Oct 16, 2025
@apollo-librarian
Copy link

apollo-librarian bot commented Oct 16, 2025

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 9 changed, 0 removed
* (developer-tools)/apollo-mcp-server/(latest)/best-practices.mdx * (developer-tools)/apollo-mcp-server/(latest)/config-file.mdx * (developer-tools)/apollo-mcp-server/(latest)/cors.mdx * (developer-tools)/apollo-mcp-server/(latest)/debugging.mdx * (developer-tools)/apollo-mcp-server/(latest)/deploy.mdx * (developer-tools)/apollo-mcp-server/(latest)/health-checks.mdx * (developer-tools)/apollo-mcp-server/(latest)/quickstart.mdx * (developer-tools)/apollo-mcp-server/(latest)/run.mdx * (developer-tools)/apollo-mcp-server/(latest)/guides/auth-auth0.mdx 

Build ID: 31f7a60c5c8ac38a460a6d32
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/31f7a60c5c8ac38a460a6d32

@alocay alocay marked this pull request as ready for review October 20, 2025 14:55
@alocay alocay requested review from a team as code owners October 20, 2025 14:55
docs: add note about port change
@alocay alocay merged commit fa7e6bf into main Oct 21, 2025
8 checks passed
@alocay alocay deleted the release/1.1.0 branch October 21, 2025 19:14
@github-actions
Copy link

Opened sync PR main → develop: #464

Merge status: clean ✅
Opened from a sync branch created off develop.

alocay added a commit that referenced this pull request Oct 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release Indicates a release related PR

6 participants