kagi-shinobi

A Cloudflare Worker exposing Kagi search, FastGPT, Summarizer, and Extract as an MCP server.

Endpoints

• POST /mcp — Streamable-HTTP MCP endpoint bearer required
• POST /search — REST search bearer required
• POST /summarize — REST summarizer bearer required
• GET /health — liveness public, token status bearer required
• GET / — this page public

Add to your MCP client

{
  "mcpServers": {
    "kagi-shinobi": {
      "url": "https://kagi-shinobi.5150.workers.dev/mcp",
      "headers": { "Authorization": "Bearer <YOUR_ADMIN_TOKEN>" }
    }
  }
}

Modes

Set KAGI_MODE (default: scrape) to one of:

• scrape — uses a Kagi session cookie only. Free features from the paid tier are unavailable.
• api — uses api.kagi.com with Authorization: Bot <KAGI_API_KEY>. Every call bills at Kagi's published rate.
• hybrid — scrape for anything the scraper can do; API for the rest.
• auto — picks scrape / api / hybrid based on which secrets are set.

Cost guard

API calls are metered against MAX_API_CENTS_PER_MONTH (default 0 — every API call refuses until you raise the cap).

Source

github.com/Rick7C2/kagi-shinobi