FXMacroData
API macroeconómica de forex en tiempo real para todos los pares de divisas principales, obtenida de anuncios de bancos centrales.
Documentación
Live MCP · Streamable HTTP OAuth 2.0 + PKCE
Servidor MCP FXMacroData
Dale a tu asistente de IA una terminal de datos macro en vivo: indicadores de fuentes oficiales, calendarios de publicación, contexto de FX spot, COT, materias primas, aplicaciones de gráficos y flujos de trabajo de investigación listos para usar, dentro de las herramientas que ya utilizas.
30 herramientas disponibles
29 rutas REST
Solicitud rápida
Comienza con un endpoint de anuncios en vivo. La autenticación permanece en el parámetro de consulta api_key para pruebas directas desde navegador y scripts.
Ejemplo de inflación EUR GET /api/v1/announcements/eur/inflation
curl "https://api.fxmacrodata.com/v1/announcements/eur/inflation?api_key=YOUR_API_KEY"
Elige tu ruta de acceso a MCP
Comienza con la superficie MCP pública para consultas y descubrimiento de USD hasta 100 solicitudes sin clave/día, donde las publicaciones llegan 15 minutos después de su difusión. Añade acceso de pago cuando tu asistente necesite publicaciones en tiempo real, mayor volumen de uso de USD, indicadores no-USD, historial completo de USD, COT, materias primas, flujos de trabajo de tareas o llamadas a datos protegidos mediante OAuth o /mcp?api_key=YOUR_API_KEY.
Gratis
$0
Datos recientes de USD hasta 100 solicitudes sin clave/día, más tipos de FX, catálogo, calendario, sesiones y pruebas de cliente.
Individual
$50/mes
Acceso completo para traders con prueba de 14 días para herramientas MCP protegidas, filas de API, paneles y flujos de trabajo de investigación con IA.
Empresa
Personalizado
Licencias privadas, postura de privacidad personalizada, expectativas de auditoría y patrones de uso de plataforma para mesas más grandes.
Por qué conectar FXMacroData MCP
FXMacroData MCP convierte un asistente de IA de propósito general en un agente de investigación con conciencia macro. En lugar de pedirle a un modelo que adivine a partir de datos de entrenamiento desactualizados, el asistente puede llamar a herramientas en vivo para tasas de política, inflación, PIB, datos laborales, calendarios de publicación, tipos de FX, posicionamiento COT, materias primas y familias de conjuntos de datos oficiales. El resultado es una conversación que puede citar filas de datos reales, usar marcas de tiempo de publicación y mantener el análisis anclado en la misma API de producción que impulsa el panel de FXMacroData.
Para investigación FX discrecional
Pide un setup macro de EUR/USD, compara diferenciales de tasas de política, revisa los próximos riesgos de eventos o prepara un briefing previo al banco central sin salir de Claude, ChatGPT, Cursor, VS Code o tu host de agente preferido.
Para flujos de trabajo cuantitativos y sistemáticos
Usa marcas de tiempo de publicación point-in-time, tareas de backtest, filtros con compuerta de eventos, puntuación de riesgo de cartera y paquetes de investigación reutilizables para mantener cuadernos exploratorios y análisis generados por agentes alineados con datos macro en vivo.
Para agentes de codificación
Dale a Cursor, Continue, Cline, Windsurf, Replit Agent, Zed, Kiro y JetBrains un único endpoint MCP remoto que pueda descubrir indicadores, validar ejemplos y generar código de aplicaciones o cuadernos con conciencia macro.
Para respuestas centradas en gráficos
Los hosts compatibles con MCP Apps pueden renderizar recursos de gráficos interactivos para series de indicadores, tipos de FX, comparaciones de tasas de política, calendarios de publicación, mapas de calor, modelos de escenarios, repeticiones de eventos y laboratorios cuantitativos.
Elige la superficie MCP adecuada
Usa herramientas de datos para hechos exactos
Llama a data_catalogue, indicator_query, forex y release_calendar cuando necesites filas, marcas de tiempo, JSON, tablas o valores exactos.
Mejor prompt: "Obtén la inflación de USD desde 2024-01-01 hasta 2025-01-01."
Usa Apps para análisis visual
Llama a herramientas de artefactos visuales cuando la respuesta deba incluir un gráfico interactivo, vista de calendario de publicaciones, mapa de calor, modelo de escenario o repetición de eventos dentro del chat.
Mejor prompt: "Muéstrame un gráfico de las tasas de política de AUD desde 2020."
Usa tareas para flujos de trabajo de investigación
Llama a herramientas de tareas cuando el asistente deba ensamblar varias fuentes de datos en un resultado listo para decisiones, como un setup de trading, puntuación de riesgo, backtest o paquete de investigación.
Mejor prompt: "Construye un setup de trading de EUR/USD con catalizadores y notas de invalidación."
Usa prompts para rutinas repetibles
Los hosts conscientes de prompts pueden descubrir flujos de trabajo curados para briefings macro, verificaciones de riesgo de pares, resúmenes posteriores a publicaciones, planes semanales y enrutamiento de gráficos.
Mejor prompt: "Ejecuta el prompt de verificación de riesgo de pares FX para EUR/USD."
Abre la biblioteca gratuita de prompts
Metadatos de confianza y frescura
Las respuestas de FXMacroData MCP incluyen un bloque compacto mcp_metadata en la respuesta y, para conjuntos de datos respaldados por fuentes, result.data_quality. Verifica estos campos antes de usar un resultado en una nota de trading, backtest, alerta, cuaderno o flujo de trabajo de investigación automatizado.
Frescura
Inspecciona latest_available_date, last_updated, data_lag_days y is_stale antes de tratar los datos como actuales.
Procedencia
Usa source_type, source_name, is_proxy, is_derived y is_fallback para etiquetar la calidad de la fuente.
Cobertura
Comienza con data_catalogue usando include_coverage=true; revisa coverage_summary y el coverage_quality a nivel de fila.
Seguridad de backtest
Para flujos de trabajo point-in-time, verifica point_in_time_safe, has_announcement_datetime, row_count_before_pagination y returned_count. point_in_time_safe es falso siempre que cualquier fila en alcance tenga un tiempo de publicación derivado, así que lee assumed_release_time_count y la marca release_time_assumed por fila antes de descartar un resultado.
{ "mcp_metadata": { "source_type": "official", "latest_available_date": "2026-06-19", "data_lag_days": 3, "is_proxy": false, "is_derived": false, "is_fallback": false, "point_in_time_safe": false, "has_assumed_release_times": true, "assumed_release_time_count": 997, "row_count_before_pagination": 1349, "returned_count": 100 }, "result": { "data_quality": { "is_official": true, "is_proxy": false, "is_fallback": false, "is_stale": false, "has_announcement_datetime": true, "point_in_time_safe": false, "has_assumed_release_times": true, "assumed_release_time_count": 997, "latest_available_date": "2026-07-31", "source_type": "official", "source_name": "BLS", "row_count": 1349, "quality_scope": "full_result" } } }
Regla del agente
Si falta un campo requerido de frescura, fuente o cobertura, continúa solo como contexto exploratorio y declara que la procedencia o frescura es desconocida. No trates silenciosamente una respuesta de herramienta válida como lista para análisis. Cuando point_in_time_safe sea falso porque los tiempos de publicación fueron derivados, dilo en la respuesta en lugar de descartar los datos.
Flujo de trabajo de paginación de indicadores
Las herramientas de indicadores MCP usan el mismo contrato de paginación REST que /api/v1/announcements/{currency}/{indicator}. Para historiales largos, solicita una ventana de fechas amplia una vez y recorre las páginas con pagination.next_offset; no reintentes ventanas más cortas arbitrarias a menos que el usuario haya pedido un subperíodo específico.
1. Descubre la cobertura
data_catalogue(currency="nzd", include_coverage=true, include_capabilities=true)
Usa las fechas de cobertura del catálogo, capacidades, slugs exactos y mcp_metadata.coverage_summary antes de consultar un indicador disperso.
2. Consulta una página
indicator_query(currency="nzd", indicator="gov_bond_10y", limit=100, offset=0)
Usa page o offset; page tiene prioridad.
3. Continúa o diagnostica
offset = result.pagination.next_offset
Verifica pagination.page_includes_latest_available. Las ventanas válidas vacías devuelven un resultado vacío con no_data.error_code = NO_DATA_IN_REQUESTED_WINDOW y fechas de cobertura, no un error.
Conexión rápida
Comienza con la URL MCP desnuda solo cuando tu host pueda iniciar el flujo OAuth de FXMacroData. Para pantallas de clientes manuales que pidan una URL y una variable de entorno de token bearer, mantén la URL desnuda y apunta el campo de token bearer a tu variable de entorno de clave API de FXMacroData.
Claude (Web y Escritorio)
claude.ai — conector MCP remoto
- 1 Abre Claude → Configuración → Conectores Haz clic en Añadir servidor MCP y selecciona Remoto.
- 2
Ingresa la URL del servidor
https://mcp.fxmacrodata.com
Los clientes existentes que usan
https://fxmacrodata.com/mcppueden mantener esa URL de compatibilidad. - 3 Empieza a usarlo La evaluación sin clave admite datos de tabla USD (indicator_query) hasta 100 solicitudes/día. Para mayor volumen, visuales de aplicaciones MCP, herramientas de análisis y cobertura no-USD, usa una clave de pago u OAuth. Claude debería descubrir OAuth automáticamente desde la URL MCP. Si un flujo de Claude pide un ID de cliente OAuth y un secreto, usa los valores emitidos por FXMacroData para ese host. Como respaldo directo, usa https://mcp.fxmacrodata.com?api\_key=YOUR\_KEY; los clientes existentes también pueden usar https://fxmacrodata.com/mcp?api\_key=YOUR\_KEY.
- 4 Verifica la conexión En un chat nuevo, pregunta: "Ejecuta la herramienta ping de FXMacroData", "Muéstrame los indicadores USD disponibles", "¿Qué sesiones están abiertas ahora mismo?" o "Ejecuta subscribe_for_mcp_access".
Ejemplo: En vivo en Claude
Claude claude.ai
FXMacroData conectado
¿Cuál es el diferencial de tasas de interés entre EUR y USD, y qué significa para EUR/USD?
indicator_query(currency="eur", indicator="policy_rate")
indicator_query(currency="usd", indicator="policy_rate")
Resultados de herramientas
ECB (EUR) policy_rate: 4.25%
Fed (USD) policy_rate: 5.50%
Diferencial: −1.25% (prima USD)
Según los últimos datos del banco central de FXMacroData, la tasa de la Fed de 5.50% supera la tasa del BCE de 4.25% en 125 puntos base. Esta prima de tasa USD es un factor estructuralmente bajista para EUR/USD — los rendimientos más altos de EE. UU. atraen flujos de capital que respaldan la fortaleza del dólar frente al euro.
Pregunta sobre datos macro FX...
Artefactos de gráficos
Las Apps de FXMacroData MCP abarcan calendarios de publicación, visuales de indicadores, análisis de comparación de pares, mapas de calor entre divisas, herramientas de escenarios, flujos de trabajo de sala de guerra, repetición de eventos, distribuciones cuantitativas y flujos de desbloqueo por suscripción. Cada imagen a continuación se captura de una renderización real de una app MCP local; la experiencia final en el chat depende de si el host monta los recursos de MCP Apps en línea.
App de gráficos de indicadores con tarjetas de análisis premium y píldoras de señal.
Pila de control de indicadores en acción: superposiciones de Área + MA(5) + Tendencia.
Superficie de app de comparación para modos de línea, spread, ratio, normalizado y z-score.
App de mapa de calor macro con alternadores de modo y leyenda de escala matricial.
Modelador de escenarios de política para shocks de spread y salidas de spot proyectadas.
Cabina de sala de guerra macro para contexto de pares, cola de publicaciones y alertas de riesgo.
Línea de tiempo de repetición de impacto de eventos para revisiones de contexto de mercado point-in-time.
Laboratorio de escenarios cuantitativos para entradas de distribución de estrés y salidas de percentiles.
Tarjeta CTA de suscriptor con transferencia directa de pago para funciones MCP restringidas.
Claude claude.ai
FXMacroData conectado
Grafica la tasa de política de USD desde 2020 como un gráfico
indicator_visual_artifact(currency="usd", indicator="policy_rate", start_date="2020-01-01")
USD / POLICY_RATE 15 puntos · último 2024-12 = 4.50%
6% 4% 2% 0% 2020 2022 2023 2024 5.50% 4.50%
FX Macrodata · indicator_visual_artifact · interactivo en Claude
Aquí está la tasa de política de USD (tasa de fondos federales) de 2020 a 2024. La tasa se mantuvo cerca de cero durante 2021, luego la Fed lanzó su ciclo de subidas más rápido en décadas — subiendo de 0.25% a un pico de 5.50% a mediados de 2023. Los primeros recortes comenzaron a fines de 2024, llevando la tasa de vuelta a 4.50%.
Explorador de MCP Apps
Las MCP Apps son mejores cuando la respuesta debe permanecer interactiva dentro de la conversación. FXMacroData ahora expone flujos de apps de calendario de publicaciones, gráficos, inteligencia de pares, mapa de calor macro, escenarios de política, sala de guerra macro, repetición de eventos y laboratorio cuantitativo. Para hosts persistentes como Claude Code y agentes de codificación impulsados por Gemini, el servidor también expone flujos de investigación no visuales capaces de tareas que pueden consultarse y reutilizarse a lo largo de un hilo largo.
App de calendario de publicaciones
"Muéstrame el calendario de publicaciones del PIB de USD en hora de Sao Paulo" release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo") -> ui://fxmacrodata/release-calendar.html
Widget de gráfico interactivo
"Muéstrame un gráfico del historial de la tasa de política de AUD"
indicator_visual_artifact(currency="aud", indicator="policy_rate")
Aplicación de comparación de pares FX
"Compara las tasas de política de EUR y USD con contexto de carry"
pair_intel_task(base="eur", quote="usd")
Aplicación de mapa de calor macro
"Muéstrame los prints macro más fuertes y más débiles en G10"
macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")
Aplicación de modelador de escenarios
"¿Qué pasa si la Fed sube 50 puntos base más?"
policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)
Aplicación de sala de guerra macro
"Construye una sala de guerra macro en vivo de EUR/USD para el PIB de USD"
macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")
Aplicación de repetición de eventos
"Reproduce las sorpresas del PIB de USD frente a EUR/USD"
event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)
Aplicación de laboratorio de escenarios cuantitativos
"Ejecuta una distribución de estrés de 30 días para EUR/USD después de un shock en la pata base"
quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)
Capacidades, Aplicaciones y Tareas
Transporte MCP remoto
- ▸ Endpoint HTTP transmisible en
https://mcp.fxmacrodata.com - ▸ Respuestas JSON simples para compatibilidad con proxy/CDN
- ▸ Solicitudes HTTP sin estado, por lo que cada llamada lleva su propio contexto de autenticación
Recursos de aplicaciones MCP
Las herramientas visuales devuelven datos estructurados más metadatos de recurso ui:// para que los hosts compatibles puedan renderizar gráficos y aplicaciones de flujo de trabajo en línea.
ui://fxmacrodata/indicator-chart.html
ui://fxmacrodata/comparison-chart.html
ui://fxmacrodata/release-calendar.html
ui://fxmacrodata/macro-heatmap.html
ui://fxmacrodata/scenario-modeler.html
ui://fxmacrodata/macro-war-room.html
ui://fxmacrodata/event-impact-replay.html
ui://fxmacrodata/quant-scenario-lab.html
ui://fxmacrodata/subscribe-cta.html
Herramientas con capacidad de tareas
Las herramientas de flujo de trabajo avanzadas se pueden llamar como herramientas normales. Los hosts que admiten Tareas MCP experimentales también pueden crear una tarea, consultar el estado con tasks/get y recuperar el payload final cuando esté completo.
macro_briefing_task known_at_time_task fx_backtest_task macro_research_pack_task portfolio_risk_engine_task
Prompts integrados
Los clientes conscientes de prompts pueden descubrir flujos de trabajo FX reutilizables a través de prompts/list e invocarlos con prompts/get. La biblioteca de prompts pública refleja estas rutinas con prompts copiables, salvaguardas y feeds legibles por máquina.
macro_briefing rate_decision_brief pair_analysis pre_central_bank_decision_brief post_release_trade_summary pair_risk_check week_ahead_macro_plan data_quality_audit release_risk_ladder known_at_time_backtest_check event_gated_backtest_brief portfolio_event_risk_scan cot_positioning_context commodity_fx_context visualize_macro_series
Catálogo de Herramientas
30 herramientas
FXMacroData expone una superficie de herramientas de solo lectura. Las tarjetas detalladas a continuación cubren las herramientas principales que la mayoría de los usuarios llaman directamente; el conjunto completo de herramientas públicas se agrupa aquí para descubrimiento rápido.
Datos principales
ping data_catalogue indicator_query release_calendar forex market_sessions cot_data commodities official_dataset_family
Artefactos visuales
indicator_visual_artifact forex_visual_artifact commodities_visual_artifact cot_visual_artifact policy_rate_differential_visual_artifact
Flujos de trabajo de aplicaciones e investigación
macro_briefing_task indicator_intel_task pair_intel_task macro_heatmap_task policy_scenario_modeler_task macro_war_room_task event_impact_replay_task quant_scenario_lab_task
Tareas de decisión y cartera
known_at_time_task macro_regime_classifier_task release_risk_score_task portfolio_risk_engine_task fx_trade_setup_task fx_backtest_task macro_research_pack_task subscribe_for_mcp_access
data_catalogue solo lectura
currency
Devuelve todos los indicadores disponibles y metadatos para un código de moneda dado. Mantén include_coverage=true y usa include_capabilities=true al decidir si una serie dispersa tiene observaciones recientes.
Entrada: currency, include_coverage?, include_capabilities?, indicator? Salida: {currency, catalogue[], coverage[], mcp_metadata}
indicator_query solo lectura
currency · indicator · dates
Devuelve series temporales de indicadores macroeconómicos para una moneda. Admite policy_rate, inflation, gdp, employment y más. La paginación refleja REST: limit, offset, page y pagination.next_offset. Usa mcp_metadata y result.data_quality para verificaciones de frescura y fuente.
Entrada: currency, indicator, start_date?, end_date?, limit?, offset?, page? Salida: {currency, indicator, pagination, data[], data_quality, mcp_metadata}
indicator_visual_artifact visual
currency · indicator · dates
Devuelve series temporales de indicadores con metadatos de aplicaciones MCP para que los clientes compatibles puedan renderizar un artefacto de gráfico interactivo en contexto. Usa los mismos controles limit, offset o page para ventanas de gráfico amplias.
Entrada: currency, indicator, start_date?, end_date?, limit?, offset?, page? Salida: structuredContent + chart resource
release_calendar solo lectura app
currency · indicator?
Devuelve marcas de tiempo de próximos lanzamientos con filtrado opcional de indicadores y conversión de zona horaria IANA solicitada, más metadatos de la aplicación de calendario de lanzamientos para hosts compatibles. Inspecciona mcp_metadata antes de usar el tiempo de eventos en automatización.
Entrada: currency, indicator?, timezone? Salida: {currency, timezone, requested_timezone, data[], mcp_metadata} + resource_link Filas: campos ISO UTC, local de mercado, zona horaria solicitada App: ui://fxmacrodata/release-calendar.html
forex solo lectura
base · quote · dates · indicators?
Devuelve filas de tasa spot FX con indicadores técnicos opcionales. Inspecciona pair_metadata, data_quality.source_legs y data[].source a nivel de fila antes de clasificar un par como directamente disponible, invertido, derivado cruzado, basado en peg o expandido de menor frecuencia.
La prioridad de fuente FX es BIS XRU tasas diarias USD cuando estén disponibles, luego fuentes diarias oficiales de bancos nacionales, cruces derivados etiquetados EUR/CAD, pegs USD oficiales, promedios mensuales BIS expandidos a días hábiles, tasas mensuales IMF IFS y tasas anuales del Banco Mundial. Las expansiones mensuales y anuales permanecen etiquetadas a través de source_frequency y derivation_method.
Entrada: base, quote, start_date?, end_date?, indicators?, limit?, offset?, page? Salida: {base, quote, data[], pair_metadata, data_quality, indicators?, mcp_metadata} Verificar: direct_available, inverse_available, is_derived, derivation_method, source_legs, pair_consistency_check
cot_data solo lectura
currency · dates
Devuelve datos semanales de posicionamiento CFTC Commitment of Traders (COT) para el contrato de futuros FX de una moneda, incluidos los mismos metadatos compactos de frescura y procedencia utilizados por otras herramientas MCP sin procesar.
Entrada: currency, start_date?, end_date? Salida: {currency, data[], data_quality, mcp_metadata}
commodities solo lectura
indicator · dates
Devuelve series temporales de indicadores de materias primas y energía. Cubre oro, petróleo (Brent/WTI) y gas natural. El parámetro es indicator, por ejemplo indicator="gold".
Entrada: indicator, start_date?, end_date? Salida: {indicator, data[], data_quality, mcp_metadata}
known_at_time_task tarea
currency · indicator · as_of
Devuelve el segmento seguro punto-en-el-tiempo de una serie macro usando marcas de tiempo de anuncio como límite de integridad.
Entrada: currency, indicator, as_of, start_date?, end_date? Salida: {known_rows[], latest_known, integrity}
macro_regime_classifier_task tarea
currency
Clasifica el régimen macro de una moneda a partir del contexto de política, inflación, crecimiento y trabajo con notas de confianza explícitas.
Entrada: currency, start_date?, end_date? Salida: {regime, latest, signals, confidence_notes}
release_risk_score_task tarea
base · quote
Clasifica la próxima lista de lanzamientos para un par usando pesos de impacto heurísticos conscientes del par.
Entrada: base, quote, horizon_events? Salida: {events[], top_risk, methodology}
portfolio_risk_engine_task tarea
portfolio
Evalúa una cartera FX con PnL de estrés, diagnósticos de concentración, exposición de moneda y clasificación de riesgo de eventos a partir de calendarios de lanzamientos.
Entrada: positions_json, stress_shock_pct?, horizon_events? Salida: {portfolio, positions, exposure_by_currency, event_risk, risk_flags}
fx_trade_setup_task tarea
base · quote
Construye una configuración de par FX orientada a traders con sesgo direccional, diferenciales macro, clasificación de catalizadores, contexto de ventana de ejecución y notas de invalidación.
Entrada: base, quote, horizon_events?, include_cot? Salida: {bias, spot_context, catalysts, execution, quality}
fx_backtest_task tarea
base · quote · dates
Ejecuta un backtest FX transparente basado en reglas con señales de carry/momentum, comparación de referencia, salida de curva de capital y compuerta de eventos opcional en ventanas de lanzamiento.
Entrada: base, quote, start_date?, end_date?, strategy?, momentum_lookback?, transaction_cost_bps?, initial_capital?, event_gated?, event_window_days? Salida: {metrics, benchmark, assumptions, series.equity_curve}
macro_research_pack_task tarea
currency · indicator
Construye un payload de investigación reutilizable que combina validación de catálogo, historial de series, próximo tiempo de lanzamiento y contexto FX opcional.
Entrada: currency, indicator, base?, quote?, start_date?, end_date? Salida: {catalogue, series, next_release, fx_context}
Playbooks de Investigación
Los mejores flujos de trabajo MCP combinan descubrimiento, recuperación exacta de datos y un paso final de síntesis. Estos playbooks son los patrones que recomendamos para analistas, traders y constructores de agentes que quieren respuestas macro confiables en lugar de llamadas de herramientas únicas.
Día de decisión del banco central
Úsalo antes de una decisión de la Fed, BCE, BoE, BoJ, RBA, BoC, SNB o RBNZ. El asistente debe verificar la tasa de política más reciente, la trayectoria de inflación, el mercado laboral, el próximo lanzamiento programado y la clasificación de régimen antes de escribir el informe.
macro_regime_classifier_task(currency="usd") -> indicator_query(policy_rate) -> release_calendar(policy_rate)
Reacción FX posterior al lanzamiento
Úsalo después de prints de IPC, PIB, nóminas, desempleo o ventas minoristas. El agente debe comparar la fila más reciente con el contexto anterior, reproducir el historial de eventos reciente y mapear las implicaciones al par FX relevante.
event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd")
Lista de verificación macro previa a la operación
Úsalo antes de expresar una opinión en un par de monedas. El asistente debe inspeccionar el contexto spot, carry, divergencia de inflación, próximos lanzamientos, sesiones actuales y posicionamiento COT cuando esté disponible.
fx_trade_setup_task(base="eur", quote="usd", horizon_events=4)
Escaneo de riesgo de eventos de cartera
Úsalo cuando tengas varias posiciones FX y necesites saber qué eventos próximos importan más. La tarea mapea exposiciones por moneda, estima PnL de estrés y clasifica riesgos de eventos.
portfolio_risk_engine_task(positions_json='[{"base":"eur","quote":"usd","side":"long","notional":100000}]')
Higiene de backtest punto-en-el-tiempo
Úsalo cuando una estrategia dependa de lanzamientos macro. El asistente debe evitar el lookahead filtrando filas a través de marcas de tiempo de anuncio y, cuando sea relevante, aplicando compuerta de eventos a la ventana de backtest.
known_at_time_task(currency="usd", indicator="gdp", as_of="2025-01-15")
Aplicaciones macro construidas por agentes
Úsalo cuando un agente de codificación esté construyendo paneles, notebooks, alertas o widgets. Comienza con descubrimiento de catálogo, solicita formas exactas de endpoints y luego genera código contra URLs de producción y ejemplos de autenticación por parámetros de consulta.
data_catalogue(currency="aud") -> indicator_query(currency="aud", indicator="policy_rate")
Ejemplos de Uso
Verificación de conectividad
"Ejecuta la herramienta ping de FXMacroData"
ping()
Serie temporal de inflación USD
"Obtén datos de inflación USD del 2024-01-01 al 2025-01-01" indicator_query(currency="usd", indicator="inflation", start_date="2024-01-01", end_date="2025-01-01")
Descubrimiento del catálogo AUD
"¿Qué indicadores AUD están disponibles y cuáles tienen cobertura reciente?"
data_catalogue(currency="aud", include_coverage=true, include_capabilities=true)
Verificación de frescura y fuente
"Obtén el PIB EUR y dime si el resultado es fresco, oficial, de respaldo, proxy o derivado."
indicator_query(currency="eur", indicator="gdp") -> inspecciona mcp_metadata y result.data_quality
Calendario de publicaciones USD
"Mostrar próximas fechas de publicación del PIB USD en hora de Brasil"
release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo")
Tipos de cambio EUR/USD al contado
"Mostrar tipos de cambio EUR/USD al contado con RSI y SMA, e indicar si el par fue directo, invertido o derivado."
forex(base="eur", quote="usd", start_date="2024-01-01", end_date="2024-12-31", indicators="sma_20,rsi_14") -> inspecciona pair_metadata y data_quality.source_legs
Artefacto de gráfico — Tasa de política EUR
"Graficar la tasa de política EUR como un gráfico"
indicator_visual_artifact(currency="eur", indicator="policy_rate")
Sesiones FX en vivo
"¿Qué sesiones FX están abiertas ahora mismo?"
market_sessions()
Posicionamiento COT GBP
"Mostrar datos de posicionamiento de futuros GBP"
cot_data(currency="gbp", start_date="2024-01-01")
Serie de precios del oro
"Obtener precios del oro para 2024"
commodities(indicator="gold", start_date="2024-01-01", end_date="2024-12-31")
Mapa de calor entre mercados
"Mostrarme ganadores y perdedores macro en USD, EUR, GBP y JPY"
macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")
Modelador de escenarios de política
"¿Qué pasaría si la Fed sube 50 puntos básicos más?"
policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)
Inteligencia de sala de guerra macro
"Montar una sala de guerra macro para EUR/USD y PIB USD"
macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")
Reproducción de eventos en punto en el tiempo
"Reproducir eventos recientes del PIB USD con contexto EUR/USD"
event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)
Laboratorio de estrés de escenarios cuantitativos
"Ejecutar un escenario avanzado EUR/USD con bandas de volatilidad"
quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)
Corte macro en punto en el tiempo
"Mostrar solo lo que se sabía sobre el PIB USD hasta el 15 de enero de 2025"
known_at_time_task(currency="usd", indicator="gdp", as_of="2025-01-15T00:00:00Z")
Clasificador de régimen macro
"Clasificar el régimen macro USD actual"
macro_regime_classifier_task(currency="usd")
Puntuación de riesgo de publicación de pares
"¿Cuáles son los mayores riesgos programados para EUR/USD a continuación?"
release_risk_score_task(base="eur", quote="usd", horizon_events=6)
Motor de riesgo de cartera
"Calificar el riesgo y la exposición a eventos para mi cartera EUR/USD y GBP/USD"
portfolio_risk_engine_task(positions_json='[{"base":"eur","quote":"usd","side":"long","notional":100000},{"base":"gbp","quote":"usd","side":"short","notional":80000}]', stress_shock_pct=1.5, horizon_events=5)
Configuración FX lista para traders
"Crearme una configuración de trading para EUR/USD con catalizadores y notas de invalidación"
fx_trade_setup_task(base="eur", quote="usd", horizon_events=4)
Backtest de estrategia con compuerta de eventos
"Backtest de carry + momentum EUR/USD alrededor de ventanas de publicación macro con costos de trading realistas"
fx_backtest_task(base="eur", quote="usd", start_date="2024-01-01", end_date="2025-01-01", strategy="carry_momentum", momentum_lookback=10, transaction_cost_bps=2.0, event_gated=true, event_window_days=1)
Paquete de investigación persistente
"Construir un payload de investigación canónico para el PIB USD con contexto EUR/USD"
macro_research_pack_task(currency="usd", indicator="gdp", base="eur", quote="usd")
Autenticación
Sin autenticación Público (USD)
- ▸ Conéctate solo con la URL desnuda
- ▸ Indicadores USD (últimos 90 días), tipos de cambio FX, catálogo, calendario, sesiones
- ▸ Sin clave API ni OAuth requeridos
Acceso completo OAuth 2.0 + PKCE
- ▸ Flujo de código de autorización con PKCE
- ▸ Alcance:
fxmacrodata.read - ▸ Transporte Bearer:
Authorization: Bearer <token> - ▸ Registro dinámico de clientes para clientes que se auto-registran
Acceso completo Clave API
- ▸ Enviar como variable de entorno de token bearer o añadir a la URL MCP
- ▸
/mcp?api_key=YOUR_KEY - ▸ Ideal para entornos de ejecución IDE / SDK sin OAuth
Niveles de acceso: Los indicadores USD (los 90 días más recientes) están disponibles sin clave hasta 100 solicitudes/día. Los tipos de cambio FX, catálogo, calendario y sesiones permanecen públicos para evaluación. Los indicadores no USD, uso USD de mayor volumen, el archivo histórico completo de USD, COT y materias primas requieren una clave API. Obtener acceso →
Endpoints OAuth
Autorización:https://api.fxmacrodata.com/oauth/authorize
Token:https://api.fxmacrodata.com/oauth/token
Registro:https://api.fxmacrodata.com/oauth/register
Metadatos:https://fxmacrodata.com/.well-known/oauth-authorization-server
Recurso protegido:https://api.fxmacrodata.com/.well-known/oauth-protected-resource
Soporte de clientes OAuth
- ▸ Clientes PKCE públicos con
token_endpoint_auth_method=none - ▸ Clientes confidenciales que usan
client_secret_postoclient_secret_basic - ▸ Tokens Bearer resueltos de vuelta al contexto de suscripción de clave API para herramientas protegidas
Soporte de URI de redirección
La mayoría de los hosts MCP compatibles descubren la configuración OAuth correcta desde la URL de metadatos anterior. Para clientes personalizados, registra la URI de redirección requerida por tu host MCP y mantén las credenciales del cliente fuera de los archivos de configuración compartidos.
Detalles del servidor
URL base MCP
Transporte
HTTP transmisible
Seguridad
HTTPS / TLS
Estado
Disponibilidad general
Disponibilidad
Endpoint HTTPS de producción
Rutas REST
29 endpoints públicos
Validación rápida
# API health check
curl -i https://api.fxmacrodata.com/v1/ping
# OAuth metadata
curl -i https://fxmacrodata.com/.well-known/oauth-authorization-server
# OAuth metadata (API alias)
curl -i https://api.fxmacrodata.com/.well-known/oauth-authorization-server
# MCP route probe (JSON guidance expected for plain GET)
curl -i https://mcp.fxmacrodata.com
# MCP initialize
curl -i -X POST "https://mcp.fxmacrodata.com" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{"jsonrpc":"2.0","id":"1","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'
# MCP tools/list
curl -i -X POST "https://mcp.fxmacrodata.com" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{"jsonrpc":"2.0","id":"2","method":"tools/list","params":{}}'
# Authenticated indicator_query with OAuth token or FXMacroData API key
curl -i -X POST "https://mcp.fxmacrodata.com" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN_OR_FXMD_API_KEY" \
--data '{"jsonrpc":"2.0","id":"3","method":"tools/call","params":{"name":"indicator_query","arguments":{"currency":"usd","indicator":"inflation","start_date":"2024-01-01","end_date":"2025-01-01"}}}'
Referencia de errores
| Estado | Significado |
|---|---|
| 406 | Encabezado Accept no compatible o método HTTP incorrecto (por ejemplo, llamadas de protocolo no JSON) |
| 400 | Formato de solicitud MCP no válido |
| 401/403 | Fallo de autenticación o autorización en datos protegidos |
| 200 | Inicialización MCP válida con Accept: application/json devuelve capacidades e instrucciones del servidor |
Listo para respuestas de IA
Datos clave
Página
Servidor MCP
Sección
Documentación
URL canónica
https://fxmacrodata.com/documentation/mcp-server
Fuente
Redacción de FXMacroData y referencias de editores oficiales
Última actualización
Ver metadatos de la página
Procedencia y confianza
Cita la URL canónica y el campo de fuente anterior. Cuando esté disponible, esta página se corresponde con publicaciones de editores oficiales y actualizaciones con marca de tiempo.
Preguntas rápidas
¿De qué trata esta página? Esta página explica el Servidor MCP con contexto directamente utilizable para flujos de trabajo de trading, investigación y API.
¿Qué fuente debe citarse? Usa la URL canónica y el campo de fuente indicado; cita referencias de editores oficiales cuando estén disponibles.
¿Qué tan fresco es este contenido? El valor de última actualización anterior refleja los metadatos de la página o la marca de tiempo de datos más reciente disponible.
¿Se puede usar esto en asistentes de IA? Sí. Esta sección está estructurada intencionalmente para recuperación y citación en asistentes de chat.
Paquetes de prompts
Úsalos en ChatGPT, Claude, Gemini, Mistral, Perplexity o Grok para obtener resultados consistentes y conscientes de la fuente.