Consult7 MCP Server

Consult7 is a Model Context Protocol (MCP) server that enables AI agents to consult large context window models via OpenRouter for analyzing extensive file collections - entire codebases, document repositories, or mixed content that exceed the current agent's context limits.

Why Consult7?

Consult7 enables any MCP-compatible agent to offload file analysis to large context models (up to 2M tokens). Useful when:

• Agent's current context is full
• Task requires specialized model capabilities
• Need to analyze large codebases in a single query
• Want to compare results from different models

"For Claude Code users, Consult7 is a game changer."

How it works

Consult7 collects files from the specific paths you provide (with optional wildcards in filenames), assembles them into a single context, and sends them to a large context window model along with your query. The result is directly fed back to the agent you are working with.

Example Use Cases

Quick codebase summary

• Files: ["/Users/john/project/src/.py", "/Users/john/project/lib/.py"]
• Query: "Summarize the architecture and main components of this Python project"
• Model: "google/gemini-3-flash-preview"
• Mode: "fast"

Deep analysis with reasoning

• Files: ["/Users/john/webapp/src/.py", "/Users/john/webapp/auth/.py", "/Users/john/webapp/api/*.js"]
• Query: "Analyze the authentication flow across this codebase. Think step by step about security vulnerabilities and suggest improvements"
• Model: "anthropic/claude-opus-4.8"
• Mode: "think"

Generate a report saved to file

• Files: ["/Users/john/project/src/.py", "/Users/john/project/tests/.py"]
• Query: "Generate a comprehensive code review report with architecture analysis, code quality assessment, and improvement recommendations"
• Model: "google/gemini-3.1-pro-preview"
• Mode: "think"
• Output File: "/Users/john/reports/code_review.md"
• Result: Returns "Result has been saved to /Users/john/reports/code_review.md" plus a one-line metadata footer, instead of flooding the agent's context

Featured: Gemini 3.1 Models

Consult7 supports Google's Gemini 3.1 family:

• Gemini 3.1 Pro (google/gemini-3.1-pro-preview) - Flagship reasoning model, 1M context
• Gemini 3 Flash (google/gemini-3-flash-preview) - Ultra-fast model, 1M context
• Gemini 3.1 Flash Lite (google/gemini-3.1-flash-lite-preview) - Ultra-fast lite model, 1M context

Quick mnemonics for power users:

• gemt = Gemini 3.1 Pro + think (flagship reasoning)
• gemf = Gemini 3 Flash + fast (ultra fast)
• gptt = GPT-6 Astra + think (latest GPT, effort xhigh)
• grot = Grok 4.7 + think (effort xhigh)
• oput = Claude Opus 4.8 + think (adaptive thinking)
• fabt = Claude Fable 5.1 + think (deepest reasoning, effort xhigh; premium)
• ULTRA = Run GPTT, GROT, and FABT in parallel (3 frontier models)
• FUSE = Fusion: a frontier panel deliberates and a judge synthesizes, in one call

These mnemonics make it easy to reference model+mode combinations in your queries.

Note on Fable 5.1. anthropic/claude-fable-5.1 is Anthropic's most capable model but priced at a premium (~2× Opus 4.8). It does not replace Opus 4.8 as the everyday Claude choice for single calls. Since v3.11.0 it holds the Anthropic seat in the ULTRA panel (which is meant for hard questions anyway). Unlike Opus 4.8 (adaptive thinking only), OpenRouter honors Fable's effort scale, so mid/think map to effort=high/effort=xhigh.

Featured: Fusion (multi-model analysis)

Consult7 supports OpenRouter's Fusion (openrouter/fusion) — a single call where a panel of frontier models (Opus, GPT, Gemini Pro) answers your query in parallel and a judge model synthesizes their responses into one answer. Reach for it on hard questions where multiple perspectives help and the cost of being wrong outweighs a few extra completions.

• Context: 128K — smaller than the 1M–2M single models, so it's best for hard questions on moderate input, not giant file bundles.
• Mode → research depth: fast / mid / think map the panel's web-search/fetch budget to max_tool_calls of 2 / 8 / 16.
• Mnemonic: FUSE = openrouter/fusion.

Trivial prompts answer directly (no panel); the panel fires only when the question warrants deliberation. Fusion is billed per panel run, so it costs more than a single-model call.

Installation

Claude Code

Simply run:

claude mcp add -s user consult7 uvx -- consult7 your-openrouter-api-key

Claude Desktop

Add to your Claude Desktop configuration file:

{
  "mcpServers": {
    "consult7": {
      "type": "stdio",
      "command": "uvx",
      "args": ["consult7", "your-openrouter-api-key"]
    }
  }
}

Replace your-openrouter-api-key with your actual OpenRouter API key.

No installation required - uvx automatically downloads and runs consult7 in an isolated environment.

Command Line Options

uvx consult7 <api-key> [--test]

• <api-key>: Required. Your OpenRouter API key
• --test: Optional. Test the API connection

The model and mode are specified when calling the tool, not at startup.

Supported Models

Consult7 supports all 500+ models available on OpenRouter. Below are the flagship models with optimized dynamic file size limits:

Superseded IDs still work with their tuned settings: openai/gpt-5.6-sol, x-ai/grok-4.6, anthropic/claude-fable-5.

Quick mnemonics:

• gptt = openai/gpt-6-astra + think (latest GPT, deep reasoning [effort xhigh]; premium)
• gemt = google/gemini-3.1-pro-preview + think (Gemini 3.1 Pro, flagship reasoning)
• grot = x-ai/grok-4.7 + think (Grok 4.7, deep reasoning [effort xhigh]; 500K context — use x-ai/grok-4.20 for bigger bundles)
• oput = anthropic/claude-opus-4.8 + think (Claude Opus, adaptive thinking)
• opuf = anthropic/claude-opus-4.8 + fast (Claude Opus, no reasoning)
• fabt = anthropic/claude-fable-5.1 + think (Claude Fable, deepest reasoning [effort xhigh]; premium, hard problems only)
• fabm = anthropic/claude-fable-5.1 + mid (Claude Fable, high-effort reasoning; premium)
• gemf = google/gemini-3-flash-preview + fast (Gemini 3 Flash, ultra fast)
• ULTRA = call GPTT, GROT, and FABT IN PARALLEL (3 frontier models for maximum insight)
• FUSE = openrouter/fusion (one call: a frontier panel deliberates, a judge synthesizes; mode sets web-research depth)

You can use any OpenRouter model ID (e.g., deepseek/deepseek-r1-0528). See the full model list. File size limits are automatically calculated based on each model's context window.

Performance Modes

• fast: No reasoning requested - quick answers, simple tasks. GPT-6 Astra, Grok 4.7 and Fable reason by design, so on them fast means their own default level (billed), shown in the footer as reasoning: model default
• mid: Moderate reasoning - code reviews, bug analysis
• think: Maximum reasoning - security audits, complex refactoring

File Specification Rules

• Absolute paths only: /Users/john/project/src/*.py
• Wildcards in filenames only: /Users/john/project/*.py (not in directory paths)
• Extension required with wildcards: .py not
• Mix files and patterns: ["/path/src/.py", "/path/README.md", "/path/tests/_test.py"]

Common patterns:

• All Python files: /path/to/dir/*.py
• Test files: /path/to/tests/_test.py or /path/to/tests/test_.py
• Multiple extensions: ["/path/.js", "/path/.ts"]

Automatically ignored: __pycache__, .env, secrets.py, .DS_Store, .git, node_modules. Wildcards skip them; naming one explicitly is an error.