Volante MCP Server
by ribato22io.github.ribato22/volantev0.10.0
Routes to the best predicted fit from configured metadata/evidence after hard-capability filtering.
1Pythonstdioofficial registry
context tax
queued
security
queued
cold start
queued
freshness
Maintained55d ago
Install Volante MCP server
Install in Claude Code
claude mcp add volante -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e MOONSHOT_API_KEY='<moonshot-api-key>' -e OLLAMA_API_KEY='<ollama-api-key>' -e OPENAI_COMPAT_KEY='<openai-compat-key>' -e OPENAI_COMPAT_2_KEY='<openai-compat-2-key>' -e OPENAI_COMPAT_3_KEY='<openai-compat-3-key>' -- uvx volanteInstall in Cursor
{
"mcpServers": {
"volante": {
"command": "uvx",
"args": [
"volante"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"MOONSHOT_API_KEY": "<moonshot-api-key>",
"OLLAMA_API_KEY": "<ollama-api-key>",
"OPENAI_COMPAT_KEY": "<openai-compat-key>",
"OPENAI_COMPAT_2_KEY": "<openai-compat-2-key>",
"OPENAI_COMPAT_3_KEY": "<openai-compat-3-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"volante": {
"command": "uvx",
"args": [
"volante"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"MOONSHOT_API_KEY": "<moonshot-api-key>",
"OLLAMA_API_KEY": "<ollama-api-key>",
"OPENAI_COMPAT_KEY": "<openai-compat-key>",
"OPENAI_COMPAT_2_KEY": "<openai-compat-2-key>",
"OPENAI_COMPAT_3_KEY": "<openai-compat-3-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"volante": {
"type": "stdio",
"command": "uvx",
"args": [
"volante"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"MOONSHOT_API_KEY": "<moonshot-api-key>",
"OLLAMA_API_KEY": "<ollama-api-key>",
"OPENAI_COMPAT_KEY": "<openai-compat-key>",
"OPENAI_COMPAT_2_KEY": "<openai-compat-2-key>",
"OPENAI_COMPAT_3_KEY": "<openai-compat-3-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"volante": {
"command": "uvx",
"args": [
"volante"
],
"env": {
"ANTHROPIC_API_KEY": "<anthropic-api-key>",
"MOONSHOT_API_KEY": "<moonshot-api-key>",
"OLLAMA_API_KEY": "<ollama-api-key>",
"OPENAI_COMPAT_KEY": "<openai-compat-key>",
"OPENAI_COMPAT_2_KEY": "<openai-compat-2-key>",
"OPENAI_COMPAT_3_KEY": "<openai-compat-3-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ANTHROPIC_API_KEY | — | yes | Anthropic API key. |
| ANTHROPIC_MODELS | — | — | Comma-separated Anthropic wire model ids. |
| ANTHROPIC_NAMES | — | — | Optional comma-separated canonical model ids. |
| ANTHROPIC_STRENGTHS | — | — | Shared comma-separated routing strengths. |
| ANTHROPIC_CONTEXT | — | — | Shared context-window tokens. |
| ANTHROPIC_MAX_OUTPUT | — | — | Shared maximum output tokens. |
| ANTHROPIC_TOOLS | — | — | Declare tool-call support (1 or 0). |
| ANTHROPIC_COST_IN | — | — | Shared USD per 1k input tokens. |
| ANTHROPIC_COST_OUT | — | — | Shared USD per 1k output tokens. |
| ANTHROPIC_TIER | — | — | Shared capability tier from 1 to 4. |
| MOONSHOT_API_KEY | — | yes | Moonshot API key. |
| MOONSHOT_BASE_URL | — | — | Moonshot OpenAI-compatible base URL. |
| MOONSHOT_MODELS | — | — | Comma-separated Moonshot wire model ids. |
| MOONSHOT_NAMES | — | — | Optional comma-separated canonical model ids. |
| MOONSHOT_STRENGTHS | — | — | Shared comma-separated routing strengths. |
| MOONSHOT_CONTEXT | — | — | Shared context-window tokens. |
| MOONSHOT_MAX_OUTPUT | — | — | Shared maximum output tokens. |
| MOONSHOT_TOOLS | — | — | Declare tool-call support (1 or 0). |
| MOONSHOT_COST_IN | — | — | Shared USD per 1k input tokens. |
| MOONSHOT_COST_OUT | — | — | Shared USD per 1k output tokens. |
| MOONSHOT_TIER | — | — | Shared capability tier from 1 to 4. |
| OLLAMA_BASE_URL | — | — | Local Ollama OpenAI-compatible base URL. |
| OLLAMA_API_KEY | — | yes | Optional credential for the Ollama endpoint. |
| OLLAMA_MODELS | — | — | Comma-separated Ollama wire model ids. |
| OLLAMA_NAMES | — | — | Optional comma-separated canonical model ids. |
| OLLAMA_STRENGTHS | — | — | Shared comma-separated routing strengths. |
| OLLAMA_CONTEXT | — | — | Shared context-window tokens. |
| OLLAMA_MAX_OUTPUT | — | — | Shared maximum output tokens. |
| OLLAMA_TOOLS | — | — | Declare tool-call support (1 or 0). |
| OLLAMA_COST_IN | — | — | Shared USD per 1k input tokens. |
| OLLAMA_COST_OUT | — | — | Shared USD per 1k output tokens. |
| OLLAMA_TIER | — | — | Shared capability tier from 1 to 4. |
| CLAUDE_CODE_ENABLED | — | — | Set to 1 to enable the logged-in Claude Code CLI. |
| CLAUDE_CODE_MODELS | — | — | Comma-separated Claude Code model ids. |
| CLAUDE_CODE_TIER | — | — | Shared capability tier from 1 to 4. |
| CLAUDE_CODE_MAX_OUTPUT | — | — | Shared maximum output tokens. |
| CLAUDE_CODE_TIMEOUT | — | — | Per-call timeout in seconds. |
| CLAUDE_CODE_SYSTEM_PROMPT_MODE | — | — | System-prompt mode: replace or append. |
| CODEX_ENABLED | — | — | Set to 1 to enable the logged-in Codex CLI. |
| CODEX_MODELS | — | — | Comma-separated Codex model ids. |
| CODEX_TIER | — | — | Required capability tier from 1 to 4 when enabled. |
| CODEX_CONTEXT | — | — | Shared context-window tokens. |
| CODEX_MAX_OUTPUT | — | — | Shared maximum output tokens. |
| CODEX_COST_IN | — | — | Shared API-equivalent input valuation. |
| CODEX_COST_OUT | — | — | Shared API-equivalent output valuation. |
| CODEX_TIMEOUT | — | — | Per-call timeout in seconds. |
| OPENAI_COMPAT_BASE_URL | — | — | Compatible slot 1 base URL. |
| OPENAI_COMPAT_KEY | — | yes | Compatible slot 1 API key. |
| OPENAI_COMPAT_MODEL | — | — | Compatible slot 1 wire model id. |
| OPENAI_COMPAT_NAME | — | — | Compatible slot 1 canonical model id. |
| OPENAI_COMPAT_STRENGTHS | — | — | Compatible slot 1 comma-separated strengths. |
| OPENAI_COMPAT_CONTEXT | — | — | Compatible slot 1 context-window tokens. |
| OPENAI_COMPAT_MAX_OUTPUT | — | — | Compatible slot 1 maximum output tokens. |
| OPENAI_COMPAT_TOOLS | — | — | Compatible slot 1 tool-call support (1 or 0). |
| OPENAI_COMPAT_COST_IN | — | — | Compatible slot 1 input cost. |
| OPENAI_COMPAT_COST_OUT | — | — | Compatible slot 1 output cost. |
| OPENAI_COMPAT_TIER | — | — | Compatible slot 1 capability tier. |
| OPENAI_COMPAT_2_BASE_URL | — | — | Compatible slot 2 base URL. |
| OPENAI_COMPAT_2_KEY | — | yes | Compatible slot 2 API key. |
| OPENAI_COMPAT_2_MODEL | — | — | Compatible slot 2 wire model id. |
| OPENAI_COMPAT_2_NAME | — | — | Compatible slot 2 canonical model id. |
| OPENAI_COMPAT_2_STRENGTHS | — | — | Compatible slot 2 comma-separated strengths. |
| OPENAI_COMPAT_2_CONTEXT | — | — | Compatible slot 2 context-window tokens. |
| OPENAI_COMPAT_2_MAX_OUTPUT | — | — | Compatible slot 2 maximum output tokens. |
| OPENAI_COMPAT_2_TOOLS | — | — | Compatible slot 2 tool-call support (1 or 0). |
| OPENAI_COMPAT_2_COST_IN | — | — | Compatible slot 2 input cost. |
| OPENAI_COMPAT_2_COST_OUT | — | — | Compatible slot 2 output cost. |
| OPENAI_COMPAT_2_TIER | — | — | Compatible slot 2 capability tier. |
| OPENAI_COMPAT_3_BASE_URL | — | — | Compatible slot 3 base URL. |
| OPENAI_COMPAT_3_KEY | — | yes | Compatible slot 3 API key. |
| OPENAI_COMPAT_3_MODEL | — | — | Compatible slot 3 wire model id. |
| OPENAI_COMPAT_3_NAME | — | — | Compatible slot 3 canonical model id. |
| OPENAI_COMPAT_3_STRENGTHS | — | — | Compatible slot 3 comma-separated strengths. |
| OPENAI_COMPAT_3_CONTEXT | — | — | Compatible slot 3 context-window tokens. |
| OPENAI_COMPAT_3_MAX_OUTPUT | — | — | Compatible slot 3 maximum output tokens. |
| OPENAI_COMPAT_3_TOOLS | — | — | Compatible slot 3 tool-call support (1 or 0). |
| OPENAI_COMPAT_3_COST_IN | — | — | Compatible slot 3 input cost. |
| OPENAI_COMPAT_3_COST_OUT | — | — | Compatible slot 3 output cost. |
| OPENAI_COMPAT_3_TIER | — | — | Compatible slot 3 capability tier. |
| VOLANTE_QUALITY_PROFILES_FILE | — | — | Local strict-JSON quality-evidence file. |
| VOLANTE_MODEL_OVERRIDES_FILE | — | — | Local strict-JSON per-model metadata override file. |
| VOLANTE_FETCH_ALLOWLIST | — | — | Comma-separated domains that enable fetch_url. |
| VOLANTE_READ_ROOT | — | — | Root directory that enables confined read_file. |
| VOLANTE_SANDBOX | — | — | Agentic execution sandbox. Unset auto-selects docker when available and otherwise disables code execution; subprocess opts in to unisolated execution. |
| VOLANTE_MAX_SUBSCRIPTION_CALLS | — | — | Physical subscription calls allowed per run. |
Freshness
Maintained — last maintenance signal 55d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-12 · 59d ago · GitHub
Latest release
2026-08-15 · 55d ago · GitHub · v0.10.0
Package published
no data · npm/PyPI
Registry entry updated
2026-08-15 · 55d ago · official registry · v0.10.0
FAQ
›How do I install the Volante MCP server in Claude Code?
Run: claude mcp add volante -e ANTHROPIC_API_KEY='<anthropic-api-key>' -e MOONSHOT_API_KEY='<moonshot-api-key>' -e OLLAMA_API_KEY='<ollama-api-key>' -e OPENAI_COMPAT_KEY='<openai-compat-key>' -e OPENAI_COMPAT_2_KEY='<openai-compat-2-key>' -e OPENAI_COMPAT_3_KEY='<openai-compat-3-key>' -- uvx volante. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Volante require an API key?
Yes. It expects ANTHROPIC_API_KEY, MOONSHOT_API_KEY, OLLAMA_API_KEY, OPENAI_COMPAT_KEY, OPENAI_COMPAT_2_KEY, OPENAI_COMPAT_3_KEY, of which 6 are secrets.
›Can I use Volante as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Volante in the official MCP registry?
Yes, as io.github.ribato22/volante.