ContextFetch

npx add-mcp 'https://api.contextfetch.dev/mcp'

ContextFetch MCP server

Web search and clean, LLM-ready Markdown for AI agents: $1 per 1,000 searches, and 25 a day free with no key and no signup.

claude mcp add contextfetch -- npx -y @contextfetch/mcp

That is the whole setup for Claude Code. Then ask your agent something that needs the web:

Search for how Postgres SKIP LOCKED works for job queues

contextfetch_search returns each page as Markdown, cut down to the passages that answer the query:

## 1. PostgreSQL Job Queues with SKIP LOCKED | CodeNotes

https://codenotes.tech/blog/postgresql-job-queues-with-skip-locked · score 1.000

FOR UPDATE SKIP LOCKED is useful because it lets many workers claim different rows without blocking on rows
another worker has already locked. But it is only the claiming primitive. A production queue also needs the
right schema, indexes, retry policy, stuck-job recovery, cleanup, monitoring, and replay-safe handlers.
...

11 tools: search, page to Markdown, find similar, research, answer, crawl, site map, balance, free key and auto top-up. Exa- and Tavily-compatible API underneath, at contextfetch.dev.

Install

Claude Code (one line, keyless):

claude mcp add contextfetch -- npx -y @contextfetch/mcp

With a paid key:

claude mcp add contextfetch -e CONTEXTFETCH_API_KEY=your_key -- npx -y @contextfetch/mcp

Cursor: add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "contextfetch": {
      "command": "npx",
      "args": ["-y", "@contextfetch/mcp"],
      "env": { "CONTEXTFETCH_API_KEY": "your_key" }
    }
  }
}

Windsurf: add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "contextfetch": {
      "command": "npx",
      "args": ["-y", "@contextfetch/mcp"],
      "env": { "CONTEXTFETCH_API_KEY": "your_key" }
    }
  }
}

To use the free tier, drop the env block (or leave CONTEXTFETCH_API_KEY empty). The same JSON works in Claude Desktop's claude_desktop_config.json and in any other MCP client that launches stdio servers.

Requires Node.js 18 or newer.

Tools

Tool	Arguments	What it does	Cost
contextfetch_search	query, num_results (1-25, default 5), include_domains?, exclude_domains?	Web search. Each result comes back as title, URL and only the passages relevant to your query (cross-encoder pruned Markdown).	$1 per 1,000
contextfetch_extract_url	url, query?	Any public page (docs, articles, GitHub files, arXiv) as clean Markdown with tables kept. With query, returns only the relevant passages.	$1 per 1,000
contextfetch_find_similar	url, num_results (1-25, default 5)	Pages similar to a URL, excluding its own domain.	$1 per 1,000
contextfetch_research	query, sub_queries? (up to 5), num_results_per_query (1-10, default 5)	Server-side research: runs the sub-queries concurrently, dedupes pages by URL, ranks them all against query with the cross-encoder and returns one Markdown evidence pack (numbered [n] sources with their query-pruned passages, quoted verbatim; nothing generated), headed by the sub-queries, source count, tokens and credits used.	$1 per 1,000 sub-queries (max 5)
contextfetch_deep_research	query, sub_queries? (up to 3), num_results_per_query (1-25, default 5; at most 10 used)	The earlier name of contextfetch_research, kept for existing setups: same server-side evidence pack, up to 3 sub-queries.	$1 per 1,000 sub-queries (max 3)
contextfetch_answer	query, num_results (1-10, default 5)	Extractive answer: the best-scoring passages of the top pages, quoted verbatim with [n] markers and a numbered source list. No text is generated, so it suits factual lookups more than open-ended questions.	$1 per 1,000
contextfetch_crawl	url, max_depth (0-3, default 1), limit (1-50, default 10), query?, include_paths?, exclude_paths? (regexes on the URL path)	Crawls one site from url (same-site links, robots.txt obeyed) and returns each page as Markdown with its depth. With query, pages are ranked by relevance and pruned to the relevant passages.	$1 per 1,000 pages
contextfetch_map	url, limit (1-5,000, default 100), include_paths?, exclude_paths?	Lists a site's URLs from its sitemaps and the start page's links without fetching the pages.	$1 per 1,000
contextfetch_balance	none	Remaining credits, burn rate (credits/day over the last 7 days) and auto-reload settings, including the last auto-reload error if a payment failed. Needs CONTEXTFETCH_API_KEY.	free
contextfetch_get_free_key	none	Claims the network's free API key (2,500 searches, one per network) and uses it for the rest of the session. Give it to your user to keep in CONTEXTFETCH_API_KEY.	free
contextfetch_auto_reload	enabled, threshold? (100-100,000), pack? (instant, builder, scale), monthly_max_usd? (max 500)	Turns auto-reload on or off or changes it: when credits drop below threshold, the card saved at checkout buys pack again, up to the monthly cap. Needs CONTEXTFETCH_API_KEY and a saved card. The cap cannot go above $500 here.	free

All tools return Markdown text. Without a key, contextfetch_balance and contextfetch_auto_reload return a short message saying they need one, with the buy link. On the free tier, results start with a one-line notice showing how many free searches are left today. When the API reports them, a closing line shows latency (total and per stage: recall, fetch, rerank), whether the answer came from cache, and token savings (pruned tokens vs raw page tokens).

contextfetch_research sub-queries

Pass your own sub_queries (different angles on the question); the tool description tells the calling model to do so. If you omit them, the API derives them from query with fixed rules:

1. the query itself;
2. the query + documentation;
3. the query + benchmark when it mentions speed, performance, latency, memory or a comparison (vs, compare), otherwise the query + example.

A suffix the query already contains is skipped (so react useActionState example runs 2 searches, not 3). The whole research runs server-side in one /v1/research call that costs $1 per 1,000 sub-queries; a sub-query that fails is refunded and named in the header. If all fail, the tool returns the error.

Environment variables

Variable	Default	Meaning
CONTEXTFETCH_API_KEY	unset	Your API key. Unset or empty uses the free keyless tier.
CONTEXTFETCH_API_BASE	https://api.contextfetch.dev	API base URL. Point it at your own engine if you self-host.

Free tier and pricing

	Price
No key	25 searches a day per network, no signup
Free key (contextfetch_get_free_key)	2,500 searches, one per network, no card
Search, page to Markdown, answer, find similar, map	$1 per 1,000
Crawl	$1 per 1,000 pages returned
Research	$1 per 1,000 sub-queries

Pay as you go: top up from $10 (+10% from $100, +20% from $500). The balance never expires and one balance covers all your keys. Monthly plans and per-key limits are in the dashboard at contextfetch.dev/account.

When the balance or the free tier runs out (HTTP 402), the tool returns a one-click top-up link (Stripe: card, Apple Pay, Google Pay) and a line to pass on to your user. Then set CONTEXTFETCH_API_KEY as shown above.

Retries and connections

Connection failures before the request is sent (refused, DNS, connect timeout), HTTP 429 and HTTP 5xx are retried with exponential backoff and jitter (about 0.25-0.5 s, then 0.5-1 s), at most 3 attempts per API call and 30 seconds in total, retries included. A 429 or 5xx with a Retry-After header waits exactly that long, unless that would pass the 30 second budget. 400, 401, 402, 422 and other 4xx responses are never retried. A connection that drops after the request was sent is not retried either, since the search may already have been billed. Connections are pooled and kept alive by Node's built-in fetch (undici), so there is no extra HTTP dependency.

Errors

Errors never crash the server; they come back as tool results with isError: true and a plain explanation: invalid key (401), out of credits or free limit reached (402, lists the packs with their buy links), no saved card for auto-reload (409, with the buy link), URL not allowed (400, only public http(s) URLs), a page contextfetch_extract_url could not fetch (with the reason, such as HTTP 404), rate limited (429), server errors (5xx), network failures, and a 30 second limit per call (retries included).

Develop

npm install
npm run build          # compiles src/ to dist/ and marks dist/index.js executable
npm test               # builds, then drives dist/index.js over stdio against a local mock API (no network)
CONTEXTFETCH_API_BASE=http://localhost:8000 node dist/index.js

Publish

Publishing @contextfetch/mcp needs the npm organization contextfetch (create it at npmjs.com and add the publishing account as a member). Then npm publish from this folder; publishConfig.access is already public and prepublishOnly builds first.

License

MIT