MCP server

The news search MCP server.

Give Claude, Cursor, VS Code or any MCP client real-time news from our own index, and charts built from it: four tools, results compact enough for an agent’s context, and the same prices as the API.

Add to Cursor Add to VS Code

Remote · Streamable HTTP · https://api.typesearch.ai/mcp

Get an API key

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}.
Add to Cursor
VS Code
One click. VS Code asks for your key once and keeps it as a secret.
Add to VS Code

Claude Code

One command, with TYPESEARCH_API_KEY set in your shell.

terminal

claude 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.

terminal

codex mcp add typesearch --url https://api.typesearch.ai/mcp --bearer-token-env-var TYPESEARCH_API_KEY

Claude 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.
URL
```
https://api.typesearch.ai/mcp?typesearchApiKey=YOUR_API_KEY
```

Four tools, named for what they do

Titles and descriptions written so a model picks the right one; the three that search are read-only. 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. With index, pages from your own custom index instead.
Parameters
query · index (idx_…: your custom index) · 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.00 per 1,000 in ultra, $1.40 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
create_chart
Make a chart
A chart card from a question in plain words: race standings, poll results, wins in a season, coverage, share of voice, tone, top outlets, a timeline or the figures articles publish. It returns an image to show and an embed.
Parameters
query · type (auto by default, or one of 12) · theme (light, dark, editorial, electric) · days · compare (2–5 names) · countries · languages · index (idx_…: chart your custom index) · interpretation (another reading of the query)
Returns
What it understood, a title that states the finding, the key figures, the values drawn, the image and embed URLs, and the sources
Its search, by mode, plus $0.50 per 1,000 charts

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.

Sample

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, similar per request, and a chart as its search plus $0.50 per 1,000. Cached repeats within 10 minutes cost nothing.

Every new account gets $5 in free credit, valid for 30 days: about 5,000 ultra searches or 3,571 fast ones.

Get an API key

ultraHeadlines only. The cheapest way to classify at volume.$1.00/ 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, or $1.00 in ultra.

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.

Can it search my own pages?

Yes. Create a custom index from your URLs, a sitemap or a feed, and pass its id to search_news as index (idx_…): it searches your pages instead of the news index, with the same modes, key and prices. The index itself costs $2.00 per 1,000 URLs a month.

Can it make charts?

Yes. Ask for one in plain words and create_chart picks the chart, the key figures and a title that states the finding, with the source of every value. It returns an image the model can show you and an embed for a web page. It costs its search plus $0.50 per 1,000 charts.

Keep exploring

Give your agent the news.

Get a key with $5 in free credit and add the server in one click.

Get an API key Talk to sales

The news search MCP server.

Install it in your client

Cursor

VS Code

Claude Code

Codex

Claude Desktop

Windsurf

Clients that only take a URL

Four tools, named for what they do

Search the news

Read pages

Follow a story

Make a chart

What it looks like in a conversation

Same key, same prices as the API.

MCP questions

Give your agent the news.