docs: change default port from 5000 to 8000

Author: DaleSeo

docs/source/config-file.mdx

@@ -170,7 +170,7 @@ The available fields depend on the value of the nested `type` key:
 | :-------------- | :-------------------- | :--------- | :------------------------------------------------------------------------ |
 | `type`          | `"streamable_http"`   |            | Host the MCP server on the configuration, using streamable HTTP messages. |
 | `address`       | `127.0.0.1` (default) | `IpAddr`   | The IP address to bind to                                                 |
-| `port`          | `5000` (default)      | `u16`      | The port to bind to                                                       |
+| `port`          | `8000` (default)      | `u16`      | The port to bind to                                                       |
 | `stateful_mode` | `true` (default)      | `bool`     | Flag to enable or disable stateful mode and session management.           |
 
 ##### SSE (Deprecated, use StreamableHTTP)
@@ -179,7 +179,7 @@ The available fields depend on the value of the nested `type` key:
 | :-------- | :-------------------- | :--------- | :--------------------------------------------------------------------------------------------------------------- |
 | `type`    | `"sse"`               |            | Host the MCP server on the supplied config, using SSE for communication. Deprecated in favor of `StreamableHTTP` |
 | `address` | `127.0.0.1` (default) | `IpAddr`   | The IP address to bind to                                                                                        |
-| `port`    | `5000` (default)      | `u16`      | The port to bind to                                                                                              |
+| `port`    | `8000` (default)      | `u16`      | The port to bind to                                                                                              |
 
 ### Auth
 

docs/source/cors.mdx

@@ -26,7 +26,7 @@ The following snippet includes an example of each option (use either `allow_any_
 ```yaml title="mcp.yaml"
 transport:
   type: streamable_http
-  port: 5000
+  port: 8000
 
 cors:
   # Enable CORS support
@@ -207,7 +207,7 @@ Here's a simple example of connecting to Apollo MCP Server from a browser:
 
 ```javascript
 async function connectToMCP() {
-  const response = await fetch("http://127.0.0.1:5000/mcp", {
+  const response = await fetch("http://127.0.0.1:8000/mcp", {
     method: "POST",
     headers: {
       Accept: "application/json, text/event-stream",

docs/source/debugging.mdx

@@ -65,7 +65,7 @@ schema:
 transport:
   type: streamable_http
   address: 127.0.0.1
-  port: 5000
+  port: 8000
 ```
 
 ```sh
@@ -81,6 +81,6 @@ npx @modelcontextprotocol/inspector
 1. In a browser, go to the URL returned by Inspector, then fill in the details:
 
    - **Transport Type**: Select `Streamable HTTP`
-   - **URL**: Enter `http://127.0.0.1:5000/mcp`, where the port must match the `transport.port` option
+   - **URL**: Enter `http://127.0.0.1:8000/mcp`, where the port must match the `transport.port` option
 
 1. Click **Connect** and **List Tools**. You should see the tools for the operations you provided.

docs/source/deploy.mdx

@@ -19,12 +19,12 @@ For most production deployments, use the all-in-one [Apollo Runtime Container](/
 
 ### Deploy the Apollo Runtime Container
 
-The Apollo Runtime Container includes all services necessary to serve GraphQL and MCP requests, including Apollo Router and Apollo MCP Server. Both port `4000` (GraphQL) and `5000` (MCP) are exposed.
+The Apollo Runtime Container includes all services necessary to serve GraphQL and MCP requests, including Apollo Router and Apollo MCP Server. Both port `4000` (GraphQL) and `8000` (MCP) are exposed.
 
 ```bash title="Deploy with GraphOS (Recommended)"
 docker run \
   -p 4000:4000 \
-  -p 5050:5000 \
+  -p 8000:8000 \
   --env APOLLO_GRAPH_REF="<your-graph-ref>" \
   --env APOLLO_KEY="<your-graph-api-key>" \
   --env MCP_ENABLE=1 \

docs/source/guides/auth-auth0.mdx

@@ -31,7 +31,7 @@ This guide uses [Auth0](https://auth0.com/) as the Identity Provider.
 1. In your dashboard, navigate to **Applications** -> **APIs**.
 1. Click **Create API**.
 1. Give it a friendly name like `MCP Auth API`.
-1. For the **Identifier** field, Auth0 recommends using a URL. This identifier is used in the MCP server configuration later as the `audience` property. For this guide, use `http://localhost:5000/mcp-example`.
+1. For the **Identifier** field, Auth0 recommends using a URL. This identifier is used in the MCP server configuration later as the `audience` property. For this guide, use `http://localhost:8000/mcp-example`.
 1. Leave the defaults for the rest of the fields and click **Create**.
 1. Navigate to your dashboard **Settings**.
    1. Under **General** -> **API Authorization Settings**, set the **Default Audience** to the `Identifier` you chose.
@@ -89,14 +89,14 @@ Configure the MCP server to use the Auth0 instance for authentication.
          - https://<AUTH0 DOMAIN> # Fill in your Auth0 domain
        audiences:
          - <AUTH0 DEFAULT AUDIENCE> # Fill in your Auth0 Identifier
-       resource: http://127.0.0.1:5000/mcp
+       resource: http://127.0.0.1:8000/mcp
        scopes:
          - read:users # Adjust scopes as needed
    ```
 
 1. Replace the `<AUTH0 DOMAIN>` with your own Auth0 domain from earlier.
 
-1. Replace the `<AUTH0 DEFAULT AUDIENCE>` with the matching `Identifier` you set when creating the Auth0 API. In this guide, you used `http://localhost:5000/mcp-example`.
+1. Replace the `<AUTH0 DEFAULT AUDIENCE>` with the matching `Identifier` you set when creating the Auth0 API. In this guide, you used `http://localhost:8000/mcp-example`.
 
 Your MCP server is now configured to use Auth0 for authentication.
 
@@ -188,7 +188,7 @@ You need a graph's credentials and a valid GraphOS plan to use the router's auth
 
    The browser should open automatically with a proxy auth token.
 
-1. In the MCP Inspector, select `Streamable HTTP` as the Transport Type and enter `http://127.0.0.1:5000/mcp` as the URL.
+1. In the MCP Inspector, select `Streamable HTTP` as the Transport Type and enter `http://127.0.0.1:8000/mcp` as the URL.
 1. Click **Connect**. This triggers the OAuth flow, and you are redirected to the Auth0 login page.
 1. Log in with the credentials you set up in the Auth0 connection and allow MCP Inspector access.
 1. After you connect, the browser redirects back to MCP Inspector.
@@ -241,7 +241,7 @@ Then, continue with the following steps:
 | "What would you like to configure?"                         | "Add Extension"                            |
 | "What type of extension would you like to add?"             | "Command Line Extension"                   |
 | "What's the name of this extension?"                        | "mcp-auth-quickstart"                      |
-| "What command should be run?"                               | `npx mcp-remote http://127.0.0.1:5000/mcp` |
+| "What command should be run?"                               | `npx mcp-remote http://127.0.0.1:8000/mcp` |
 | Other prompts (timeout, description, environment variables) | Use the default values                     |
 
 1. To start Goose, type `goose`. This will open a browser window and send you through the auth flow.
@@ -255,8 +255,8 @@ Then, continue with the following steps:
 
 #### MCP Server Won't Start
 
-- **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"
+  - Solution: Kill any existing processes using port 8000 or specify a different port with the `transport.port` option or `APOLLO_MCP_TRANSPORT__PORT` env variable
 - **Error**: "Failed to load supergraph configuration"
   - Solution: Verify you're running the command from the repo root directory
   - Solution: Check that the path to `supergraph.yaml` is correct
@@ -269,7 +269,7 @@ Then, continue with the following steps:
 
 - **Error**: "Failed to connect to server"
   - Solution: Ensure the MCP server is running (check terminal output)
-  - Solution: Verify you're using the correct URL (`http://127.0.0.1:5000/mcp`)
+  - Solution: Verify you're using the correct URL (`http://127.0.0.1:8000/mcp`)
   - Solution: Check if your firewall is blocking the connection
 
 ### Infinite loop during OAuth flow

docs/source/health-checks.mdx

@@ -15,7 +15,7 @@ Health checks are only available when using the `streamable_http` transport and
 transport:
   type: streamable_http
   address: 127.0.0.1
-  port: 5000
+  port: 8000
 health_check:
   enabled: true
   path: /health

docs/source/quickstart.mdx

@@ -110,7 +110,7 @@ You can run the MCP Server using the Rover CLI or Docker.
     docker run \
       -it --rm \
       --name apollo-mcp-server \
-      -p 5000:5000 \
+      -p 8000:8000 \
       -v $PWD/graphql/TheSpaceDevs/config.yaml:/config.yaml \
       -v $PWD/graphql/TheSpaceDevs:/data \
       --pull always \
@@ -120,7 +120,7 @@ You can run the MCP Server using the Rover CLI or Docker.
     This command:
     - Starts an MCP Server in a Docker container
     - Maps configuration files into the proper place for the Apollo MCP Server container
-    - Forwards port 5000 for accessing the MCP Server
+    - Forwards port 8000 for accessing the MCP Server
 
 ## Step 3: Verify the MCP Server with MCP Inspector
 
@@ -134,7 +134,7 @@ You can run the MCP Server using the Rover CLI or Docker.
 
 1. In Inspector:
     - Select `Streamable HTTP` as the Transport Type
-    - Enter `http://127.0.0.1:5000/mcp` as the URL
+    - Enter `http://127.0.0.1:8000/mcp` as the URL
     - Click **Connect**, then **List Tools**
 
     You should see the tools from your server listed.
@@ -159,7 +159,7 @@ Then add the following configuration
             "command": "npx",
             "args": [
                 "mcp-remote",
-                "http://127.0.0.1:5000/mcp"
+                "http://127.0.0.1:8000/mcp"
             ]
         }
       }
@@ -194,16 +194,16 @@ Let's verify everything is working:
 ### Common Issues
 
 #### MCP Server Won't Start
-- **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"
+  - Solution: Kill any existing processes using port 8000 or specify a different port with the `transport.port` option or `APOLLO_MCP_TRANSPORT__PORT` env variable
 - **Error**: "Failed to load supergraph configuration"
   - Solution: Verify you're running the command from the repo root directory
   - Solution: Check that the path to `supergraph.yaml` is correct
 
 #### MCP Inspector Connection Issues
 - **Error**: "Failed to connect to server"
   - Solution: Ensure the MCP server is running (check terminal output)
-  - Solution: Verify you're using the correct URL (`http://127.0.0.1:5000/mcp`)
+  - Solution: Verify you're using the correct URL (`http://127.0.0.1:8000/mcp`)
   - Solution: Check if your firewall is blocking the connection
 
 #### Claude Desktop Issues

docs/source/run.mdx

@@ -105,7 +105,7 @@ The container sets a few defaults for ease of use:
 
 - **Working Directory is `/data`**: Make sure to mount static schemas / operations to this location
   using the volume flag when running [(`-v` / `--volume`)](https://docs.docker.com/reference/cli/docker/container/run/#volume).
-- **HTTP Streamable Transport on port 5000**: Make sure to export container port 5000 for HTTP Streamable connections to
+- **HTTP Streamable Transport on port 8000**: Make sure to export container port 8000 for HTTP Streamable connections to
   the MCP server using the port flag when running [(`-p` / `--port`)](https://docs.docker.com/reference/cli/docker/container/run/#publish)
 
 </Note>
@@ -116,7 +116,7 @@ Run the following Docker command to start the MCP Server, replacing the values f
 docker run \
   -it --rm \
   --name apollo-mcp-server \
-  -p 5000:5000 \
+  -p 8000:8000 \
   -v <PATH/TO/CONFIG/FILE>:/config.yaml \
   -v <PATH/TO/PROJECT/ROOT>:/data \
   --pull always \
@@ -127,7 +127,7 @@ This command:
 
 - Starts an MCP Server in a Docker container
 - Maps configuration files into the proper place for the Apollo MCP Server container
-- Forwards port 5000 for accessing the MCP Server
+- Forwards port 8000 for accessing the MCP Server
 
 ## With the Rover CLI
 
@@ -147,12 +147,12 @@ The Apollo Runtime Container runs both the MCP Server and the [Apollo Router](ht
 
 The Apollo Runtime container includes all services necessary to serve GraphQL and MCP requests, including the Router and MCP Server. It is the easiest way to operate a GraphQL API with MCP support.
 
-To serve both MCP and GraphQL requests, both port `4000` and `5000` will need to be exposed. An example command which retrieves the schema from Uplink is:
+To serve both MCP and GraphQL requests, both port `4000` and `8000` will need to be exposed. An example command which retrieves the schema from Uplink is:
 
 ```bash title="Docker" {3, 6}
 docker run \
   -p 4000:4000 \
-  -p 5000:5000 \
+  -p 8000:8000 \
   --env APOLLO_GRAPH_REF="<your-graph-ref>" \
   --env APOLLO_KEY="<your-graph-api-key>" \
   --env MCP_ENABLE=1 \

graphql/TheSpaceDevs/README.md

@@ -69,16 +69,16 @@ There are operations located at `./operations/*.graphql` for you to use in your
 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/
 ```
 
-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`.
 
 _Note: Claude Desktop currently doesn't support SSE_
 
@@ -87,7 +87,7 @@ _Note: Claude Desktop currently doesn't support SSE_
   "mcpServers": {
     "thespacedevs": {
       "type": "sse",
-      "url": "http://127.0.0.1:5000/sse>"
+      "url": "http://127.0.0.1:8000/sse>"
     }
   }
 }