Wall Street Turkish MCP

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

Guía para desarrolladores de MCP

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

Servidor: https://wallstreetturkish.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 HTTP Streamable. GET no abre una sesión SSE.

¿Cómo conectarse?

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

Claude Code · JSON

.mcp.json

{
  "mcpServers": {
    "wallstreetturkish_com": {
      "type": "http",
      "url": "https://wallstreetturkish.com/api/mcp"
    }
  }
}

Gemini CLI · JSON

~/.gemini/settings.json

{
  "mcpServers": {
    "wallstreetturkish_com": {
      "httpUrl": "https://wallstreetturkish.com/api/mcp"
    }
  }
}

Cursor · JSON

.cursor/mcp.json

{
  "mcpServers": {
    "wallstreetturkish_com": {
      "url": "https://wallstreetturkish.com/api/mcp"
    }
  }
}

Codex · TOML

~/.codex/config.toml

[mcp_servers.wallstreetturkish_com]
url = "https://wallstreetturkish.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, 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 valor 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 valores slug.
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; lista solo los tipos de activos abiertos en este sitio.
get_stock_quote	symbol	Obtiene el último precio registrado, cambio 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 unitario, categoría, comisiones, valor de riesgo y distribución actual de activos.
get_fund_history	code, days	Obtiene precios unitarios reales de registros diarios; no presenta el índice de rendimiento aproximado como precio.
get_fund_returns	code	Presenta los rendimientos registrados diarios, semanales, mensuales y de 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 actuales; 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 por 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, valores slug 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 fuente y enlaces de 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; en fechas faltantes no pasa a otro día.

Ejemplos de llamadas

Listar herramientas:

curl -X POST 'https://wallstreetturkish.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://wallstreetturkish.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 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 de archivo primera/última 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 y enlaces de fuente/imagen. No se realiza OCR ni recorte de noticias. Si la imagen grande no cumple con 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 explicativa.

Titulares del día:

curl -X POST 'https://wallstreetturkish.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://wallstreetturkish.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://wallstreetturkish.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 citació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 — Verificar el nombre del periódico y la fecha solicitada, y mostrar la imagen de portada completa del archivo con su fuente.
• Comparación de fondos — Comparar 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 Wall Street Turkish, 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, no asuma licencias no indicadas.
• Formato de errores: Los errores de protección HTTP se devuelven con application/json como error JSON-RPC; los errores de herramientas se devuelven con MCP isError. 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 juntos 60 llamadas/minuto. Las herramientas financieras usan además un límite común de 30 llamadas/minuto; las tres herramientas de periódicos usan un límite común de 60 llamadas/minuto; la herramienta de imagen de un solo periódico usa además una cuota de 10 llamadas/minuto. Todas también descuentan de la cuota general. Se aplican ventanas de minutos fijas.
• En respuesta 429, espere el tiempo de Retry-After. Los encabezados X-RateLimit-Limit, Remaining y Reset muestran la cuota general. Si el servicio de cuota Redis no está disponible, las herramientas devuelven 503 y 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 corrupto 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 MCP isError.
• No se presentan noticias eliminadas, borradores, con fecha futura o retiradas de publicación en 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.

En el historial de precios solo hay 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. Conserve el enlace de fuente al transmitir contenido y datos.

Manifiesto de descubrimiento MCP · llms.txt