Change default port from 5000 to 8000 by DaleSeo · Pull Request #417 · apollographql/apollo-mcp-server

DaleSeo · 2025-10-03T20:07:39Z

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

apollo-librarian · 2025-10-03T20:07:51Z

✅ Docs preview ready

The preview is ready to be viewed. View the preview

File Changes

0 new, 8 changed, 0 removed

* (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: 46666f61a5eebfd195821a4f
Build Logs: View logs

URL: https://www.apollographql.com/docs/deploy-preview/46666f61a5eebfd195821a4f

swcollard · 2025-10-09T19:06:46Z

.changesets/breaking_defalut_port_8000.md

@@ -0,0 +1,20 @@
+### Change default port from 5000 to 8000 - @DaleSeo PR #417


nit, from the README the filename requires a prefix.

Files must start with a prefix that indicates the classification of the changeset.

https://github.com/apollographql/apollo-mcp-server/blob/main/.changesets/README.md

Also do we consider this a breaking change?

Good catch, @swcollard! Yeah, this should be a breaking change. Will update the file name.

swcollard · 2025-10-09T19:10:01Z

docs/source/guides/auth-auth0.mdx


- **Error**: "Port 5000 is already in use"
-  - Solution: Kill any existing processes using port 5000 or specify a different port with the `transport.port` option or `APOLLO_MCP_TRANSPORT__PORT` env variable
+- **Error**: "Port 8000 is already in use"


Could we just remove this section? I assume this troubleshooting step was only added because of the port use region that incentivized us to change the default.

This is probably still relevant. I often forgot to kill the server before starting a new one. 😂

swcollard · 2025-10-09T19:14:15Z

graphql/TheSpaceDevs/README.md

 docker run \
  -it --rm \
  --name apollo-mcp-server \
-  -p 5000:5000 \
+  -p 8000:8000 \
  -v $PWD/graphql/TheSpaceDevs:/data \
  ghcr.io/apollographql/apollo-mcp-server:latest \
-  --http-port 5000 \
+  --http-port 8000 \
  --schema api.graphql \
  --operations operations \
  --endpoint https://thespacedevs-production.up.railway.app/


This docker run command is using CLI arguments instead of the config file which no longer work in the MCP server

swcollard · 2025-10-09T19:14:39Z

graphql/TheSpaceDevs/README.md

 ```

-2. Add the MCP SSE port to your MCP Server configuration for the client appliction you are running. If you are running locally, the server link will be `http://127.0.0.1:5000/sse`.
+2. Add the MCP SSE port to your MCP Server configuration for the client appliction you are running. If you are running locally, the server link will be `http://127.0.0.1:8000/sse`.


SSE is also deprecated :(

OMG, this README.md is really outdated! 🙈

swcollard

Two more small comments inline. Otherwise looks god

swcollard · 2025-10-09T20:20:02Z

graphql/TheSpaceDevs/README.md

  -it --rm \
  --name apollo-mcp-server \
  -p 8000:8000 \
+  -v $PWD/graphql/TheSpaceDevs/config.yaml \


Suggested change

-v $PWD/graphql/TheSpaceDevs/config.yaml \

-v $PWD/graphql/TheSpaceDevs/config.yaml:/config.yaml \

I forget, does this need the path on the other side to tell docker where to mount the file?

You're right and I copied that from our deploy docs! 😂 Will fix it in both places.

apollo-mcp-server/docs/source/deploy.mdx

Line 75 in 93e607b

-v <path/to>/mcp_config.yaml \

swcollard · 2025-10-09T20:20:24Z

graphql/TheSpaceDevs/README.md

@@ -38,28 +38,22 @@ Here is an example configuration you can use _(Note: you must provide your fill
    "thespacedevs": {
      "command": "/Users/michaelwatson/Documents/GitHub/apollographql/apollo-mcp-server/target/debug/apollo-mcp-server",


I also didn't realize this path was hardcoded to /Users/michaelwatson

It really shows how long ago this README.md was written. We should probably delete it and just use the official docs instead.

MCP's default port is changing from 5000 to 8000. (Keep this open until apollographql/apollo-mcp-server#417 is released) Co-authored-by: Michelle Mabuyo <michelle@apollographql.com>

DaleSeo self-assigned this Oct 3, 2025

DaleSeo changed the title ~~Air 42~~ Change default port from 5000 to 8000 Oct 3, 2025

DaleSeo force-pushed the AIR-42 branch from 434a26b to 29281ca Compare October 3, 2025 22:11

DaleSeo added 4 commits October 9, 2025 10:01

feat: change default port from 5000 to 8000

1899899

docs: change default port from 5000 to 8000

47c1367

chore: add changelog

4bd07ba

docs: change default port from 5000 to 8000

373b34d

DaleSeo force-pushed the AIR-42 branch from 29281ca to 373b34d Compare October 9, 2025 14:03

DaleSeo marked this pull request as ready for review October 9, 2025 14:24

DaleSeo requested review from a team as code owners October 9, 2025 14:24

swcollard reviewed Oct 9, 2025

View reviewed changes

chore: update space devs readme

93e607b

DaleSeo requested a review from swcollard October 9, 2025 19:47

swcollard approved these changes Oct 9, 2025

View reviewed changes

docs: add container path

bf4cba2

DaleSeo enabled auto-merge October 9, 2025 21:05

DaleSeo merged commit 300f84a into develop Oct 9, 2025
10 of 11 checks passed

DaleSeo deleted the AIR-42 branch October 9, 2025 21:18

apollo-bot2 mentioned this pull request Oct 16, 2025

Releasing 1.1.0 #453

Merged

		@@ -0,0 +1,20 @@
		### Change default port from 5000 to 8000 - @DaleSeo PR #417

	-v $PWD/graphql/TheSpaceDevs/config.yaml \
	-v $PWD/graphql/TheSpaceDevs/config.yaml:/config.yaml \

		@@ -38,28 +38,22 @@ Here is an example configuration you can use _(Note: you must provide your fill
		"thespacedevs": {
		"command": "/Users/michaelwatson/Documents/GitHub/apollographql/apollo-mcp-server/target/debug/apollo-mcp-server",

Conversation

DaleSeo commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

apollo-librarian bot commented Oct 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Docs preview ready

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

swcollard left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

DaleSeo commented Oct 3, 2025 •

edited

Loading

apollo-librarian bot commented Oct 3, 2025 •

edited

Loading