docs/integrations/windsurf

How to connect the Python Code Linter MCP Tool to Windsurf

Static analysis for Python files. Detects syntax errors, unused imports, style violations, and complexity issues. Zero external dependencies. This guide provides the exact configuration required to load the python_lint_checker 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", "python_lint_checker"]
    }
  }
}

Step 3: Try it out

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

"Check src/main.py for any lint errors or code quality issues."

Explore more