Servidor MCP

Búsqueda de noticias en tiempo real para Claude, Cursor, VS Code, Codex y cualquier cliente MCP, con la misma key y los mismos precios que la API.

El servidor MCP de typesearch le da a cualquier cliente del Model Context Protocol cuatro herramientas de sólo lectura para buscar noticias. Es remoto —no hay nada que instalar— y usa tu API key y los precios de la API.


URL	`https://api.typesearch.ai/mcp`
Transporte	Streamable HTTP, sin estado
Autenticación	`Authorization: Bearer <key>` o `x-api-key: <key>`. Clientes que sólo aceptan una URL: `?typesearchApiKey=<key>`
Nombre del servidor	`typesearch`

La key nunca queda registrada: la borramos de nuestros registros y de los mensajes de error, también cuando llega en la URL.

Instalar

Los ejemplos leen tu key de TYPESEARCH_API_KEY, o te la piden. Reemplaza YOUR_API_KEY donde un cliente necesita tenerla escrita en su configuración.

Cursor

Add to Cursor. Cursor lee la key de la variable de entorno TYPESEARCH_API_KEY. Para agregarlo a mano, pon esto en ~/.cursor/mcp.json (o en el .cursor/mcp.json de tu proyecto):

mcp.json

{
  "mcpServers": {
    "typesearch": {
      "url": "https://api.typesearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TYPESEARCH_API_KEY}"
      }
    }
  }
}

VS Code

Add to VS Code. VS Code te pide la key una vez y la guarda como secreto. A mano, en .vscode/mcp.json:

.vscode/mcp.json

{
  "servers": {
    "typesearch": {
      "type": "http",
      "url": "https://api.typesearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:typesearch-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "typesearch-api-key",
      "description": "typesearch API key",
      "password": true
    }
  ]
}

Claude Code

claude mcp add --transport http typesearch https://api.typesearch.ai/mcp --header "Authorization: Bearer $TYPESEARCH_API_KEY"

Agrega --scope user para tenerlo en todos tus proyectos.

Codex

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

Claude Desktop

Abre Ajustes → Desarrollador → Editar configuración, agrega el servidor a claude_desktop_config.json con tu key y reinicia Claude.

Claude Desktop arranca servidores locales desde este archivo, así que llega al remoto con 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

Agrégalo a mcp_config.json. Windsurf lee la key de TYPESEARCH_API_KEY:

mcp_config.json

{
  "mcpServers": {
    "typesearch": {
      "serverUrl": "https://api.typesearch.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:TYPESEARCH_API_KEY}"
      }
    }
  }
}

Otros clientes

Cualquier cliente que hable Streamable HTTP funciona con la URL y uno de los encabezados de arriba. Si sólo acepta una URL, pon la key en ella:

https://api.typesearch.ai/mcp?typesearchApiKey=YOUR_API_KEY

Herramientas

Las cuatro son de sólo lectura. Sus resultados son compactos —los campos que un agente cita, y nada vacío—, así dejan lugar en el contexto para la respuesta.

search_news

Busca en el índice de noticias. Devuelve notas ordenadas con título, URL, fuente, hora de publicación, un fragmento breve y una puntuación de relevancia calibrada.

Parámetro
`query`	obligatorio	Lo que buscas, en cualquier idioma.
`mode`	`fast`	`ultra`, `fast`, `normal` o `deep`: cuánto se lee antes de ordenar. Mira Modos.
`max_results`	`10`	De 1 a 25.
`days`	`7`	Sólo los últimos N días, de 1 a 365. Los 7 por defecto no se aplican si das `published_after` o `published_before`.
`published_after`, `published_before`		Fechas ISO (`2026-09-25`) o fechas con hora y su zona (`2026-09-25T14:00:00Z`).
`include_domains`, `exclude_domains`		Listas de dominios.
`countries`, `languages`		Sólo medios de estos países (ISO 3166-1 alfa-2, p. ej. `AR`) o que publican en estos idiomas (ISO 639-1, p. ej. `es`).

get_contents

Metadatos y fragmentos textuales breves de hasta 10 URLs. Con query, el modelo elige los fragmentos que tratan de ella.

Parámetro
`urls`	obligatorio	De 1 a 10 URLs.
`query`		Los fragmentos se eligen para ella.

find_similar

Todo lo del índice sobre la misma noticia que una URL, ordenado, y quién la publicó primero.

Parámetro
`url`	obligatorio	La nota de la que se parte.
`max_results`	`10`	De 1 a 25.
`days`	`7`	Sólo los últimos N días, de 1 a 365.

check_coverage

Si un dominio está en el índice, con su país y sus idiomas; sin domain, cuántas fuentes cubrimos por país e idioma. No publicamos la lista de fuentes.

Parámetro
`domain`		Como `example.com`.

Precios

Cada llamada a una herramienta se cobra como el pedido a la API que hace:

Herramienta	Precio
`search_news`	$1,40 cada 1.000 en `ultra` y `fast` · $2,20 en `normal` · $5,60 en `deep`
`get_contents`	$0,20 cada 1.000 páginas · $0,40 con `query`
`find_similar`	$2,20 cada 1.000 pedidos
`check_coverage`	Gratis

Las llamadas idénticas dentro de 10 minutos salen de la caché y no cuestan nada. Cada llamada cuenta para los límites de tu key.

Errores

Un problema vuelve como un error de la herramienta, con un mensaje que el modelo puede leer y resolver: una key que falta o no vale, el crédito agotado o un límite que hay que esperar. Las mismas condiciones que los errores de la API.

Servidor MCP

En esta página