MCP server
The news search MCP server.
Give Claude, Cursor, VS Code or any MCP client real-time news from our own index: four tools, results compact enough for an agent’s context, and the same prices as the API.
Remote · Streamable HTTP · https://api.typesearch.ai/mcp
Install it in your client
You need a typesearch API key: new accounts get $5 in free credit. Every option below reads it from TYPESEARCH_API_KEY or asks for it once; none of them puts it in this page.
Cursor
One click. Cursor reads your key from the TYPESEARCH_API_KEY environment variable; or paste it in mcp.json in place of ${env:TYPESEARCH_API_KEY}.
VS Code
One click. VS Code asks for your key once and keeps it as a secret.
Claude Code
One command, with TYPESEARCH_API_KEY set in your shell.
terminalclaude mcp add --transport http typesearch https://api.typesearch.ai/mcp --header "Authorization: Bearer $TYPESEARCH_API_KEY"Codex
Codex reads the key from TYPESEARCH_API_KEY on every call.
terminalcodex mcp add typesearch --url https://api.typesearch.ai/mcp --bearer-token-env-var TYPESEARCH_API_KEYClaude Desktop
Add it to claude_desktop_config.json (Settings → Developer → Edit config), with your key, and restart Claude. This connects to the remote server through mcp-remote.
claude_desktop_config.json{"mcpServers": {"typesearch": {"command": "npx","args": ["-y","mcp-remote","https://api.typesearch.ai/mcp","--header","Authorization:${TYPESEARCH_AUTH}"],"env": {"TYPESEARCH_AUTH": "Bearer YOUR_API_KEY"}}}}Windsurf
Add it to mcp_config.json. Windsurf reads your key from TYPESEARCH_API_KEY.
mcp_config.json{"mcpServers": {"typesearch": {"serverUrl": "https://api.typesearch.ai/mcp","headers": {"Authorization": "Bearer ${env:TYPESEARCH_API_KEY}"}}}}Clients that only take a URL
Put your key in the query string. We strip it from our logs and error messages.
URLhttps://api.typesearch.ai/mcp?typesearchApiKey=YOUR_API_KEY
Four tools, named for what they do
Read-only, with titles and descriptions written so a model picks the right one. Results are compact: the fields an agent cites, and nothing empty.
search_news
Search the news
Ranked articles about a query, with a calibrated relevance score on each one.
- Parameters
- query · mode (ultra, fast, normal, deep; fast by default) · max_results (1–25) · days · published_after · published_before · include_domains · exclude_domains · countries (ISO 3166-1) · languages (ISO 639-1)
- Returns
- Title, URL, source, publication time, country and language, and a short excerpt per result
$1.40 per 1,000 in fast, $2.20 in normal, $5.60 in deep
get_contents
Read pages
Metadata and short verbatim excerpts of up to 10 URLs. With a query, the excerpts about it.
- Parameters
- urls (1–10) · query
- Returns
- Title, source, date and excerpts per page, each with its own status
$0.20 per 1,000 pages; $0.40 with a query
find_similar
Follow a story
Everything in the index about the same story as a URL, and who published it first.
- Parameters
- url · max_results · days
- Returns
- Articles about the same story, ranked, with source and time
$2.20 per 1,000 requests
check_coverage
Check coverage
Whether a domain is in the index, or how many sources we cover by country and language.
- Parameters
- domain (optional)
- Returns
- Covered or not, with the source’s country and languages; or the totals
Free
What it looks like in a conversation
The model decides when to search, how far back and how deep. The result is short enough to leave room for the answer.
What changed with Chile’s lithium royalty bill this week? Cite sources.
search_news({ "query": "Chile lithium royalty bill", "days": 7, "max_results": 5 })
1. Chile’s Senate advances the lithium royalty bill Example Wire · Sep 24, 18:05 UTC · score 0.96 https://wire.example/business/chile-lithium-royalty-bill 2. Regalías al litio: qué cambia para las mineras Diario Ejemplo · Sep 24, 13:40 UTC · score 0.91 https://diarioejemplo.example/economia/regalias-litio
Chile’s Senate advanced the bill on September 24, with a sliding royalty on lithium sales (Example Wire). Diario Ejemplo explains what it changes for mining companies. Both links are above.
Same key, same prices as the API.
Each tool call is billed like the request it makes: a search by its mode, contents per page, coverage for free. Cached repeats within 10 minutes cost nothing.
Every new account gets $5 in free credit, valid for 30 days: about 3,571 fast searches.
- ultraHeadlines only. For classifying at volume.$1.40/ 1k searches
- fastHeadlines and standfirsts. The default for agents in a loop.$1.40/ 1k searches
- normalReads the top 4 results before ranking them.$2.20/ 1k searches
- deepWidens the topic, reads 8, adds highlights and essentials.$5.60/ 1k searches
MCP questions
What is an MCP server?
The Model Context Protocol is the standard way for AI apps — Claude, Cursor, VS Code, Codex and others — to call external tools. Our MCP server exposes news search as tools the model can call by itself when a question needs recent news.
Do I need an API key?
Yes, the same key as the API. New accounts get $5 in free credit, valid for 30 days, with no card needed.
Does it cost more than calling the API?
No. Each tool call costs the same as the request it makes: $1.40 per 1,000 fast searches, which is the default mode. Checking coverage is free.
Which transport does it use?
Streamable HTTP, stateless, at https://api.typesearch.ai/mcp. The key goes in an Authorization: Bearer header or x-api-key; clients that only take a URL can pass typesearchApiKey in the query string.
Keep exploring
Give your agent the news.
Get a key with $5 in free credit and add the server in one click.