Servidor MCP
El servidor MCP para buscar noticias.
Dale a Claude, Cursor, VS Code o cualquier cliente MCP noticias en tiempo real de nuestro propio índice, y gráficos armados con ellas: cuatro herramientas, resultados compactos para el contexto de un agente y los mismos precios que la API.
Remoto · Streamable HTTP · https://api.typesearch.ai/mcp
Instálalo en tu cliente
Necesitas una API key de typesearch: las cuentas nuevas reciben $5 de crédito gratis. Todas las opciones la leen de TYPESEARCH_API_KEY o te la piden una vez; ninguna la pone en esta página.
Cursor
Un clic. Cursor lee tu key de la variable de entorno TYPESEARCH_API_KEY; o pégala en mcp.json en lugar de ${env:TYPESEARCH_API_KEY}.
VS Code
Un clic. VS Code te pide la key una vez y la guarda como secreto.
Claude Code
Un comando, con TYPESEARCH_API_KEY definida en tu terminal.
terminalclaude mcp add --transport http typesearch https://api.typesearch.ai/mcp --header "Authorization: Bearer $TYPESEARCH_API_KEY"Codex
Codex lee la key de TYPESEARCH_API_KEY en cada llamada.
terminalcodex mcp add typesearch --url https://api.typesearch.ai/mcp --bearer-token-env-var TYPESEARCH_API_KEYClaude Desktop
Agrégalo a claude_desktop_config.json (Ajustes → Desarrollador → Editar configuración), con tu key, y reinicia Claude. Se conecta al servidor 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 tu key de TYPESEARCH_API_KEY.
mcp_config.json{"mcpServers": {"typesearch": {"serverUrl": "https://api.typesearch.ai/mcp","headers": {"Authorization": "Bearer ${env:TYPESEARCH_API_KEY}"}}}}Clientes que sólo aceptan una URL
Pon tu key en la consulta de la URL. La borramos de nuestros registros y de los mensajes de error.
URLhttps://api.typesearch.ai/mcp?typesearchApiKey=YOUR_API_KEY
Cuatro herramientas, con el nombre de lo que hacen
Con títulos y descripciones escritos para que el modelo elija la correcta; las tres que buscan son de sólo lectura. Los resultados son compactos: los campos que un agente cita, y nada vacío.
search_news
Buscar noticias
Notas ordenadas sobre una consulta, con una puntuación de relevancia calibrada en cada una. Con index, páginas de tu propio índice.
- Parámetros
- query · index (idx_…: tu índice propio) · mode (ultra, fast, normal, deep; fast por defecto) · max_results (1–25) · days · published_after · published_before · include_domains · exclude_domains · countries (ISO 3166-1) · languages (ISO 639-1)
- Devuelve
- Título, URL, fuente, hora de publicación, país e idioma, y un fragmento breve por resultado
$1,00 cada 1.000 en ultra, $1,40 en fast, $2,20 en normal, $5,60 en deep
get_contents
Leer páginas
Metadatos y fragmentos textuales breves de hasta 10 URLs. Con una consulta, los fragmentos que tratan de ella.
- Parámetros
- urls (1–10) · query
- Devuelve
- Título, fuente, fecha y fragmentos por página, cada una con su estado
$0,20 cada 1.000 páginas; $0,40 con consulta
find_similar
Seguir una noticia
Todo lo del índice sobre la misma noticia que una URL, y quién la publicó primero.
- Parámetros
- url · max_results · days
- Devuelve
- Notas sobre la misma noticia, ordenadas, con fuente y hora
$2,20 cada 1.000 pedidos
create_chart
Hacer un gráfico
Una tarjeta con un gráfico a partir de una pregunta con tus palabras: posiciones de una carrera, encuestas, victorias de una temporada, cobertura, cuota de voz, tono, los medios que más publican, una cronología o las cifras que publican las notas. Devuelve una imagen para mostrar y un embed.
- Parámetros
- query · type (auto por defecto, o uno de 12) · theme (light, dark, editorial, electric) · days · compare (2 a 5 nombres) · countries · languages · index (idx_…: grafica tu índice propio) · interpretation (otra lectura de la consulta)
- Devuelve
- Lo que entendió, un título que dice el hallazgo, las cifras clave, los valores dibujados, las URLs de la imagen y del embed, y las fuentes
Su búsqueda, según el modo, más $0,50 cada 1.000 gráficos
Cómo se ve en una conversación
El modelo decide cuándo buscar, cuánto hacia atrás y con qué profundidad. El resultado es breve y deja lugar para la respuesta.
¿Qué cambió esta semana con el proyecto de regalías al litio en Chile? Cita las fuentes.
search_news({ "query": "regalías al litio Chile", "days": 7, "max_results": 5 })
1. Regalías al litio: qué cambia para las mineras Diario Ejemplo · 24 sep, 13:40 UTC · score 0.96 https://diarioejemplo.example/economia/regalias-litio 2. Chile’s Senate advances the lithium royalty bill Example Wire · 24 sep, 18:05 UTC · score 0.93 https://wire.example/business/chile-lithium-royalty-bill
El Senado de Chile avanzó con el proyecto el 24 de septiembre: fija una regalía escalonada sobre las ventas de litio (Diario Ejemplo, Example Wire). Diario Ejemplo explica qué cambia para las mineras. Los dos enlaces están arriba.
La misma key, los mismos precios que la API.
Cada llamada a una herramienta se cobra como el pedido que hace: una búsqueda según su modo, los contenidos por página, los similares por pedido y un gráfico como su búsqueda más $0,50 cada 1.000. Las repeticiones dentro de 10 minutos no cuestan nada.
Cada cuenta nueva recibe $5 de crédito gratis, válido por 30 días: unas 5.000 búsquedas ultra o 3.571 rápidas.
- ultraSólo titulares. Lo más barato para clasificar en volumen.$1,00/ 1.000 búsquedas
- fastTitulares y bajadas. El modo por defecto para agentes en bucle.$1,40/ 1.000 búsquedas
- normalLee los 4 mejores resultados antes de ordenarlos.$2,20/ 1.000 búsquedas
- deepAmplía el tema, lee 8 y suma fragmentos y lo esencial.$5,60/ 1.000 búsquedas
Preguntas sobre el MCP
¿Qué es un servidor MCP?
El Model Context Protocol es la forma estándar en que las apps de IA —Claude, Cursor, VS Code, Codex y otras— llaman a herramientas externas. Nuestro servidor MCP ofrece la búsqueda de noticias como herramientas que el modelo llama solo cuando una pregunta necesita noticias recientes.
¿Necesito una API key?
Sí, la misma de la API. Las cuentas nuevas reciben $5 de crédito gratis, válido por 30 días, sin tarjeta.
¿Cuesta más que llamar a la API?
No. Cada llamada a una herramienta cuesta lo mismo que el pedido que hace: $1,40 cada 1.000 búsquedas rápidas, que es el modo por defecto, o $1,00 en ultra.
¿Qué transporte usa?
Streamable HTTP, sin estado, en https://api.typesearch.ai/mcp. La key va en la cabecera Authorization: Bearer o en x-api-key; los clientes que sólo aceptan una URL pueden pasar typesearchApiKey en la consulta.
¿Puede buscar en mis propias páginas?
Sí. Crea un índice propio con tus URLs, un sitemap o un feed, y pasa su id a search_news en index (idx_…): busca en tus páginas en lugar del índice de noticias, con los mismos modos, la misma key y los mismos precios. El índice en sí cuesta $2,00 cada 1.000 URLs por mes.
¿Puede hacer gráficos?
Sí. Pídele uno con tus palabras y create_chart elige el gráfico, las cifras clave y un título que dice el hallazgo, con la fuente de cada valor. Devuelve una imagen que el modelo te puede mostrar y un embed para una página web. Cuesta su búsqueda más $0,50 cada 1.000 gráficos.
Dale las noticias a tu agente.
Obtén una key con $5 de crédito gratis y agrega el servidor en un clic.