kagi-mcp
The kagi-mcp server integrates Kagi's search capabilities into MCP-compatible agents using your Kagi account session token. It offers:
Web Search (
kagi_search): Perform high-quality, ad-free web searches with advanced query operators (exact phrases" ", site-specificsite:, exclusions-,OR), date filtering (from_date,to_date), region locking (2-letter country codes), and lens scoping. Supports pagination (page) and result limiting (1-50). Returns titles, URLs, dates, and snippets.News Search (
kagi_news): Search for recent news articles, returning headlines, sources, publication times, and snippets. Ideal for current events, with optional result limit (1-50).List Lenses (
kagi_lenses): Retrieve a list of all curated search scopes (lenses) available on your account, such as Forums, Academic, Programming, PDFs, etc., including their names and IDs for use withkagi_search.
Additionally, the server automatically handles session token authentication, error detection (e.g., expired tokens), and provides robust error reporting.
Provides web search and news search tools using Kagi Search with your existing Kagi account via session token authentication. Supports search operators, region filtering, lenses, and returns compact plain text results.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@kagi-mcp search the web for best practices in prompt engineering"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
kagi-mcp
English | 简体中文
MCP server for Kagi Search that authenticates with your session token —
no separate API subscription needed, it uses your existing Kagi plan via Kagi's lightweight
HTML interface (kagi.com/html/search).
Tools
Tool | Purpose | Parameters |
| Web search |
|
| News search |
|
| List available lenses | — |
region: 2-letter country code (us,cn,jp, ...); maps to Kagi'sr=parameter. Defaults tono_region(international/location-neutral) so the AI agent decides when a country-specific view is needed.lens: a Kagi lens by name or numeric id (e.g.Forums,Fediverse Forums,Academic,Programming,PDFs). Names are resolved against the lens list on your account (cached per server process — restart the server after creating new lenses).
Queries support Kagi operators: "exact phrase", site:example.com, -exclude, OR.
Output is compact plain text (title, URL, date, snippet, related searches). By default a
call returns the full first results page — the same set a user sees on kagi.com
(typically 20-40 results); pass limit to trim it. Snippets are Kagi's own SERP snippets;
fetching full page content is left to the agent's page-fetch tool.
Related MCP server: Kagi MCP Server
1. Get your session token
Find the Session Link section and copy the link.
Use either the full link (
https://kagi.com/search?token=...) or just the token part — both work asKAGI_SESSION_TOKEN.
Treat the session link like a password — anyone with it can use your Kagi account. If it leaks, generate a new one from the same settings page (this invalidates the old one).
2. Add it to your AI agent
All examples run the published npm package via npx — nothing to install up front
(requires Node.js 18+; latest LTS recommended).
Claude Code
claude mcp add kagi -s user --env KAGI_SESSION_TOKEN=<token> -- npx -y kagi-mcp-claude-fable-5(-s user makes the server available in all your projects; omit it for project-local.)
Codex CLI
codex mcp add kagi --env KAGI_SESSION_TOKEN=<token> -- npx -y kagi-mcp-claude-fable-5Or add a table to ~/.codex/config.toml directly:
[mcp_servers.kagi]
command = "npx"
args = ["-y", "kagi-mcp-claude-fable-5"]
env = { "KAGI_SESSION_TOKEN" = "<token or session link>" }(On Windows, if the server fails to spawn, set command to the full path of
npx.cmd, e.g. 'C:\Program Files\nodejs\npx.cmd'.)
OpenClaw
openclaw mcp add kagi \
--command npx \
--arg -y \
--arg kagi-mcp-claude-fable-5 \
--env KAGI_SESSION_TOKEN=<token>Verify with openclaw mcp doctor kagi --probe.
Hermes Agent
Add to ~/.hermes/config.yaml under mcp_servers:
mcp_servers:
kagi:
command: "npx"
args: ["-y", "kagi-mcp-claude-fable-5"]
env:
KAGI_SESSION_TOKEN: "<token or session link>"Any MCP client (Claude Desktop, ...) — JSON config
{
"mcpServers": {
"kagi": {
"command": "npx",
"args": ["-y", "kagi-mcp-claude-fable-5"],
"env": { "KAGI_SESSION_TOKEN": "<token or session link>" }
}
}
}Development
git clone https://github.com/real-jiakai/kagi-mcp-claude-fable-5.git kagi-mcp
cd kagi-mcp
npm install # TypeScript build to dist/ runs automatically
# smoke test against your real Kagi account (append `news` for the news vertical)
KAGI_SESSION_TOKEN='<token or session link>' node test.js "capital of japan"To point a client at your checkout instead of npm, use
node /path/to/kagi-mcp/dist/index.js as the command; re-run npm run build
after editing src/.
Notes
Auth failures: if the token is invalid/expired, Kagi 302-redirects to its landing page; the server detects this and returns a clear error telling you to refresh the token.
Parsing: results are extracted via Kagi's own machine-readable markers (
._0_SRI,a._0_URL,._0_TITLE,._0_DESC), which are stable across the web and news verticals (verified July 2026). If Kagi ever changes its markup, updateparseResultsPage()insrc/kagi.ts.This uses your normal Kagi account the same way a browser would — standard fair-use search volume from an agent is indistinguishable from regular usage. It is not the official Kagi Search API (which bills separately).
Acknowledgements
Designed, implemented, and tested end-to-end with Claude Fable 5 via Claude Code — including live analysis of Kagi's HTML interface, an adversarial multi-agent code review, and human-click vs. MCP parity testing in the browser.
Available Tools
3 toolskagi_lensesList Kagi lensesA
List the Kagi lenses (curated search scopes such as Forums, Academic, Programming) available on this account, with their ids. Pass a lens name or id to kagi_search's lens parameter.
Inputs: no named parameters.
kagi_newsKagi news searchA
Search recent news with Kagi. Returns headlines with source, publication time and snippets. Best for current events; use kagi_search for general web results.
Inputs: query (required), limit.
kagi_searchKagi web searchA
Search the web with Kagi (high-quality, ad-free results). Returns titles, URLs, dates and snippets. The query supports operators: "exact phrase", site:example.com, -excludeterm, OR. Use from_date/to_date to restrict by publication date, page for more results, region for country-specific results, and lens to restrict to a curated scope (forums, academic, ...).
Inputs: query (required), lens, page, limit, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: kagi_lenses lists curated search scopes, kagi_news searches recent news, and kagi_search performs general web searches. Descriptions explicitly differentiate use cases.
All tools follow a consistent kagi_<service> pattern, using clear nouns/verbs that reflect the tool's function. No deviations or mixed conventions.
Three tools is appropriate for a focused search server, covering lens listing, news search, and general search without unnecessary bloat or gaps.
The surface covers the core functionality of the Kagi search API: discovering lenses, searching news, and general web search. No obvious missing operations for the stated purpose.
Related MCP Connectors
Web search API and MCP server for developers building AI agents.
MCP server for Google search results via SERP API
Docs: https://docs.keenable.ai/mcp-server Keenable is a free, remote MCP server that gives agents access to the web index. Search the web with ranked results and date/site filters, then fetch any indexed page as clean markdown. Works out of the box with no account or API key.
Free web search for AI agents. No API key required. Hosted MCP in active development.
Related MCP Servers
- AlicenseAqualityDmaintenanceUnofficial MCP server for working with Kagi without API access (you'll need to be a customer, tho). Searches and summarizes. Uses Kagi session token for easy authentication.242MIT
- AlicenseNot gradedqualityDmaintenanceEnables integration with Kagi search engine services including web search, content summarization from URLs, and AI assistant conversations. Uses session tokens to access Kagi's search API, summarizer, and AI models directly within MCP-compatible applications.14 npm3MIT
- AlicenseAqualityDmaintenanceProvides free web search and URL summarization using Kagi session tokens, compatible with any MCP client.244MIT
- AlicenseNot gradedqualityDmaintenanceFree web search MCP server using SearXNG, supporting web search, news search, and search summaries.MIT