Custom GHES host names are not supported

Describe the bug

Currently, any hostname ending with "github.com" (such as "slack-github.com") is incorrectly identified as the public GitHub host github.com. This is because in parsAPiHost(), host's suffix is matched with github.com . As a result, all hosts that end with github.com are characterized as public github.com hosts instead of GHES.

Steps to reproduce the behavior

In the mcp tool's config, set GITHUB_HOST to custom GHES host. Eg abcd-github.com
2.Run any tool. Eg. list_pull_requests

Expected vs actual behavior

Expected: MCP tool should use abcd-github.com/api/v3 rest api url.
Actual: MCP tool uses github.com/api/v3 rest api url.

I had experienced the same issue.

I ran into this with connecting to another github enterprise instance with the name https://github.aq.tc. I tried configuring the hosted instance by setting the GITHUB_HOST environment variable when configuring the docker instance for use with claude code.

@aozgaa

@aozgaa and @HK78-HAHA Sees like it's pretty easy to run into this issue if you're using enterprise github. Did the referenced PR/fix work for your use case?

I totally jumped the gun -- the problem was that I wasn't including the env var GITHUB_HOST in the docker run command. After including it with a config like the following, everything works as expected:

{
  "command": "docker",
  "args": [
    "run",
    "-i",
    "--rm",
    "-e",
    "GITHUB_PERSONAL_ACCESS_TOKEN",
    "-e",
    "GITHUB_HOST",
    "ghcr.io/github/github-mcp-server"
  ],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_<redacted>",
    "GITHUB_HOST": "https://github.aq.tc"
  }
}

This shouldn't bear on the originally reported issue, which seems to trigger a specific codepath that my case shouldn't. Apologies for the confusion.

Still have the same issue... The dangerous with the docker images without tagging is that any new version may remove a previous supported feature without a proper tagging/versioning... Everyone claims it's working, when it's really apparent it's not... Where's the current problem?

🔧 Settings with GITHUB_HOST != github.com

{
  "github-viasat": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "GITHUB_PERSONAL_ACCESS_TOKEN",
      "-e",
      "GITHUB_HOST",
      "ghcr.io/github/github-mcp-server"
    ],
    "env": {
      "GITHUB_HOST": "https://github.company.com",
      "GITHUB_PERSONAL_ACCESS_TOKEN": "gh****PV"
    },
    "working_directory": null
  }
}

🔴 Incorrect MCP API call going to github.com

2025-09-02 15:57:36.905 | [info] MCP CLI: Sending request: {"jsonrpc":"2.0","id":174,"method":"tools/call","params":{"name":"get_pull_request_status","arguments":{"owner":"secrm","pullNumber":262.0,"repo":"vicli/"}}}
2025-09-02 15:57:37.052 | [info] MCP CLI: Received response: {"jsonrpc":"2.0","id":174,"error":{"code":-32603,"message":"failed to get pull request: GET https://api.github.com/repos/secrm/vicli/pulls/262: 401 Bad credentials []"}}

Solution

The current version is working, but users who had pulled the docker image before will fall into the problem
- If you MCP client doesn't pull images before running, then this will result in the problem described above

$ docker pull ghcr.io/github/github-mcp-server
Using default tag: latest
latest: Pulling from github/github-mcp-server
da88a3b79f2c: Pull complete
bfb59b82a9b6: Pull complete
4eff9a62d888: Pull complete
62de241dac5f: Pull complete
a62778643d56: Pull complete
7c12895b777b: Pull complete
3214acf345c0: Pull complete
5664b15f108b: Pull complete
0bab15eea81d: Pull complete
4aa0ea1413d3: Pull complete
da7816fa955e: Pull complete
ddf74a63f7d8: Pull complete
7faf6706c0c2: Pull complete
6ee9adc7733a: Pull complete
76a77595d36b: Pull complete
67f791c3ab27: Pull complete
Digest: sha256:ecc5810a7d76404c03c504d5ff6868cb9aa5b8e31f3e6aaf9ddf453d5a239d34
Status: Downloaded newer image for ghcr.io/github/github-mcp-server:latest
ghcr.io/github/github-mcp-server:latest

⌨️ MCP Client Terminal

Verify if the listed tools from the MCP client is aligned to the current version
- Using a docker tag to the mcp client declaration will help determining the current docker image used
In my case above, the docker image is using the "latest", but in Docker image terms, the docker engine will NOT pull the latest version

tail -f "/Users/mdesales/Library/Application Support/dev.warp.Warp-Stable/mcp/bg6UHOV5u9mIyVB4yztzq0.log"
            name: "github-mcp-server",
            version: "v0.1.1",
        },
        instructions: None,
    },
)

I could see now that the connection was using the proper server config

2025-09-11 10:28:22.891 | [info] MCP [pid: 32258] stderr: time=2025-09-11T17:28:22.886Z level=INFO msg="starting server" version=v0.14.0 host=https://git.viasat.com dynamicToolsets=false readOnly=false
GitHub MCP Server running on stdio

🔧 Suggested Config

Grab the tag for a version that aligns with the released versions at the github docker registry for this image

https://github.com/github/github-mcp-server/pkgs/container/github-mcp-server/versions?filters%5Bversion_type%5D=tagged

Then, configure the docker image setting in the MCP Client config

Tip

I'm setting the version to sha-0c5cfc3 to lock in the version I want to use
With the latest tag, make sure to constantly perform docker pull

{
  "github-company": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "-e",
      "GITHUB_HOST",
      "-e",
      "GITHUB_PERSONAL_ACCESS_TOKEN",
      "ghcr.io/github/github-mcp-server:sha-0c5cfc3"
    ],
    "env": {
      "GITHUB_HOST": "https://github.company.com",
      "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_E****47"
    },
    "working_directory": null
  }
}

✅ Testing

Issue questions to the LLM to use the MCP tool

Closing this one since it seems resolved.

👋 We're actively looking at improving GHES support for the MCP server! If you have thoughts on GHES-specific needs, please share your feedback in this discussion. 🙏

Unfortunately, this is till not closed. My organization has a github url like https://{org_name}-github.com. I can see the docker container is intialized with the right env variables for github_host, token etc. But, the api rest url is being resolved as https://api.github.com instead of https://api.{org_name}-github.com. Upon checking the code, it's pretty obvious why that is happening. It's this line, where we check if host suffix is github.com and then use the default api url instead of using the one that is passed as env variable. I request this issue be re-opened. I am happy to raise a PR for it.

Navigation Menu

Repository navigation

Custom GHES host names are not supported #662

Describe the bug

Steps to reproduce the behavior

Expected vs actual behavior

🔧 Settings with GITHUB_HOST != github.com

🔴 Incorrect MCP API call going to github.com

Solution

⌨️ MCP Client Terminal

🔧 Suggested Config

✅ Testing

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Custom GHES host names are not supported #662

Description

Describe the bug

Steps to reproduce the behavior

Expected vs actual behavior

Activity

4dollar4 commented on Jul 25, 2025

aozgaa commented on Aug 4, 2025

jtquip88 commented on Aug 4, 2025

aozgaa commented on Aug 4, 2025

marcellodesales commented on Sep 2, 2025

🔧 Settings with GITHUB_HOST != github.com

🔴 Incorrect MCP API call going to github.com

marcellodesales commented on Sep 11, 2025

Solution

⌨️ MCP Client Terminal

🔧 Suggested Config

✅ Testing

tonytrg commented on Sep 12, 2025

SamMorrowDrums commented on Nov 25, 2025

jtquip88 commented on Feb 3, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions