NewYour Exa or Tako SDK, up to 5× cheaper.

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

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

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

    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

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.

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

Give your agent the news.

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