Servidor MCP

El servidor MCP de typesearch le da a cualquier cliente del Model Context Protocol cuatro herramientas: tres de sólo lectura para buscar noticias, y una que arma tarjetas de gráficos. Es remoto (no hay nada que instalar) y usa tu API key y los precios de la API.

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):

{
  "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:

{
  "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:

{
  "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:

{
  "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

search_news, get_contents y find_similar son de sólo lectura. create_chart guarda la tarjeta que arma, así su imagen y su embed se pueden abrir después. Los 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 o, con index, en tu índice propio. Devuelve notas ordenadas con título, URL, fuente, hora de publicación, un fragmento breve y una puntuación de relevancia calibrada.

get_contents

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

find_similar

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

create_chart

Una tarjeta de gráfico desde una pregunta con tus palabras: las posiciones de la última carrera, la intención de voto o el resultado de una elección por candidato, las victorias de una temporada, lo que publicó un medio, la cobertura en el tiempo, la cuota de voz entre nombres, el tono, los medios que más cubren un tema, la cronología de una historia, las cifras que publican las notas (un precio, una tasa) o los datos de tu índice propio. Entiende qué espera ver el usuario, comprueba cada valor contra su fuente, elige el gráfico, las cifras clave y un título que cuenta el hallazgo, y devuelve una imagen para que el agente la muestre y un embed. Si el dato exacto no está publicado, muestra lo más cercano y lo dice. Mira Gráficos.

Devuelve el title (cuenta el hallazgo), el subtitle, image_url (una PNG para mostrarle al usuario), embed_url (un iframe para una página o una app), key_figures (cada una con su change), los valores dibujados en data (hasta 40 por serie), las filas de una tabla en table (hasta 10), events para una cronología, sources y cost_usd. Desde una consulta con palabras también devuelve lo que entendió en understood, las otras lecturas en alternatives y rung: exact para el dato pedido, o partial, related, coverage o stories para lo más cercano que encontró. improving: true quiere decir que la imagen y el embed se van a actualizar solos cuando llegue el dato exacto. La misma llamada dentro de 10 minutos vuelve con cached: true y no cuesta nada.

Cada resultado muestra su fuente y enlaza al original; no publicamos la lista de fuentes. ¿Te falta un medio? Sugiérelo desde el panel (Sugerir una fuente) o escríbenos a support@typesearch.ai.

Precios

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

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, un límite que hay que esperar o ninguna nota sobre el tema de un gráfico (no se cobra). Las mismas condiciones que los errores de la API.