kagi-mcp

kagi-mcp is a tiny MCP server built on top of kagi-cli.

It is intentionally just an extra repo:

• separate repo
• one Rust binary
• wraps the kagi CLI instead of reimplementing Kagi logic
• returns the same JSON the CLI already emits

kagi-cli v0.5.0 also ships a native kagi mcp command. Use that when you only need the minimal built-in tools (kagi_search, kagi_summarize, and kagi_quick). Use this repo when you want the broader CLI surface exposed to agents, including Assistant, News, Translate, enrichment, local history, and local site preferences.

Requirements

• kagi-cli v0.5.0 or newer
• A working kagi binary on PATH, or KAGI_CLI_PATH pointing to it
• Kagi credentials provided through environment variables
  • KAGI_SESSION_TOKEN - for subscriber features (search, quick, assistant, translate, etc.)
  • KAGI_API_TOKEN - for paid API features (summarize, fastgpt, enrich)

Set KAGI_CLI_PROFILE when you want every wrapped CLI call to use a named .kagi.toml profile. Environment variables are still the recommended MCP auth path because they are explicit in the MCP server config and do not depend on the server process working directory.

Build

cargo build --release

Run

KAGI_CLI_PATH=/path/to/kagi \
KAGI_SESSION_TOKEN=... \
KAGI_API_TOKEN=... \
./target/release/kagi-mcp

Optional environment variables:

Claude Desktop

{
  "mcpServers": {
    "kagi": {
      "command": "/path/to/kagi-mcp/target/release/kagi-mcp",
      "env": {
        "KAGI_CLI_PATH": "/path/to/kagi",
        "KAGI_SESSION_TOKEN": "your-session-token",
        "KAGI_API_TOKEN": "your-api-token"
      }
    }
  }
}

Tools

Search

Quick Answer

Assistant

Translate

Summarize

News

Enrichment

Other

Scope Boundaries

kagi_watch and kagi_notify are not exposed by this server. watch is a long-running polling workflow, which does not fit well inside a request/response MCP tool. notify posts to external webhooks, so keeping it as an explicit CLI command avoids surprising agent-triggered side effects.

The account-settings management commands for lenses, custom bangs, redirects, and custom assistants remain available through the wrapped kagi CLI. This server focuses on safe request/response tools plus local-state inspection and preferences.

Auth Model

Architecture

MCP Client (Claude, Zed, etc.)
       | stdio
       v
+-----------------+     spawn      +-----------+
|   kagi-mcp      |--------------->|  kagi CLI |
|   rmcp + tokio  |                |           |
+-----------------+                +-----------+

The server is a single Rust binary that spawns kagi CLI subprocesses for each tool call. JSON output is parsed and forwarded to the MCP client. Text output is passed through as-is.

Error handling: CLI subprocess failures, non-zero exits, timeouts, and invalid JSON are returned as MCP error results. Timeouts are configurable via KAGI_MCP_TIMEOUT_MS.

Test

cargo test
cargo clippy --all-targets --all-features -- -D warnings

The test suite uses fixture scripts as local kagi binaries to verify argument building, JSON parsing, stdin handling, profile passthrough, and error surfacing without requiring a real Kagi connection.

License

MIT