The Sansasyonel MCP

npx add-mcp 'https://thesansasyonel.com/api/mcp'

Guía para desarrolladores de MCP

The Sansasyonel ofrece acceso de solo lectura desde aplicaciones de inteligencia artificial a sus noticias publicadas, portadas de periódicos registrados y datos registrados de módulos financieros abiertos en este sitio. No se requiere inicio de sesión ni clave de API.

Servidor: https://thesansasyonel.com/api/mcp

Esta dirección es una página de descripción mediante GET; las llamadas MCP se realizan mediante POST a través de Streamable HTTP. GET no abre una sesión SSE.

¿Cómo conectarse?

Añada el siguiente registro al archivo indicado conservando su configuración actual. Los ejemplos de Claude y Gemini pertenecen a clientes Code/CLI; Codex utiliza TOML.

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "thesansasyonel_com": {
      "type": "http",
      "url": "https://thesansasyonel.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "thesansasyonel_com": {
      "httpUrl": "https://thesansasyonel.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "thesansasyonel_com": {
      "url": "https://thesansasyonel.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.thesansasyonel_com]
url = "https://thesansasyonel.com/api/mcp"

Herramientas disponibles

Solo se enumeran las herramientas abiertas en este sitio. Las listas de noticias y la búsqueda de activos devuelven un máximo de 50 resultados.

En el historial financiero se pueden usar 30, 90, 180, 365 o 730 días (por defecto 365).

La comparación de fondos acepta de 2 a 5 códigos distintos; el período predeterminado es 1a, otros períodos son 1g, 1h, 1a, 3a, 6a, yb, 3y y 5y.

Herramienta	Campos de entrada	Descripción
get_latest_news	limit, category	Obtiene las noticias más recientes publicadas; se puede usar un filtro de categoría opcional.
get_article	id, slug	Obtiene el texto completo, fecha, categoría e información de fuente mediante el ID numérico de URL o el slug de la noticia.
search_news	query, limit, category	Busca en títulos, descripciones y palabras clave de noticias; se puede limitar por categoría.
get_category_news	category, limit	Lista las noticias más recientes publicadas en una categoría específica.
list_categories	language	Lista las categorías principales activas con sus nombres y slugs.
search	query, limit	Devuelve resultados breves de noticias e identificadores en formato article:123 que se pueden usar para fetch.
fetch	id	Obtiene el texto completo y la información de fuente de la noticia mediante el ID de contenido obtenido del resultado de búsqueda.
search_financial_assets	query, type, limit	Busca acciones y fondos activos por código o nombre; solo lista los tipos de activos abiertos en este sitio.
get_stock_quote	symbol	Obtiene el último precio registrado, variación e información básica; no se garantiza precio en tiempo real.
get_stock_history	symbol, days	Obtiene solo cierres reales registrados; no realiza solicitudes a fuentes externas ni genera precios sintéticos.
get_fund_details	code	Obtiene la ficha del fondo, precio de la unidad, categoría, comisiones, valor de riesgo y distribución de activos disponible.
get_fund_history	code, days	Obtiene precios reales de la unidad a partir de registros diarios; no presenta el índice de rendimiento aproximado como precio.
get_fund_returns	code	Presenta los rendimientos registrados diarios, semanales, mensuales y a largo plazo en porcentaje.
compare_funds	codes, period	Compara de 2 a 5 fondos distintos con el mismo período; indica datos faltantes y diferencias de fechas.
get_market_overview	limit	Obtiene los índices abiertos y las listas de acciones de la última ronda; no se llaman secciones cerradas.
get_stock_financials	symbol	Obtiene los estados financieros registrados de la empresa con sus períodos y unidades disponibles; las series calculadas se indican por separado.
list_company_disclosures	symbol, days, limit	Lista los avisos KAP registrados de la empresa de más reciente a más antiguo.
list_fund_leaders	period, direction, category, limit	Lista los fondos ganadores/perdedores del período; el permiso del módulo para la dirección se verifica por separado.
get_fund_holdings	code, limit	Obtiene las mayores posiciones accionarias registradas del fondo; no se afirma que sea la cartera completa.
list_newspapers	query, limit	Lista nombres de periódicos, slugs y fechas de archivo primera/última disponibles; no garantiza la existencia de los días intermedios.
get_newspaper_headlines	date, limit, offset	Lista las portadas de periódicos registradas del día solicitado con enlaces de fuente e imagen; si no hay fecha, se usa Estambul hoy.
get_newspaper_front_page	newspaper, date	Obtiene la portada completa del periódico en la fecha solicitada con imagen MCP y enlaces. No realiza OCR/recorte; en fechas faltantes no pasa a otro día.

Ejemplos de llamadas

Listar herramientas:

curl -X POST 'https://thesansasyonel.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Obtener las últimas cinco noticias:

curl -X POST 'https://thesansasyonel.com/api/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_latest_news","arguments":{"limit":5}}}'

Titulares de periódicos y portadas

Si no se proporciona fecha, se usa hoy según Europe/Istanbul. Las fechas deben ser días reales en formato YYYY-MM-DD; no se aceptan días futuros. Se puede usar el nombre del periódico o su slug. Las listas diarias aceptan un máximo de 50 resultados y offset de 0 a 1000. En fechas no disponibles en el archivo no se pasa a otro día; las fechas primera/última de archivo no garantizan que cada día intermedio esté disponible.

La llamada de un solo periódico devuelve la portada completa como contenido de imagen MCP con enlaces de fuente/imagen. No se realiza OCR ni recorte de noticias. Si la imagen grande no cumple el límite de 2 MiB, se intenta con la imagen pequeña disponible; el tiempo total de lectura es de 10 segundos. Cuando no se puede adjuntar la imagen, se devuelve image_embedded: false con una advertencia descriptiva.

Titulares del día:

curl -X POST 'https://thesansasyonel.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_headlines","arguments":{}}}'

Portada de hoy del periódico Akşam:

curl -X POST 'https://thesansasyonel.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam"}}}'

Portada del periódico Akşam del 8 de noviembre de 2024:

curl -X POST 'https://thesansasyonel.com/api/mcp' -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_newspaper_front_page","arguments":{"newspaper":"Akşam","date":"2024-11-08"}}}'

2024-11-08 es un ejemplo de llamada; no se garantiza que exista archivo en esa fecha.

Habilidades del agente

Índice de descubrimiento de habilidades de este sitio: /.well-known/agent-skills/index.json. Los archivos de habilidades explican cómo usar las herramientas; este índice es una superficie de descubrimiento ofrecida por el sitio.

• Investigación de noticias — Búsqueda de noticias, obtención de texto completo y citación de fecha/fuente.
• Lectura de datos bursátiles — Lectura de datos de acciones registrados conservando la distinción de fuente y hora de datos.
• Titulares de periódicos — Verificación del nombre del periódico y la fecha solicitada, y presentación de la portada completa del archivo con su fuente.
• Comparación de fondos — Comparación de fondos con el mismo período, conservando fechas de datos y valores faltantes.

Reglas y límites

• Gratuito. No hay plan de pago ni suscripción para MCP — /pricing.md. La aplicación a la que se conecta puede tener sus propias tarifas.
• Sin autenticación. No se requiere cuenta, token ni clave de API — /auth.md.
• Atribución obligatoria. Al usar contenido de The Sansasyonel, enlace a la dirección permanente de la noticia o página de datos correspondiente.
• Datos de entrenamiento: ai-train=no — no queremos que el contenido se incluya en conjuntos de datos de entrenamiento de modelos; robots.txt. Esta preferencia no es una garantía de que todos los clientes la cumplan.
• Derechos de imagen. Las imágenes de noticias y portadas de periódicos pueden estar sujetas a derechos de autor de los titulares correspondientes. El acceso no otorga licencia de reutilización; conserve la información de fuente/licencia existente y no asuma licencias no indicadas.
• Formato de errores: Los errores de protección HTTP se devuelven como error JSON-RPC con application/json; los errores de herramientas se devuelven con MCP isError. No se utiliza RFC 9457 application/problem+json.

Guía de uso completa: /AGENTS.md.

Seguridad y límites

• 120 solicitudes/minuto por sitio + IP confiable; search y search_news juntos 60 llamadas/minuto. Las herramientas financieras tienen además un límite común de 30 llamadas/minuto; las tres herramientas de periódicos tienen un límite común de 60 llamadas/minuto; la herramienta de imagen de un solo periódico usa una cuota separada de 10 llamadas/minuto. Todas también descuentan de la cuota general. Se aplican ventanas fijas de minutos.
• En respuesta 429, espere el tiempo de Retry-After. Los encabezados X-RateLimit-Limit, Remaining y Reset indican la cuota general. Si el servicio de cuota Redis no está disponible, las herramientas devuelven 503 con Retry-After: 5.
• Límite de cuerpo 256 KiB; no se admiten batch ni identificadores de sesión MCP. Si hay Origin, debe pertenecer al mismo sitio.
• JSON malformado devuelve 400, Origin no permitido 403, cuerpo excesivo 413, identificador de sesión 404 y método HTTP no soportado 405. Los errores internos de herramientas se explican con MCP isError.
• No se presentan noticias eliminadas, borradores, con fecha futura o retiradas de este sitio. No hay herramientas para agregar/editar/eliminar contenido.

¿Cómo leer datos financieros?

Las llamadas financieras solo leen la base de datos y la caché; no realizan solicitudes a proveedores externos. Los datos tienen un retraso de 15 minutos. Los datos financieros y contenidos presentados aquí no constituyen asesoramiento de inversión. Los precios no tienen garantía de tiempo real. retrieved_at es el momento de acceso, record_updated_at es el momento de actualización del registro, data_date es la fecha real de los datos si existe; no son intercambiables. No se estiman fuentes ni tiempos desconocidos. Los números faltantes permanecen como null; las advertencias se transmiten junto con el resultado.

El historial de precios contiene solo registros reales. No se presentan índices de rendimiento aproximados, precios rellenados para días vacíos ni precios sintéticos de hoy. En la comparación de fondos, considere las diferentes fechas de datos; los rendimientos pasados no garantizan rendimientos futuros. Al transmitir contenido y datos, conserve el enlace de fuente.

Manifiesto de descubrimiento MCP · llms.txt