GitMCP for Windsurf: Setup & Config

What you can do with GitMCP in Windsurf

Ground coding questions in public GitHub documentation and code without repository-side setup.

• Ask an assistant how to use a public GitHub library.
• Search repository documentation for a particular API or concept.
• Follow external references mentioned in project documentation.

Before you start: GitMCP in Windsurf

• An MCP-compatible client
• A public GitHub repository or GitHub Pages project
• npx when using the documented local bridge

Replace {owner} and {repo} with the desired public project's identifiers. This command is the README's bridge configuration, not a locally hosted GitMCP server. Direct SSE clients can use the URL; https://gitmcp.io/docs is the documented dynamic alternative. Tool names for repository-specific access are reproduced as shown in the supplied README.

GitMCP Windsurf configuration

1. Choose Windsurf configuration scope

   For GitMCP, open macOS/Linux: ~/.codeium/windsurf/mcp_config.json Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json. Merge into mcpServers; remote endpoints use serverUrl.

2. Add GitMCP to Windsurf

   Use the git-mcp entry below in mcpServers. Keep GitMCP's documented sse connection fields and your other Windsurf entries.

3. Check GitMCP in Windsurf

   GitMCP: Refresh MCP in Windsurf settings and inspect Cascade’s tools.

{
  "mcpServers": {
    "git-mcp": {
      "serverUrl": "https://gitmcp.io/%7Bowner%7D/%7Brepo%7D"
    }
  }
}

GitMCP tools available to Windsurf

GitMCP's stored tool list documents 7 tools; compare it with Windsurf's connected tool list, because the stored list is not a live check.

fetch__documentation

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for fetch__documentation.

Retrieve the repository's primary documentation, prioritizing sources such as llms.txt.

search__documentation

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for search__documentation.

Find relevant passages in repository documentation using a query.

fetch_url_content

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for fetch_url_content.

search__code

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for search__code.

Find repository implementation examples through GitHub code search.

fetch_generic_documentation

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for fetch_generic_documentation.

search_generic_code

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for search_generic_code.

search_generic_documentation

After refreshing GitMCP in Windsurf settings, check Cascade's tool list for search_generic_documentation.

Search documentation for a selected repository through the generic server.

GitMCP: full stored tool descriptions

Troubleshooting GitMCP in Windsurf

• For GitMCP, Windsurf reads serverUrl (gitmcp.io), not url. Refresh the connection and check the tools exposed to Cascade.
• GitMCP: check sse connectivity to gitmcp.io from Windsurf; a stdio command is not a replacement for this endpoint.
• Transport mismatch: GitMCP's catalog lists stdio; the displayed Windsurf configuration uses sse.
• Known limitation: Access is limited to publicly available content.
• Known limitation: The generic endpoint depends on choosing the intended repository correctly.
• Known limitation: GitHub Pages retrieval follows robots.txt restrictions.
• General Windsurf troubleshooting lives in the /clients/windsurf guide.

Frequently asked questions