MCP Directory

How to add Consult7 to Windsurf

Offload large-context file analysis to 500+ OpenRouter models (up to 2M tokens) from any MCP agent. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 293★ · stdio · apikey

Windsurf config for Consult7

claude mcp add -s user consult7 uvx -- consult7 your-openrouter-api-key
{
  "mcpServers": {
    "consult7": {
      "command": "uvx",
      "args": [
        "consult7",
        "your-openrouter-api-key"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Consult7 config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Consult7's tools become available to Cascade.

Before you start

  • An OpenRouter API key
  • uvx (from uv) to download and run the server in an isolated environment
  • An MCP-compatible client such as Claude Code or Claude Desktop

What Consult7 can do in Windsurf

consultation

Collects files from the given absolute paths (wildcards allowed in filenames only), assembles them into a single context, and sends them with your query to a chosen OpenRouter model. Parameters: files (required list of absolute paths/patterns), query (required), model (required OpenRouter model ID), mode (required: fast | mid | think), output_file (optional absolute path to save the response, returns only a confirmation message), and zdr (optional bool to enable Zero Data Retention routing, default false).

Security

Requires an OpenRouter API key, passed as a command-line argument. Files matching __pycache__, .env, secrets.py, .DS_Store, .git, and node_modules are automatically ignored. File contents are sent to the selected OpenRouter model; an optional zdr parameter enables Zero Data Retention routing (available for Gemini 3.1 Pro/Flash, Claude Opus 4.8, GPT-5, GPT-5.5; not available for Grok 4.20).

Consult7 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Consult7 config there under the "mcpServers" key and restart the client.

Is Consult7 safe to use with Windsurf?

Requires an OpenRouter API key, passed as a command-line argument. Files matching __pycache__, .env, secrets.py, .DS_Store, .git, and node_modules are automatically ignored. File contents are sent to the selected OpenRouter model; an optional zdr parameter enables Zero Data Retention routing (available for Gemini 3.1 Pro/Flash, Claude Opus 4.8, GPT-5, GPT-5.5; not available for Grok 4.20).

Do I need to install anything?

No. uvx automatically downloads and runs consult7 in an isolated environment; you only need an OpenRouter API key.

Which models can I use?

All 500+ models available on OpenRouter via their model IDs (e.g. google/gemini-3.1-pro-preview, anthropic/claude-opus-4.8, x-ai/grok-4.20). File size limits are calculated automatically from each model's context window.

How do file paths work?

Use absolute paths only. Wildcards are allowed in filenames but not in directory paths, and an extension is required with wildcards (e.g. /Users/john/project/src/*.py). You can mix explicit files and patterns in one list.

View repo Full Consult7 page