FXMacroData

Live MCP · Streamable HTTP OAuth 2.0 + PKCE

Servidor MCP FXMacroData

Dê ao seu assistente de IA um terminal de dados macro ao vivo: indicadores de fontes oficiais, calendários de divulgação, contexto de spot de FX, COT, commodities, aplicativos de gráficos e fluxos de trabalho de pesquisa prontos para tarefas dentro das ferramentas que você já usa.

https://mcp.fxmacrodata.com

30 ferramentas disponíveis

29 rotas REST

Solicitação Rápida

Comece com um endpoint de anúncios ao vivo. A autenticação permanece no parâmetro de consulta api_key para testes diretos em navegador e script.

Exemplo de inflação do EUR GET /api/v1/announcements/eur/inflation

curl "https://api.fxmacrodata.com/v1/announcements/eur/inflation?api_key=YOUR_API_KEY"

Escolha Seu Caminho de Acesso MCP

Comece com a superfície MCP pública para consultas e descoberta de USD até 100 solicitações sem chave/dia, onde as divulgações chegam 15 minutos após a publicação. Adicione acesso pago quando seu assistente precisar de divulgações em tempo real, uso de USD em maior volume, indicadores não-USD, histórico completo de USD, COT, commodities, fluxos de trabalho de tarefas ou chamadas de dados protegidas via OAuth ou /mcp?api_key=YOUR_API_KEY.

Grátis

$0

Dados recentes de USD até 100 solicitações sem chave/dia, além de taxas de FX, catálogo, calendário, sessões e testes de cliente.

Individual

$50/mês

Acesso completo de trader com teste de 14 dias para ferramentas MCP protegidas, linhas de API, painéis e fluxos de trabalho de pesquisa com IA.

Iniciar teste

Empresarial

Personalizado

Licenciamento privado, postura de privacidade personalizada, expectativas de auditoria e padrões de uso de plataforma para mesas maiores.

Fale conosco

Por Que Conectar o MCP FXMacroData

O MCP FXMacroData transforma um assistente de IA de propósito geral em um agente de pesquisa com consciência macro. Em vez de pedir a um modelo que adivinhe a partir de dados de treinamento desatualizados, o assistente pode chamar ferramentas ao vivo para taxas de política monetária, inflação, PIB, dados trabalhistas, calendários de divulgação, taxas de FX, posicionamento COT, commodities e famílias de conjuntos de dados oficiais. O resultado é uma conversa que pode citar linhas de dados reais, usar carimbos de data/hora de divulgação e manter a análise fundamentada na mesma API de produção que alimenta o painel FXMacroData.

Para pesquisa discricionária de FX

Peça uma configuração macro de EUR/USD, compare diferenciais de taxas de política monetária, revise os próximos riscos de eventos ou monte um briefing pré-banco central sem sair do Claude, ChatGPT, Cursor, VS Code ou do seu host de agente preferido.

Para fluxos de trabalho quantitativos e sistemáticos

Use carimbos de data/hora de divulgação point-in-time, tarefas de backtest, filtros com gatilho de eventos, pontuação de risco de portfólio e pacotes de pesquisa reutilizáveis para manter notebooks exploratórios e análises geradas por agentes alinhados com dados macro ao vivo.

Para agentes de codificação

Dê ao Cursor, Continue, Cline, Windsurf, Replit Agent, Zed, Kiro e JetBrains um único endpoint MCP remoto que possa descobrir indicadores, validar exemplos e gerar código de aplicativo ou notebook com consciência macro.

Para respostas focadas em gráficos

Hosts compatíveis com MCP Apps podem renderizar recursos de gráficos interativos para séries de indicadores, taxas de FX, comparações de taxas de política monetária, calendários de divulgação, mapas de calor, modelos de cenário, replays de eventos e laboratórios quant.

Escolha a Superfície MCP Certa

Use ferramentas de dados para fatos exatos

Chame data_catalogue, indicator_query, forex e release_calendar quando precisar de linhas, carimbos de data/hora, JSON, tabelas ou valores exatos.

Melhor prompt: "Obtenha a inflação dos EUA de 2024-01-01 a 2025-01-01."

Use Apps para análise visual

Chame ferramentas de artefatos visuais quando a resposta deve incluir um gráfico interativo, visualização de calendário de divulgação, mapa de calor, modelo de cenário ou replay de evento dentro do chat.

Melhor prompt: "Mostre-me um gráfico das taxas de política monetária do AUD desde 2020."

Use tarefas para fluxos de trabalho de pesquisa

Chame ferramentas de tarefas quando o assistente deve montar várias fontes de dados em uma saída pronta para decisão, como uma configuração de trade, pontuação de risco, backtest ou pacote de pesquisa.

Melhor prompt: "Monte uma configuração de trade EUR/USD com catalisadores e notas de invalidação."

Use prompts para rotinas repetíveis

Hosts com reconhecimento de prompts podem descobrir fluxos de trabalho curados para briefings macro, verificações de risco de pares, resumos pós-divulgação, planos semanais e roteamento de gráficos.

Melhor prompt: "Execute o prompt de verificação de risco do par FX para EUR/USD."

Abrir a biblioteca gratuita de prompts

Metadados de Confiança e Atualização

As respostas do MCP FXMacroData incluem um bloco compacto mcp_metadata na resposta e, para conjuntos de dados com fonte, result.data_quality. Verifique esses campos antes de usar um resultado em uma nota de trade, backtest, alerta, notebook ou fluxo de trabalho de pesquisa automatizado.

Atualização

Inspecione latest_available_date, last_updated, data_lag_days e is_stale antes de tratar os dados como atuais.

Proveniência

Use source_type, source_name, is_proxy, is_derived e is_fallback para rotular a qualidade da fonte.

Cobertura

Comece com data_catalogue usando include_coverage=true; revise coverage_summary e o coverage_quality em nível de linha.

Segurança de backtest

Para fluxos de trabalho point-in-time, verifique point_in_time_safe, has_announcement_datetime, row_count_before_pagination e returned_count. point_in_time_safe é falso sempre que qualquer linha no escopo carrega um horário de publicação derivado, então leia assumed_release_time_count e o sinalizador release_time_assumed por linha antes de descartar um 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" } } }

Regra do agente

Se um campo obrigatório de atualização, fonte ou cobertura estiver ausente, continue apenas como contexto exploratório e declare que a proveniência ou atualização é desconhecida. Não trate silenciosamente uma resposta de ferramenta válida como pronta para análise. Quando point_in_time_safe for falso porque os horários de publicação foram derivados, diga isso na resposta em vez de descartar os dados.

Fluxo de Trabalho de Paginação de Indicadores

As ferramentas de indicadores MCP usam o mesmo contrato de paginação REST que /api/v1/announcements/{currency}/{indicator}. Para históricos longos, solicite uma janela de datas ampla uma vez e percorra as páginas com pagination.next_offset; não tente novamente janelas mais curtas arbitrárias, a menos que o usuário tenha pedido um subperíodo específico.

1. Descubra a cobertura

data_catalogue(currency="nzd", include_coverage=true, include_capabilities=true)

Use datas de cobertura do catálogo, capacidades, slugs exatos e mcp_metadata.coverage_summary antes de consultar um indicador esparso.

2. Consulte uma página

indicator_query(currency="nzd", indicator="gov_bond_10y", limit=100, offset=0)

Use page ou offset; page tem precedência.

3. Continue ou diagnostique

offset = result.pagination.next_offset

Verifique pagination.page_includes_latest_available. Janelas válidas vazias retornam um resultado vazio com no_data.error_code = NO_DATA_IN_REQUESTED_WINDOW e datas de cobertura, não um erro.

Conexão Rápida

Comece com a URL MCP pura somente quando seu host puder iniciar o fluxo OAuth do FXMacroData. Para telas de cliente manuais que pedem uma URL e uma variável de ambiente de token bearer, mantenha a URL pura e aponte o campo de token bearer para sua variável de ambiente de chave de API do FXMacroData.

Claude (Web e Desktop)

claude.ai — conector MCP remoto

1. 1 Abra Claude → Configurações → Conectores Clique em Adicionar Servidor MCP e selecione Remoto.
2. 2 Digite a URL do servidor https://mcp.fxmacrodata.com Clientes existentes usando https://fxmacrodata.com/mcp podem manter essa URL de compatibilidade.
3. 3 Comece a usar A avaliação sem chave suporta dados de tabela USD (indicator_query) até 100 solicitações/dia. Para uso em maior volume, visuais de aplicativos MCP, ferramentas de análise e cobertura não-USD, use uma chave paga ou OAuth. O Claude deve descobrir o OAuth automaticamente a partir da URL MCP. Se um fluxo do Claude pedir um ID de cliente OAuth e um segredo, use os valores emitidos pelo FXMacroData para esse host. Como fallback direto, use https://mcp.fxmacrodata.com?api\_key=YOUR\_KEY; clientes existentes também podem usar https://fxmacrodata.com/mcp?api\_key=YOUR\_KEY.
4. 4 Verifique a conexão Em um novo chat, pergunte: "Execute a ferramenta de ping do FXMacroData", "Mostre-me os indicadores USD disponíveis", "Quais sessões estão abertas agora?" ou "Execute subscribe_for_mcp_access".

Exemplo: Ao Vivo no Claude

Claude claude.ai

FXMacroData conectado

Qual é o diferencial de taxa de juros entre EUR e USD, e o que isso significa para EUR/USD?

indicator_query(currency="eur", indicator="policy_rate")

indicator_query(currency="usd", indicator="policy_rate")

Resultados das ferramentas

ECB (EUR) policy_rate: 4.25%

Fed (USD) policy_rate: 5.50%

Diferencial: −1.25% (prêmio USD)

Com base nos dados mais recentes do banco central do FXMacroData, a taxa do Fed de 5,50% excede a taxa do ECB de 4,25% em 125 pontos-base. Esse prêmio de taxa USD é um fator estruturalmente baixista para EUR/USD — rendimentos mais altos nos EUA atraem fluxos de capital que sustentam a força do dólar em relação ao euro.

Pergunte sobre dados macro de FX...

Artefatos de Gráficos

Os Apps do MCP FXMacroData abrangem calendários de divulgação, visuais de indicadores, análise de comparação de pares, mapas de calor entre moedas, ferramentas de cenário, fluxos de trabalho de sala de guerra, replay de eventos, distribuições quant e fluxos de desbloqueio de assinatura. Cada imagem abaixo é capturada de uma renderização real de app MCP local; a experiência final no chat depende de o host montar os recursos de MCP Apps inline.

App de gráfico de indicadores com cartões de análise premium e pílulas de sinal.

Pilha de controle de indicadores em ação: sobreposições de Área + MA(5) + Tendência.

Superfície de app de comparação para modos de linha, spread, razão, normalizado e z-score.

App de mapa de calor macro com alternâncias de modo e legenda de escala de matriz.

Modelador de cenário de política monetária para choques de spread e saídas de spot projetadas.

Cockpit de sala de guerra macro para contexto de par, fila de divulgações e alertas de risco.

Linha do tempo de replay de impacto de evento para revisões de contexto de mercado point-in-time.

Laboratório de cenário quant para entradas de distribuição de estresse e saídas de percentil.

Cartão de CTA de assinante com transferência direta de checkout para recursos MCP restritos.

Claude claude.ai

FXMacroData conectado

Plote a taxa de política monetária do USD desde 2020 como um gráfico

indicator_visual_artifact(currency="usd", indicator="policy_rate", start_date="2020-01-01")

USD / POLICY_RATE 15 pontos · mais recente 2024-12 = 4,50%

6% 4% 2% 0% 2020 2022 2023 2024 5,50% 4,50%

FX Macrodata · indicator_visual_artifact · interativo no Claude

Aqui está a taxa de política monetária do USD (taxa de fundos do Fed) de 2020 a 2024. A taxa foi mantida perto de zero durante 2021, então o Fed lançou seu ciclo de aumento mais rápido em décadas — subindo de 0,25% para um pico de 5,50% em meados de 2023. Os primeiros cortes começaram no final de 2024, trazendo a taxa de volta para 4,50%.

Explorador de MCP Apps

Os MCP Apps são melhores quando a resposta deve permanecer interativa dentro da conversa. O FXMacroData agora expõe fluxos de app de calendário de divulgação, gráficos, inteligência de pares, mapa de calor macro, cenário de política monetária, sala de guerra macro, replay de eventos e laboratório quant. Para hosts persistentes como Claude Code e agentes de codificação orientados por Gemini, o servidor também expõe fluxos de trabalho de pesquisa não visuais com capacidade de tarefas que podem ser consultados e reutilizados em uma longa thread.

App de calendário de divulgação

"Mostre-me o calendário de divulgação do PIB dos EUA no horário de São Paulo" release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo") -> ui://fxmacrodata/release-calendar.html

Widget de gráfico interativo

"Mostre-me um gráfico do histórico da taxa de política do AUD"

indicator_visual_artifact(currency="aud", indicator="policy_rate")

Aplicativo de comparação de pares de FX

"Compare as taxas de política do EUR e do USD com contexto de carry"

pair_intel_task(base="eur", quote="usd")

Aplicativo de mapa de calor macro

"Mostre-me os prints macro mais fortes e mais fracos entre o G10"

macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")

Aplicativo de modelagem de cenários

"O que acontece se o Fed aumentar 50 bps a mais?"

policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)

Aplicativo de sala de guerra macro

"Monte para mim uma sala de guerra macro ao vivo de EUR/USD para o PIB do USD"

macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")

Aplicativo de replay de eventos

"Replay das surpresas do PIB do USD contra EUR/USD"

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)

Aplicativo de laboratório de cenários quant

"Execute uma distribuição de estresse de 30 dias para EUR/USD após um choque na perna base"

quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)

Capacidades, Aplicativos e Tarefas

Transporte MCP remoto

• ▸ Endpoint HTTP streamable em https://mcp.fxmacrodata.com
• ▸ Respostas JSON simples para compatibilidade com proxy/CDN
• ▸ Requisições HTTP sem estado, então cada chamada carrega seu próprio contexto de autenticação

Recursos de aplicativos MCP

Ferramentas visuais retornam dados estruturados mais metadados de recurso ui:// para que hosts compatíveis possam renderizar gráficos e aplicativos de workflow inline.

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

Ferramentas com capacidade de tarefa

Ferramentas de workflow avançadas podem ser chamadas como ferramentas normais. Hosts que suportam Tarefas MCP experimentais também podem criar uma tarefa, consultar o status com tasks/get e recuperar o payload final quando concluída.

macro_briefing_task known_at_time_task fx_backtest_task macro_research_pack_task portfolio_risk_engine_task

Prompts integrados

Clientes com reconhecimento de prompt podem descobrir workflows FX reutilizáveis por meio de prompts/list e invocá-los com prompts/get. A biblioteca de prompts pública espelha essas rotinas com prompts copiáveis, guardrails e feeds legíveis 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 Ferramentas

30 ferramentas

FXMacroData expõe uma superfície de ferramentas somente leitura. Os cartões detalhados abaixo cobrem as ferramentas principais que a maioria dos usuários chama diretamente; o conjunto completo de ferramentas públicas é agrupado aqui para descoberta rápida.

Dados principais

ping data_catalogue indicator_query release_calendar forex market_sessions cot_data commodities official_dataset_family

Artefatos visuais

indicator_visual_artifact forex_visual_artifact commodities_visual_artifact cot_visual_artifact policy_rate_differential_visual_artifact

Workflows de aplicativos e pesquisa

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

Tarefas de decisão e portfólio

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 somente leitura

currency

Retorna todos os indicadores disponíveis e metadados para um código de moeda fornecido. Mantenha include_coverage=true e use include_capabilities=true ao decidir se uma série esparsa tem observações recentes.

Entrada: currency, include_coverage?, include_capabilities?, indicator? Saída: {currency, catalogue[], coverage[], mcp_metadata}

indicator_query somente leitura

currency · indicator · dates

Retorna séries temporais de indicadores macroeconômicos para uma moeda. Suporta policy_rate, inflation, gdp, employment e mais. A paginação espelha REST: limit, offset, page e pagination.next_offset. Use mcp_metadata e result.data_quality para verificações de atualização e fonte.

Entrada: currency, indicator, start_date?, end_date?, limit?, offset?, page? Saída: {currency, indicator, pagination, data[], data_quality, mcp_metadata}

indicator_visual_artifact visual

currency · indicator · dates

Retorna séries temporais de indicadores com metadados de aplicativos MCP para que clientes compatíveis possam renderizar um artefato de gráfico interativo no contexto. Use os mesmos controles limit, offset ou page para janelas de gráfico amplas.

Entrada: currency, indicator, start_date?, end_date?, limit?, offset?, page? Saída: structuredContent + chart resource

release_calendar somente leitura app

currency · indicator?

Retorna timestamps de próximos lançamentos com filtragem opcional por indicador e conversão de fuso horário IANA solicitada, além de metadados do aplicativo de calendário de lançamentos para hosts compatíveis. Inspecione mcp_metadata antes de usar o tempo de eventos em automação.

Entrada: currency, indicator?, timezone? Saída: {currency, timezone, requested_timezone, data[], mcp_metadata} + resource_link Linhas: campos ISO em UTC, local de mercado e fuso solicitado App: ui://fxmacrodata/release-calendar.html

forex somente leitura

base · quote · dates · indicators?

Retorna linhas de taxa spot de FX com indicadores técnicos opcionais. Inspecione pair_metadata, data_quality.source_legs e data[].source no nível da linha antes de classificar um par como diretamente disponível, invertido, derivado de cruzamento, atrelado ou expandido em menor frequência.

A prioridade de fonte de FX é BIS XRU taxas diárias de USD quando disponíveis, depois fontes diárias oficiais de bancos nacionais, cruzamentos rotulados como derivados de EUR/CAD, atrelamentos oficiais de USD, médias mensais da BIS expandidas para dias úteis, taxas mensais do IMF IFS e taxas anuais do Banco Mundial. Expansões mensais e anuais permanecem rotuladas por meio de source_frequency e derivation_method.

Entrada: base, quote, start_date?, end_date?, indicators?, limit?, offset?, page? Saída: {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 somente leitura

currency · dates

Retorna dados semanais de posicionamento do CFTC Commitment of Traders (COT) para o contrato futuro de FX de uma moeda, incluindo os mesmos metadados compactos de atualização e proveniência usados por outras ferramentas MCP brutas.

Entrada: currency, start_date?, end_date? Saída: {currency, data[], data_quality, mcp_metadata}

commodities somente leitura

indicator · dates

Retorna séries temporais de indicadores de commodities e energia. Cobre ouro, petróleo (Brent/WTI) e gás natural. O parâmetro é indicator, por exemplo indicator="gold".

Entrada: indicator, start_date?, end_date? Saída: {indicator, data[], data_quality, mcp_metadata}

known_at_time_task tarefa

currency · indicator · as_of

Retorna a fatia segura ponto-no-tempo de uma série macro usando timestamps de anúncio como limite de integridade.

Entrada: currency, indicator, as_of, start_date?, end_date? Saída: {known_rows[], latest_known, integrity}

macro_regime_classifier_task tarefa

currency

Classifica o regime macro de uma moeda a partir do contexto de política, inflação, crescimento e trabalho com notas explícitas de confiança.

Entrada: currency, start_date?, end_date? Saída: {regime, latest, signals, confidence_notes}

release_risk_score_task tarefa

base · quote

Classifica a próxima pauta de lançamentos para um par usando pesos de impacto heurísticos cientes do par.

Entrada: base, quote, horizon_events? Saída: {events[], top_risk, methodology}

portfolio_risk_engine_task tarefa

portfolio

Avalia um portfólio de FX com PnL de estresse, diagnósticos de concentração, exposição por moeda e classificação de risco de eventos a partir de calendários de lançamentos.

Entrada: positions_json, stress_shock_pct?, horizon_events? Saída: {portfolio, positions, exposure_by_currency, event_risk, risk_flags}

fx_trade_setup_task tarefa

base · quote

Constrói uma configuração de par de FX voltada para traders com viés direcional, diferenciais macro, classificação de catalisadores, contexto de janela de execução e notas de invalidação.

Entrada: base, quote, horizon_events?, include_cot? Saída: {bias, spot_context, catalysts, execution, quality}

fx_backtest_task tarefa

base · quote · dates

Executa um backtest de FX transparente baseado em regras com sinais de carry/momentum, comparação com benchmark, saída de curva de equity e gating opcional de eventos em janelas de lançamento.

Entrada: base, quote, start_date?, end_date?, strategy?, momentum_lookback?, transaction_cost_bps?, initial_capital?, event_gated?, event_window_days? Saída: {metrics, benchmark, assumptions, series.equity_curve}

macro_research_pack_task tarefa

currency · indicator

Constrói um payload de pesquisa reutilizável que combina validação de catálogo, histórico de séries, próximo timing de lançamento e contexto opcional de FX.

Entrada: currency, indicator, base?, quote?, start_date?, end_date? Saída: {catalogue, series, next_release, fx_context}

Playbooks de Pesquisa

Os melhores workflows MCP combinam descoberta, recuperação exata de dados e uma etapa final de síntese. Esses playbooks são os padrões que recomendamos para analistas, traders e construtores de agentes que querem respostas macro confiáveis em vez de chamadas de ferramentas isoladas.

Dia de decisão do banco central

Use antes de uma decisão do Fed, BCE, BoE, BoJ, RBA, BoC, SNB ou RBNZ. O assistente deve verificar a taxa de política mais recente, o caminho da inflação, o mercado de trabalho, o próximo lançamento agendado e a classificação de regime antes de escrever o briefing.

macro_regime_classifier_task(currency="usd") -> indicator_query(policy_rate) -> release_calendar(policy_rate)

Reação de FX pós-lançamento

Use após prints de CPI, PIB, folhas de pagamento, desemprego ou vendas no varejo. O agente deve comparar a linha mais recente com o contexto anterior, reproduzir o histórico recente de eventos e mapear implicações para o par de FX relevante.

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd")

Checklist macro pré-negociação

Use antes de expressar uma visão em um par de moedas. O assistente deve inspecionar o contexto spot, carry, divergência de inflação, próximos lançamentos, sessões atuais e posicionamento COT quando disponível.

fx_trade_setup_task(base="eur", quote="usd", horizon_events=4)

Varredura de risco de eventos do portfólio

Use quando você tem várias posições de FX e precisa saber quais eventos futuros importam mais. A tarefa mapeia exposições por moeda, estima PnL de estresse e classifica riscos de eventos.

portfolio_risk_engine_task(positions_json='[{"base":"eur","quote":"usd","side":"long","notional":100000}]')

Higiene de backtest ponto-no-tempo

Use quando uma estratégia depende de lançamentos macro. O assistente deve evitar lookahead filtrando linhas por timestamps de anúncio e, quando relevante, aplicando gating de eventos na janela de backtest.

known_at_time_task(currency="usd", indicator="gdp", as_of="2025-01-15")

Aplicativos macro construídos por agentes

Use quando um agente de codificação está construindo dashboards, notebooks, alertas ou widgets. Comece com descoberta de catálogo, peça formas exatas de endpoints e então gere código contra URLs de produção e exemplos de autenticação por parâmetros de consulta.

data_catalogue(currency="aud") -> indicator_query(currency="aud", indicator="policy_rate")

Exemplos de Uso

Verificação de conectividade

"Execute a ferramenta ping do FXMacroData"

ping()

Série temporal de inflação do USD

"Obtenha dados de inflação do USD de 2024-01-01 a 2025-01-01" indicator_query(currency="usd", indicator="inflation", start_date="2024-01-01", end_date="2025-01-01")

Descoberta do catálogo AUD

"Quais indicadores AUD estão disponíveis e quais têm cobertura recente?"

data_catalogue(currency="aud", include_coverage=true, include_capabilities=true)

Verificação de atualização e fonte

"Obtenha o PIB do EUR e informe se o resultado é atualizado, oficial, substituto, proxy ou derivado."

indicator_query(currency="eur", indicator="gdp") -> inspecione mcp_metadata e result.data_quality

Calendário de divulgações USD

"Mostre as próximas datas de divulgação do PIB dos EUA no horário do Brasil"

release_calendar(currency="usd", indicator="gdp", timezone="America/Sao_Paulo")

Taxas spot EUR/USD

"Mostre as taxas spot EUR/USD com RSI e SMA, e informe se o par foi direto, invertido ou derivado."

forex(base="eur", quote="usd", start_date="2024-01-01", end_date="2024-12-31", indicators="sma_20,rsi_14") -> inspecione pair_metadata e data_quality.source_legs

Artefato de gráfico — taxa de política do EUR

"Plote a taxa de política do EUR como um gráfico"

indicator_visual_artifact(currency="eur", indicator="policy_rate")

Sessões FX ao vivo

"Quais sessões de FX estão abertas agora?"

market_sessions()

Posicionamento COT GBP

"Mostre dados de posicionamento de futuros de GBP"

cot_data(currency="gbp", start_date="2024-01-01")

Série de preços do ouro

"Obtenha os preços do ouro para 2024"

commodities(indicator="gold", start_date="2024-01-01", end_date="2024-12-31")

Mapa de calor entre mercados

"Mostre os vencedores e perdedores macro em USD, EUR, GBP e JPY"

macro_heatmap_task(currencies="usd,eur,gbp,jpy", indicators="policy_rate,inflation,gdp")

Modelador de cenários de política

"E se o Fed aumentar 50 pontos-base a mais?"

policy_scenario_modeler_task(base="usd", quote="jpy", shock_leg="base", shock_bps=50)

Inteligência de sala de guerra macro

"Monte uma sala de guerra macro para EUR/USD e PIB dos EUA"

macro_war_room_task(base="eur", quote="usd", currency="usd", indicator="gdp")

Replay de eventos pontuais

"Replay dos eventos recentes do PIB dos EUA com contexto EUR/USD"

event_impact_replay_task(currency="usd", indicator="gdp", base="eur", quote="usd", lookback_events=12)

Laboratório de estresse de cenários quant

"Execute um cenário avançado de EUR/USD com bandas de volatilidade"

quant_scenario_lab_task(base="eur", quote="usd", shock_leg="base", shock_bps=50, annualized_volatility_pct=8, horizon_days=30)

Fatia macro pontual

"Mostre apenas o que era conhecido sobre o PIB dos EUA até 15 de janeiro de 2025"

known_at_time_task(currency="usd", indicator="gdp", as_of="2025-01-15T00:00:00Z")

Classificador de regime macro

"Classifique o regime macro atual do USD"

macro_regime_classifier_task(currency="usd")

Pontuação de risco de divulgação do par

"Quais são os maiores riscos programados para EUR/USD a seguir?"

release_risk_score_task(base="eur", quote="usd", horizon_events=6)

Motor de risco de portfólio

"Pontue o risco e a exposição a eventos para minha carteira EUR/USD e 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)

Setup de FX pronto para trader

"Monte um setup de trade para EUR/USD com catalisadores e notas de invalidação"

fx_trade_setup_task(base="eur", quote="usd", horizon_events=4)

Backtest de estratégia com gatilho de eventos

"Faça backtest de carry + momentum de EUR/USD em torno de janelas de divulgação macro com custos de negociação 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)

Pacote de pesquisa persistente

"Monte um payload de pesquisa canônico para o PIB dos EUA com contexto EUR/USD"

macro_research_pack_task(currency="usd", indicator="gdp", base="eur", quote="usd")

Autenticação

Sem autenticação — Público (USD)

• ▸ Conecte-se apenas com a URL simples
• ▸ Indicadores USD (últimos 90 dias), taxas de FX, catálogo, calendário, sessões
• ▸ Nenhuma chave de API ou OAuth necessária

Acesso total — OAuth 2.0 + PKCE

• ▸ Fluxo de código de autorização com PKCE
• ▸ Escopo: fxmacrodata.read
• ▸ Transporte Bearer: Authorization: Bearer <token>
• ▸ Registro Dinâmico de Clientes para clientes que se autorregistram

Acesso total — Chave de API

• ▸ Envie como variável de ambiente do tipo bearer-token ou anexe à URL do MCP
• ▸ /mcp?api_key=YOUR_KEY
• ▸ Melhor para runtimes de IDE / SDK sem OAuth

Níveis de acesso: Indicadores USD (últimos 90 dias) estão disponíveis sem chave até 100 solicitações/dia. Taxas de FX, catálogo, calendário e sessões permanecem públicos para avaliação. Indicadores não-USD, uso de USD em maior volume, o arquivo histórico completo de USD, COT e commodities exigem uma chave de API. Obtenha acesso →

Endpoints OAuth

Autorização:https://api.fxmacrodata.com/oauth/authorize

Token:https://api.fxmacrodata.com/oauth/token

Registro:https://api.fxmacrodata.com/oauth/register

Metadados:https://fxmacrodata.com/.well-known/oauth-authorization-server

Recurso protegido:https://api.fxmacrodata.com/.well-known/oauth-protected-resource

Suporte a clientes OAuth

• ▸ Clientes PKCE públicos com token_endpoint_auth_method=none
• ▸ Clientes confidenciais usando client_secret_post ou client_secret_basic
• ▸ Tokens Bearer resolvidos de volta ao contexto de assinatura da chave de API para ferramentas protegidas

Suporte a URI de redirecionamento

A maioria dos hosts MCP suportados descobre as configurações corretas de OAuth a partir da URL de metadados acima. Para clientes personalizados, registre a URI de redirecionamento exigida pelo seu host MCP e mantenha as credenciais do cliente fora de arquivos de configuração compartilhados.

Detalhes do Servidor

URL base do MCP

https://mcp.fxmacrodata.com

Transporte

HTTP Streamable

Segurança

HTTPS / TLS

Status

Disponibilidade Geral

Disponibilidade

Endpoint HTTPS de produção

Rotas REST

29 endpoints públicos

Validação 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"}}}'

Referência de Erros

Status	Significado
406	Cabeçalho Accept não suportado ou método HTTP incorreto (por exemplo, chamadas de protocolo não-JSON)
400	Formato de solicitação MCP inválido
401/403	Falha de autenticação ou autorização em dados protegidos
200	Inicialização MCP válida com Accept: application/json retorna capacidades e instruções do servidor

Pronto para Resposta de IA

Fatos-Chave

Página

Servidor MCP

Seção

Documentação

URL canônica

https://fxmacrodata.com/documentation/mcp-server

Fonte

FXMacroData editorial e referências de publicadores oficiais

Última Atualização

Consulte os metadados da página

Procedência e Confiança

Cite a URL canônica e o campo de fonte acima. Quando disponível, esta página mapeia para divulgações oficiais de publicadores e atualizações com registro de data e hora.

Perguntas e Respostas Rápidas

Sobre o que é esta página? Esta página explica o Servidor MCP com contexto diretamente utilizável para fluxos de trabalho de negociação, pesquisa e API.

Qual fonte deve ser citada? Use a URL canônica e o campo de fonte listado; cite referências oficiais de publicadores quando disponíveis.

Quão atualizado é este conteúdo? O valor de última atualização acima reflete os metadados da página ou o registro de data e hora mais recente dos dados disponíveis.

Isso pode ser usado em assistentes de IA? Sim. Esta seção é intencionalmente estruturada para recuperação e citação em assistentes de chat.

Pacotes de Prompt

Use estes no ChatGPT, Claude, Gemini, Mistral, Perplexity ou Grok para saídas consistentes e cientes da fonte.