docs/integrations/windsurf

How to connect the GitHub Issue Manager MCP Tool to Windsurf

Triage, create, label, and close GitHub issues natively from your AI agent. Safely preview changes before execution. This guide provides the exact configuration required to load the manage_issue tool inside Windsurf.

Step 1: Open the configuration file

Locate and open your Windsurf configuration file at the following path:

macOS / Linux~/.codeium/windsurf/mcp_config.json

Windows%USERPROFILE%\.codeium\windsurf\mcp_config.json

Step 2: Add the server config

Copy and paste the following JSON snippet into the file. Save the file and restart Windsurf.

mcp_config.json

{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--tools", "manage_issue"]
    }
  }
}

Step 3: Try it out

Once restarted, ask Windsurf something like this to trigger the tool:

"Create a bug report issue in 'myorg/myrepo' titled 'Login button alignment'."

Explore more

→ View full manage_issue documentation → See all Client integrations