@ask-llm/mcp

Ask LLM MCP (Unified)

All LLM providers in one MCP server — auto-detects what's installed

A unified MCP server that auto-detects installed LLM providers (Gemini, Codex, Claude, Ollama, Antigravity) and registers only the available tools. One install, all providers. Works with Claude Code, Codex CLI, Cursor, Warp, Copilot, and 40+ other MCP clients.

Part of the Ask LLM monorepo.

Quick Start

Claude Code

claude mcp add ask-llm -- npx -y @ask-llm/mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ask-llm": {
      "command": "npx",
      "args": ["-y", "@ask-llm/mcp"]
    }
  }
}

Prerequisites

• Node.js v20.0.0 or higher
• At least one provider installed:
  • Gemini CLI for ask-gemini tools
  • Codex CLI for ask-codex tools
  • Claude Code CLI for Codex and other non-Claude hosts to consult Claude
  • Ollama running locally for ask-ollama tools

How It Works

On startup, the unified server:

• Checks CLI availability (Gemini, Codex, Claude, Antigravity)
• Checks HTTP availability via health endpoints (Ollama)
• Dynamically imports and registers tools from available providers
• Exposes only the tools for providers that are actually installed

Tools

The orchestrator exposes a single ask-llm tool (not one tool per provider — ADR-029, for token efficiency); you pick the provider per call. When any provider is installed it registers:

Tool	Purpose
ask-llm	Route a prompt to a provider via the provider param (gemini, codex, claude, ollama, antigravity); optional sessionId for multi-turn
multi-llm	Dispatch one prompt to multiple providers in parallel; structured per-provider report
get-usage-stats	Per-session token totals + per-provider/model breakdowns (in-memory)
diagnose	Environment diagnostics — provider CLI presence + versions
ping	Connection test

Claude is intentionally suppressed when the MCP host is already Claude Code because Claude Code rejects nested Claude sessions. It is auto-detected normally from Codex and other clients.

Documentation

Full docs at lykhoyda.github.io/ask-llm

License

MIT