Log inSubmit server
Kagimcp logo

Kagimcp

by kagisearch

Searches Kagi’s web indexes and extracts full web pages as Markdown through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget

Install Kagimcp

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "kagisearch-kagimcp": {
      "command": "uvx",
      "args": [
        "kagimcp"
      ],
      "env": {
        "KAGI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 2 tools correctly (1mo ago).

Overview

Searches the web and extracts page content through the kagisearch/kagimcp MCP server, using Kagi’s API. It exposes search across web, news, videos, podcasts, and images, plus a separate page-to-Markdown extraction tool. Run it locally with uvx or connect an MCP client to Kagi’s hosted HTTP endpoint. Reach for it when an agent needs current search results, filtered discovery, or the full contents of a referenced web page.

Use cases

  • Search current web, news, video, podcast, and image results
  • Extract a web page into Markdown for detailed reading
  • Filter searches by domains, dates, file type, or Kagi lens
  • Let users refer to numbered search results in follow-up prompts

Key features

  • Kagi web, news, video, podcast, and image search
  • Full-page Markdown extraction
  • Optional search filters, extracts, and Kagi lenses
  • Local stdio and hosted or self-hosted HTTP modes
  • Configurable timeouts, retries, and hidden search parameters

Tools2

What Kagimcp lets your agent do. Expand a tool for its parameters.

Verified live~960 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

21/21 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · kagimcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars548Stargazers on the source repository.
Last commit1d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed2Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Kagimcp works

What kagisearch/kagimcp MCP server does

The kagisearch/kagimcp MCP server gives MCP-compatible clients access to two Kagi API operations: web search and page extraction. Search results can cover web, news, videos, podcasts, and images. The search tool also supports optional page extracts, search filters, Kagi lenses, and numbered results that users can reference in later instructions.

The extraction tool retrieves the full content of a web page and returns it as Markdown. This is useful when a search result or user-provided URL needs to be read in detail rather than summarized from snippets.

The project no longer exposes the earlier kagi_fastgpt or kagi_summarizer tools.

How it works

Local deployments communicate with an MCP client over stdio. The recommended package runner is uvx, which starts the published kagimcp package. Requests use the Kagi API and require a Kagi API key supplied through KAGI_API_KEY.

The project also provides a hosted MCP endpoint at https://mcp.kagi.com/mcp. HTTP-capable clients can connect to that endpoint and send the key as a Bearer token in the Authorization header. OAuth2 is not supported at present. For self-hosting, the server can run in streamable HTTP mode, and its HTTP mode accepts a Bearer key per request rather than relying on one server-wide key.

Setup and configuration

For a local client configuration, install uv and run uvx kagimcp with KAGI_API_KEY in the environment. Claude Desktop configuration uses a local command with uvx and the package name as its argument. The repository also documents setup for Codex CLI, Claude Code, Kiro, OpenCode, and Smithery.

KAGI_API_KEY is required. Optional settings include FASTMCP_LOG_LEVEL, search and extraction timeouts, KAGI_MAX_RETRIES, and KAGI_HIDDEN_PARAMS. The hidden-parameter setting can remove selected search controls from the schema shown to the language model, including domain filters, date ranges, file type, result limits, and lens selection.

Tools and capabilities

  • kagi_search_fetch: Runs Kagi searches across web, news, videos, podcasts, and images. It supports optional extracts, filters, lenses, and numbered results.
  • kagi_extract: Fetches a web page’s full content as Markdown.

The kagisearch/kagimcp MCP server can run over local stdio or streamable HTTP. A Dockerfile is included for HTTP deployment, and the container respects the PORT environment variable used by several hosting platforms.

Limitations and notes

A Kagi API key is needed for local use and hosted requests. The hosted endpoint does not currently support OAuth2. Search and extraction have separate timeout settings, and retries can be disabled by setting KAGI_MAX_RETRIES to 0.

The kagisearch/kagimcp MCP server is focused on Kagi search and extraction. It does not currently include the removed FastGPT or summarizer tools. The repository documents a pinned prerelease installation form when a specific prerelease version is required.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Kagimcp

Install uv, then run `uvx kagimcp` with the `KAGI_API_KEY` environment variable configured.

Yes. Add a Claude Desktop MCP entry using the `uvx` command, the `kagimcp` package, and `KAGI_API_KEY` in the environment.

It provides `kagi_search_fetch` for Kagi searches and `kagi_extract` for retrieving a page’s full content as Markdown.

No. The hosted server currently requires a Kagi API key passed through Bearer HTTP authentication.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKagimcp AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/kagisearch-kagimcp?style=directory)](https://allmcps.com/mcp/kagisearch-kagimcp)
HTML Embed
<a href="https://allmcps.com/mcp/kagisearch-kagimcp"><img src="https://allmcps.com/api/badge/kagisearch-kagimcp?style=directory" alt="Kagimcp on AllMCPs" /></a>