How to add Kagi Search to Windsurf

Official Kagi MCP server (Python/uvx) — privacy-first web search and URL/video summarization. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 417★ · stdio · apikey · official

Windsurf config for Kagi Search

uvx kagimcp

{
  "mcpServers": {
    "kagi-search": {
      "command": "uvx",
      "args": [
        "kagimcp"
      ],
      "env": {
        "KAGI_API_KEY": "<your-kagi-api-key>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Kagi Search config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Kagi Search's tools become available to Cascade.

Before you start

The uv package manager installed (uvx is used to launch the server)
Python (installed/managed automatically by uv)
A Kagi API key generated from the Kagi API portal (Generate Key in API Management), set as KAGI_API_KEY
A Kagi account with a payment method on file — the Search API is pay-per-use, not free

What Kagi Search can do in Windsurf

kagi_search_fetch

Search web, news, videos, podcasts, and images with optional page extracts, filters, and Kagi lenses.

kagi_extract

Fetch the full content of a page formatted as clean markdown.

Security

Requires a KAGI_API_KEY tied to a paid Kagi account; keep it secret. The Search API is in closed beta, so verify your key has search access before depending on the search tool in production.

Kagi Search + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Kagi Search config there under the "mcpServers" key and restart the client.

Is Kagi Search safe to use with Windsurf?

Requires a KAGI_API_KEY tied to a paid Kagi account; keep it secret. The Search API is in closed beta, so verify your key has search access before depending on the search tool in production.

Is there a free tier for the Kagi API?

Not for search. Kagi's commercial APIs (Search, Summarizer, etc.) are pay-per-use and require a payment method; only the Small Web RSS Feed is free for non-commercial use.

Why does it use uvx instead of npx?

The server is a Python package, so it is launched with uv's uvx runner rather than Node's npx. You must install uv first.

Can it still summarize URLs and videos?

Not currently. The FastGPT and Summarizer tools were removed from the current release but are documented as planned to return in a future version.

View repo Full Kagi Search page