Ekonominin Sesi MCP

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

Guía para desarrolladores de MCP

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

Servidor: https://ekonomininsesi.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 corresponden a clientes Code/CLI; Codex utiliza TOML.

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "ekonomininsesi_com": {
      "type": "http",
      "url": "https://ekonomininsesi.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "ekonomininsesi_com": {
      "httpUrl": "https://ekonomininsesi.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "ekonomininsesi_com": {
      "url": "https://ekonomininsesi.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.ekonomininsesi_com]
url = "https://ekonomininsesi.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 (predeterminado: 365).

La comparación de fondos acepta entre 2 y 5 códigos distintos; el período predeterminado es 1a, y los demás períodos son 1g, 1h, 1a, 3a, 6a, yd, 3a y 5a.

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, la fecha, la categoría y la información de la 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 publicadas más recientes 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 la 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, la variación y la información básica; no se garantiza precio en tiempo real.
get_stock_history	symbol, days	Obtiene solo los cierres reales registrados; no realiza solicitudes a fuentes externas ni genera precios sintéticos.
get_fund_details	code	Obtiene la ficha del fondo, el precio de la participación, la categoría, las comisiones, el valor de riesgo y la distribución de activos disponible.
get_fund_history	code, days	Obtiene los precios reales de participación a partir de los registros diarios; no presenta un í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 entre 2 y 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 hoy en Estambul.
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; si falta la fecha, no pasa a otro día.

Ejemplos de llamadas

Listar herramientas:

curl -X POST 'https://ekonomininsesi.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://ekonomininsesi.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 devuelven un máximo de 50 resultados y offset de 0 a 1000. Si la fecha no está en el archivo, no se pasa a otro día; las fechas primera/última de archivo no garantizan que exista cada día intermedio.

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 y una advertencia descriptiva.

Titulares del día:

curl -X POST 'https://ekonomininsesi.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://ekonomininsesi.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://ekonomininsesi.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 que ofrece el sitio.

• Investigación de noticias — Búsqueda de noticias, obtención de texto completo y presentación de fecha/fuente.
• Lectura de datos bursátiles — Lectura de datos de acciones registrados conservando la distinción entre 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 API — /auth.md.
• Atribución obligatoria. Al usar contenido de Ekonominin Sesi, 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 las portadas de periódicos pueden estar sujetas a los 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 isError de MCP. No se usa 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 juntas 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 tiene una cuota adicional de 10 llamadas/minuto. Todas también descuentan de la cuota general. Se aplican ventanas fijas por minuto.
• Ante una 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 y Retry-After: 5.
• Límite de cuerpo de 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 compatible 405. Los errores internos de herramientas se explican con isError de MCP.
• 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 los 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 en tiempo real. retrieved_at es el momento de acceso, record_updated_at es el momento de actualización del registro y data_date, si existe, es la fecha real de los datos; no son intercambiables. No se estiman fuentes ni tiempos desconocidos. Los números faltantes permanecen como null y 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, tenga en cuenta las diferentes fechas de datos; los rendimientos pasados no garantizan rendimientos futuros. Al transmitir contenido y datos, conserve el enlace de la fuente.

Manifiesto de descubrimiento MCP · llms.txt