_ registry / mcp + a2a streamable-http · checked 57m ago

FX Macrodata API

https://mcp.fxmacrodata.com

Registry code: 8e9ed03031feebee

api record

FXMacroData is a read-only MCP server for official-source FX, macroeconomic, and central-bank data across 22 production catalogue currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Search this server when the user asks about currency pairs, FX spot rates, policy rates, CPI/inflation, GDP, unemployment, payrolls/NFP, PCE/PPI, retail sales, trade balance, current account, bond yields, commodities, COT positioning, FX sessions, economic calendars, central-bank decisions, or macro event risk.

ACCESS MODEL - read this before…

endpoint
https://mcp.fxmacrodata.com/mcp
door code
84a03e49397b05c3
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing
karma
0 · newcomer
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
496ms

last good check

priced tools
0

of 50 tools

_ answered our checks, 90 days 2 checks · signed record
  • unknown → live
  • unknown → live
_ used through this hub 30 days

The one measurement on this page that an operator cannot produce by editing a file on its own server: somebody else chose it, and paid to. Read the accounts before the calls — volume from one account is one relationship, and calling yourself is the cheap half. Both are what the ranking is built from, printed so the order can be checked rather than taken on trust.

accounts
0

distinct, expensive to fake

calls served
0

successful, last 30 days

_ what it can do 50 tools
1 open2 auth-required 47 never probed 3 of 50 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • commodities open 57m ago

    Get historical price series for supported commodity indicators using the exact slugs advertised by this schema. Requires an API key. Supported indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "commoditiesArguments",
  "properties": {
    "symbol": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "crude_oil_inventories",
        "gold",
        "natural_gas",
        "natural_gas_storage",
        "oil_brent",
        "oil_wti"
      ],
      "description": "Backward-compatible alias for `indicator`. Prefer `indicator` in new calls."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "crude_oil_inventories",
        "gold",
        "natural_gas",
        "natural_gas_storage",
        "oil_brent",
        "oil_wti"
      ],
      "description": "Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 78 lines
  • fx_reference_sources auth-required 57m ago

    List public official FX reference-rate sources and their source policy before requesting a pair-specific intraday reference-rate series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "fx_reference_sourcesArguments",
  "properties": {}
}
    arguments 5 lines
  • announcement_changes auth-required 57m ago

    Poll recently ingested macro announcement changes with a resumable cursor. This is the bounded MCP-safe companion to the release-event stream: use the returned next_cursor as since on a later call instead of holding an unbounded streaming tool invocation open. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "announcement_changesArguments",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 500,
      "minimum": 1,
      "examples": [
        50,
        100
      ],
      "description": "Maximum matching change events to return."
    },
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2026-07-21T00:00:00Z"
      ],
      "description": "Optional previous next_cursor, ISO 8601 timestamp, or Unix epoch seconds."
    },
    "payload": {
      "type": "string",
      "default": "compact",
      "examples": [
        "compact",
        "full"
      ],
      "description": "Event payload shape: compact trigger rows or full announcement rows."
    },
    "currencies": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd,eur",
        "g10"
      ],
      "description": "Optional comma-separated currency codes, `g10`, or `all`. Without subscriber access, results are limited to the public scope."
    },
    "indicators": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "inflation,policy_rate"
      ],
      "description": "Optional comma-separated announcement indicator slugs."
    }
  }
}
    arguments 72 lines
  • risk_sentiment unknown never probed

    Return the global risk-on/risk-off sentiment series used for FX regime analysis. The result includes a derived composite score, regime label, component contributions, pagination, and data_quality metadata. Use this for cross-asset regime context before classifying high-beta, safe-haven, commodity, or USD-defensive FX conditions. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "risk_sentimentArguments",
  "properties": {
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2026-06-30"
      ],
      "description": "Optional inclusive end date in YYYY-MM-DD format."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2026-06-01"
      ],
      "description": "Optional inclusive start date in YYYY-MM-DD format."
    }
  }
}
    arguments 36 lines
  • macro_news unknown never probed

    Return recent official central-bank news and press-release headlines for a currency. Use this when a report needs headline context for central-bank policy, inflation, employment, GDP, trade, fiscal, energy, or commodity narratives. The tool returns official-source headline rows and lightweight keyword-derived affected_indicators and sentiment fields when a headline is classifiable. Supported currencies: AUD, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, ILS, INR, JPY, NGN, NOK, NZD, PEN, PLN, SEK, USD, ZAR. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "macro_newsArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "examples": [
        10,
        20
      ],
      "description": "Maximum number of headline rows to request."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "examples": [
        0
      ],
      "description": "Zero-based headline offset."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CZK, DKK, EUR, GBP, HKD, ILS, INR, JPY, NGN, NOK, NZD, PEN, PLN, SEK, USD, ZAR."
    },
    "lookback_days": {
      "type": "integer",
      "default": 7,
      "maximum": 90,
      "minimum": 1,
      "examples": [
        7,
        30
      ],
      "description": "Maximum age of returned headlines in calendar days when headline timestamps are available."
    }
  }
}
    arguments 50 lines
  • macro_regime_classifier_task unknown never probed

    Classify a currency's macro regime using policy rate, inflation, GDP, and unemployment context, with explicit assumptions and confidence notes. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "macro_regime_classifier_taskArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 51 lines
  • release_risk_score_task unknown never probed

    Score upcoming releases for a currency pair using release-calendar proximity and indicator-level heuristics. Supports MCP Tasks for async execution when clients send task-augmented requests.

    mcp-tool

    {
  "type": "object",
  "title": "release_risk_score_taskArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "horizon_events": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 6,
      "examples": [
        4,
        6,
        10
      ],
      "description": "Maximum release events per currency to score."
    }
  }
}
    arguments 45 lines
  • portfolio_risk_engine_task unknown never probed

    Analyze a multi-position FX book for concentration, stress exposure, and event-driven catalyst risk. Supports MCP Tasks for async execution when clients send task-augmented requests.

    mcp-tool

    {
  "type": "object",
  "title": "portfolio_risk_engine_taskArguments",
  "required": [
    "positions_json"
  ],
  "properties": {
    "horizon_events": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 4,
      "examples": [
        3,
        4,
        8
      ],
      "description": "Maximum release events to consider per currency leg."
    },
    "positions_json": {
      "type": "string",
      "examples": [
        "[{\"base\":\"eur\",\"quote\":\"usd\",\"side\":\"long\",\"notional\":100000},{\"base\":\"gbp\",\"quote\":\"usd\",\"side\":\"short\",\"notional\":80000}]"
      ],
      "description": "JSON array of FX positions. Each item should include base, quote, side (long/short), and notional. Example: [{\"base\":\"eur\",\"quote\":\"usd\",\"side\":\"long\",\"notional\":100000}]"
    },
    "stress_shock_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 1,
      "examples": [
        0.5,
        1,
        2
      ],
      "description": "Stress shock in percent applied to each pair."
    }
  }
}
    arguments 50 lines
  • fx_trade_setup_task unknown never probed

    Build a trader-oriented FX pair setup using spot context, macro differentials, upcoming catalyst risk, and optional COT positioning. Supports MCP Tasks for async execution when clients send task-augmented requests.

    mcp-tool

    {
  "type": "object",
  "title": "fx_trade_setup_taskArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud"
      ],
      "description": "Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "include_cot": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": false,
      "examples": [
        true,
        false
      ],
      "description": "When true, attempt to include COT positioning context for both legs."
    },
    "horizon_events": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 4,
      "examples": [
        3,
        4,
        6
      ],
      "description": "Maximum upcoming catalysts per leg to rank."
    }
  }
}
    arguments 61 lines
  • subscribe_for_mcp_access unknown never probed

    Open subscription options when a user needs to unlock MCP app visuals, charts, and advanced analytical tools. Returns a direct checkout path.

    mcp-tool

    {
  "type": "object",
  "title": "subscribe_for_mcp_accessArguments",
  "properties": {}
}
    arguments 5 lines
  • data_catalogue unknown never probed

    List every macroeconomic indicator FXMacroData publishes for a currency, with units, frequency, and coverage/freshness metadata. ALWAYS call this first when the user asks about a country's macro data — it returns the exact `indicator` slug strings to pass to indicator_query, release_calendar, and indicator_visual_artifact. Check `coverage` before calling indicator_query; stale, partial, or unavailable rows are not suitable for real-time carry or inflation analysis. Supported currencies (lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "data_catalogueArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "core_inflation"
      ],
      "description": "Optional indicator slug to limit coverage calculation, for example `core_inflation`. Use this when you already know the candidate series."
    },
    "include_coverage": {
      "type": "boolean",
      "default": true,
      "examples": [
        true
      ],
      "description": "Include coverage/freshness rows with latest_available_date, coverage_quality, has_recent_data, and recent_observation_count. Leave true when deciding whether an indicator is usable before calling indicator_query."
    },
    "include_capabilities": {
      "type": "boolean",
      "default": false,
      "examples": [
        false
      ],
      "description": "Include machine-readable indicator capabilities when the API supports them, such as supported transformations, history availability, and release-calendar linkage."
    }
  }
}
    arguments 50 lines
  • policy_rate_differential_visual_artifact unknown never probed

    Build a two-series chart comparing base and quote policy-rate history to visualize the rate differential setup for an FX pair. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "policy_rate_differential_visual_artifactArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 61 lines
  • event_impact_replay_task unknown never probed

    Replay verified publication events against measured 1, 5 and 20-observation FX reference returns. Daily windows exclude the publication-day fixing; changes from previous actuals are not consensus surprises. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "event_impact_replay_taskArguments",
  "required": [
    "currency",
    "indicator"
  ],
  "properties": {
    "base": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "eur",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "FX base currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "usd",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "FX quote currency for market context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp"
      ],
      "description": "Currency for macro event series, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "inflation",
        "policy_rate",
        "gdp"
      ],
      "description": "Indicator slug for event replay. Supported examples: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    },
    "lookback_events": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 12,
      "examples": [
        6,
        12,
        24
      ],
      "description": "Maximum number of recent events to include in replay."
    }
  }
}
    arguments 112 lines
  • quant_scenario_lab_task unknown never probed

    Run an expanded quant-style policy scenario for an FX pair with deterministic projection, stress percentiles, and horizon assumptions. Supports MCP Tasks for async execution when clients send task-augmented requests.

    mcp-tool

    {
  "type": "object",
  "title": "quant_scenario_lab_taskArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "shock_bps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 50,
      "examples": [
        25,
        50,
        -25
      ],
      "description": "Policy shock size in basis points (100 bps = 1.00 percentage point)."
    },
    "shock_leg": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "base",
      "examples": [
        "base",
        "quote"
      ],
      "description": "Which leg receives the policy shock: base or quote."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    },
    "horizon_days": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 30,
      "examples": [
        7,
        30,
        90
      ],
      "description": "Scenario horizon in calendar days."
    },
    "elasticity_per_100bps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 0.8,
      "examples": [
        0.5,
        0.8,
        1.2
      ],
      "description": "Heuristic percent FX move per 100 bps spread change."
    },
    "annualized_volatility_pct": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 8,
      "examples": [
        6,
        8,
        12
      ],
      "description": "Annualized volatility assumption (percent) for stress-band construction."
    }
  }
}
    arguments 145 lines
  • known_at_time_task unknown never probed

    Return the slice of a macro series that would have been known at a specific timestamp, selecting verified value vintages before pagination. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "known_at_time_taskArguments",
  "required": [
    "currency",
    "indicator",
    "as_of"
  ],
  "properties": {
    "as_of": {
      "type": "string",
      "examples": [
        "2025-01-31T13:30:00Z",
        "2025-01-31"
      ],
      "description": "UTC ISO-8601 timestamp or YYYY-MM-DD cutoff (start of UTC day). Only verified value vintages eligible on the selected availability clock are returned."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Indicator slug for the given currency. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    },
    "availability": {
      "type": "string",
      "default": "public",
      "description": "Historical availability clock: public source-publication evidence or captured per-value observation evidence."
    },
    "dataset_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional content version returned by a previous replay; a changed dataset returns an error."
    }
  }
}
    arguments 88 lines
  • cot_data unknown never probed

    Get weekly CFTC Commitment of Traders (COT) positioning data for a currency's FX futures contract on the CME. Use this when the user asks about speculator positioning, non-commercial longs vs shorts, hedge-fund FX positioning, or wants to gauge sentiment extremes. Returns weekly snapshots with long/short open interest by trader category. Updated every Friday at 15:30 ET reflecting the Tuesday cutoff. Requires an API key. Supported currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "cot_dataArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "eur",
        "jpy",
        "gbp",
        "aud"
      ],
      "description": "3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 51 lines
  • ping unknown never probed

    Quick health check that confirms the FXMacroData API and MCP server are reachable. Use this only if other tools fail unexpectedly — it is not needed before normal calls.

    mcp-tool

    {
  "type": "object",
  "title": "pingArguments",
  "properties": {}
}
    arguments 5 lines
  • mcp_capabilities unknown never probed

    Explain what the FXMacroData MCP server can do, which tools render MCP Apps, which tools return plain rows, what is public versus subscriber-only, and how to choose tools across ChatGPT, Claude, Cursor, Codex, and plain MCP clients. Use this when a user asks what is available, why visuals are not showing, or how to get the same result in a different interface.

    mcp-tool

    {
  "type": "object",
  "title": "mcp_capabilitiesArguments",
  "properties": {}
}
    arguments 5 lines
  • mcp_auth_guide unknown never probed

    Explain which authentication mode to use for FXMacroData MCP across major clients and platforms. Use this when the user asks whether to use OAuth, an API key, a bearer token, ChatGPT/OpenAI Apps, Claude/Anthropic, Microsoft/VS Code/Copilot-style clients, AstrBot, Cursor, Codex, local scripts, or CI.

    mcp-tool

    {
  "type": "object",
  "title": "mcp_auth_guideArguments",
  "properties": {}
}
    arguments 5 lines
  • release_calendar unknown never probed

    Get upcoming scheduled macroeconomic release timestamps for a currency. Use this when the user asks 'when is the next CPI/GDP/payrolls/policy decision', or to plan a trade around a known release. Returns ISO-8601 announcement_datetime values in UTC plus market-local timestamps. Pass `timezone` for an additional `announcement_datetime_requested_timezone` field. Each row has a `release` string with the indicator name and a `currency` code. Unbounded calls return future releases only; do not show stale past rows unless the user explicitly asks for historical/past calendar data. Consumer-facing clients should present the returned markdown agenda or render the Release Calendar App resource; do not summarize this tool as only a row count. Pass an optional `indicator` filter to narrow to a single series. Pass optional `start_date` and `end_date` bounds when the user mentions a month, week, day, or explicit date range. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Call data_catalogue(currency) for the exact indicator slugs; the `indicator` parameter below also lists them. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "release_calendarArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "America/Sao_Paulo",
        "Australia/Sydney"
      ],
      "description": "Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Optional indicator slug to narrow results. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 85 lines
  • release_calendar_visual_artifact unknown never probed

    Same payload as release_calendar, but named as an explicit visual artifact tool so compatible MCP Apps clients render the interactive Release Calendar App inline. Prefer this by default when the user asks to show, display, visualize, or render a macro release calendar, especially for prompts like 'show me the AUD release calendar'. Only prefer plain release_calendar when the user explicitly asks for a raw table, JSON, exact rows, or text-only output. Pass optional `indicator`, `start_date`, and `end_date` filters when the user names a specific series, month, week, day, or date range. Pass `timezone` when the user asks for local times in a specific city or region. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Call data_catalogue(currency) for the exact indicator slugs; the `indicator` parameter below also lists them. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "release_calendar_visual_artifactArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, COMM, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "timezone": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "America/Sao_Paulo",
        "Australia/Sydney"
      ],
      "description": "Optional IANA timezone for an additional converted timestamp, for example America/Sao_Paulo."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Optional indicator slug to narrow results. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 85 lines
  • event_predictions unknown never probed

    Return stored forecasts, consensus-style predictions, central-bank projections, survey forecasts, IMF forecasts, nowcasts, or FXMacroData blended predictions for macro announcements. Use this with release_calendar and indicator_query when a report needs actual-vs-consensus, prior-vs-forecast, or event-surprise context. Rows are keyed by announcement_id/date/indicator and include prediction source metadata. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Call data_catalogue(currency) for the exact indicator slugs; the `indicator` parameter below also lists them. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "event_predictionsArguments",
  "required": [
    "currency",
    "indicator"
  ],
  "properties": {
    "page": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        1
      ],
      "description": "One-based page number. When supplied, overrides offset."
    },
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Historical publication cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight. Later forecasts are excluded."
    },
    "basis": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Real or nominal selector, matching the announcement series."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum prediction groups to return. Defaults to 20; maximum 100."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "examples": [
        0,
        20
      ],
      "description": "Zero-based prediction-group offset."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound by reference-period date, YYYY-MM-DD."
    },
    "frequency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Returned change basis selector, matching the announcement series."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Required indicator slug. Currency-wide prediction reads are not supported. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound by reference-period date, YYYY-MM-DD."
    },
    "before_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Exclusive period-date cursor for event-linked groups; use the prior response's next_cursor."
    },
    "seasonality": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Seasonal adjustment selector, matching the announcement series."
    },
    "annualization": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Annualization selector, matching the announcement series."
    },
    "official_limit": {
      "type": "integer",
      "default": 500,
      "maximum": 2000,
      "minimum": 0,
      "description": "Maximum native-period official forecasts; 0 omits this section. Inspect official_forecasts_truncated."
    },
    "prediction_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "fxmacrodata"
      ],
      "description": "Optional legacy forecast-type filter, kept for existing clients. Prefer prediction_class: compiled_consensus, forecaster_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata."
    },
    "pre_release_only": {
      "type": "boolean",
      "default": true,
      "description": "Require event-linked forecasts to have been generated before the announcement."
    },
    "prediction_class": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Forecast production class: compiled_consensus, forecaster_survey, market_implied, model_nowcast, central_bank_projection, institutional_projection or fxmacrodata."
    },
    "prediction_source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "ecb_spf",
        "philly_fed_spf"
      ],
      "description": "Optional source slug filter, for example ecb_spf or philly_fed_spf."
    },
    "period_aggregation": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Period aggregation selector, matching the announcement series."
    },
    "event_compatible_only": {
      "type": "boolean",
      "default": false,
      "description": "Restrict event-linked data to verified matching target periods, units and economic concepts. Native official_forecasts remain a separate section."
    }
  }
}
    arguments 242 lines
  • latest_announcements unknown never probed

    Return the latest stored macroeconomic value for every available indicator in one currency. Use this for a compact current macro snapshot after data_catalogue has confirmed the currency coverage. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "latest_announcementsArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive)."
    }
  }
}
    arguments 19 lines
  • press_releases unknown never probed

    Return the public central-bank press-release archive for a currency without adding derived sentiment or indicator classifications. Use macro_news when a headline summary is useful; use this tool when the original official release rows matter. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "press_releasesArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Zero-based row offset."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive)."
    }
  }
}
    arguments 32 lines
  • macro_factor unknown never probed

    Return a precomputed macro factor for one currency, with optional stored component scores and source references. Use this for a documented factor value, not as a substitute for inspecting its underlying macro releases. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "macro_factorArguments",
  "required": [
    "currency",
    "factor"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "factor": {
      "type": "string",
      "examples": [
        "monetary_stance"
      ],
      "description": "Factor slug, for example monetary_stance."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Zero-based row offset."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive)."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive end date, YYYY-MM-DD."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive start date, YYYY-MM-DD."
    },
    "include_sources": {
      "type": "boolean",
      "default": false,
      "description": "Include public source endpoint references when available."
    },
    "include_components": {
      "type": "boolean",
      "default": false,
      "description": "Include stored component scores when available."
    }
  }
}
    arguments 74 lines
  • fx_reference_universe unknown never probed

    List the public FX reference-rate pair universe, optionally filtered by currency or source id. Call this before requesting an intraday reference-rate series. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "fx_reference_universeArguments",
  "properties": {
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "ecb_eurofxref_daily"
      ],
      "description": "Optional official source id filter."
    },
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd"
      ],
      "description": "Optional 3-letter currency filter."
    }
  }
}
    arguments 36 lines
  • fx_intraday_reference_rates unknown never probed

    Return subscriber intraday official FX reference-rate observations for one pair. Call fx_reference_universe first to verify pair and source availability. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "fx_intraday_reference_ratesArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur"
      ],
      "description": "Base currency code."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd"
      ],
      "description": "Quote currency code."
    },
    "end_time": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2026-07-21T00:00:00Z"
      ],
      "description": "Optional inclusive RFC 3339 source timestamp."
    },
    "start_time": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2026-07-20T00:00:00Z"
      ],
      "description": "Optional inclusive RFC 3339 source timestamp."
    }
  }
}
    arguments 54 lines
  • rate_curve unknown never probed

    Return official government-nominal curve nodes, slopes, or derived forward segments for one currency. This is a subscriber data tool and preserves the endpoint's requested view and method metadata. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "rate_curveArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional target date, YYYY-MM-DD."
    },
    "view": {
      "type": "string",
      "default": "nodes",
      "examples": [
        "nodes",
        "slopes",
        "forwards"
      ],
      "description": "Curve view: nodes, slopes, or forwards."
    },
    "method": {
      "type": "string",
      "default": "derived_from_spot_nodes",
      "description": "Forward derivation method when view is forwards."
    },
    "metric": {
      "type": "string",
      "default": "spot",
      "description": "Curve metric."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter currency code."
    },
    "curve_family": {
      "type": "string",
      "default": "government_nominal",
      "description": "Official curve family."
    }
  }
}
    arguments 56 lines
  • rate_differentials unknown never probed

    Return the stored or derived rate differential for one FX pair. Use the returned measure, rate type, curve family, and tenor metadata when explaining the result. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "rate_differentialsArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "aud"
      ],
      "description": "Base currency code."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum rows to return."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd"
      ],
      "description": "Quote currency code."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Zero-based row offset."
    },
    "measure": {
      "type": "string",
      "default": "auto",
      "examples": [
        "auto",
        "policy_rate",
        "gov_bond_10y"
      ],
      "description": "Shared rate measure to compare across the pair."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive end date, YYYY-MM-DD."
    },
    "rate_type": {
      "type": "string",
      "default": "spot",
      "examples": [
        "spot",
        "forward"
      ],
      "description": "Differential type: spot or forward."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional inclusive start date, YYYY-MM-DD."
    },
    "curve_family": {
      "type": "string",
      "default": "government_nominal",
      "description": "Curve family when rate_type is forward."
    },
    "end_tenor_years": {
      "type": "number",
      "default": 5,
      "description": "End tenor in years for forward differentials."
    },
    "start_tenor_years": {
      "type": "number",
      "default": 2,
      "description": "Start tenor in years for forward differentials."
    }
  }
}
    arguments 95 lines
  • latest_commodities unknown never probed

    Return the latest stored value for every available commodity indicator in one response. This subscriber tool is the batch counterpart to commodities. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "latest_commoditiesArguments",
  "properties": {}
}
    arguments 5 lines
  • forex unknown never probed

    Get raw historical FX spot-rate rows for a currency pair (e.g. EUR/USD, USD/JPY). Prefer this tool when the user explicitly wants a plain-text table, raw rows, exact values, JSON-like data, or technical-indicator series (SMA, EMA, RSI, MACD, Bollinger Bands, etc.) computed from spot without a chart. If the user asks more generally to show/tell/explain the last few weeks or months of a pair, prefer forex_visual_artifact instead so the client can render a chart. Daily granularity from official central-bank reference rates with full multi-year history. Supported currencies (use lowercase 3-letter codes): AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Optional `indicators` parameter accepts a comma-separated list of technical indicator slugs to attach to each row. Supported indicator values: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "forexArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD. Defaults to today."
    },
    "indicators": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "sma_50,sma_200",
        "rsi_14",
        "ema_20,atr_14"
      ],
      "description": "Comma-separated technical-indicator slugs to attach to each row. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD. Defaults to ~5 years ago."
    }
  }
}
    arguments 78 lines
  • seasonality unknown never probed

    Get monthly return seasonality for an FX pair or XAU/USD. Use this when the user asks for seasonal patterns, month-of-year tendency, historical monthly win rate, or XAUUSD/gold seasonality. Returns monthly average return, median return, win rate, sample size, dispersion, and per-year monthly returns from stored FX or gold series.

    mcp-tool

    {
  "type": "object",
  "title": "seasonalityArguments",
  "required": [
    "instrument"
  ],
  "properties": {
    "month": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "July"
      ],
      "description": "Optional month filter, 1-12 or name such as July."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD. Defaults to today."
    },
    "instrument": {
      "type": "string",
      "examples": [
        "XAUUSD",
        "EURUSD",
        "AUDUSD"
      ],
      "description": "Six-letter pair such as EURUSD, AUDUSD, USDJPY, or XAUUSD. Slashes and separators are accepted by the REST endpoint only when passed as a single string."
    },
    "lookback_years": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 10,
      "examples": [
        10
      ],
      "description": "Number of years to include, 2-30. Defaults to 10."
    }
  }
}
    arguments 64 lines
  • indicator_query unknown never probed

    Get a paginated historical time series of a single macroeconomic indicator for a currency, sourced directly from the official central bank or statistical agency. Use this for CPI/inflation, GDP, unemployment, policy rates, bond yields, payrolls, retail sales, PCE, PPI, trade balance, current account, money supply, and similar series. Each row returns `date` (economic reference period), `val` (numeric), and separate publication evidence. Use `as_of` for historically eligible values; current values can include later revisions. Use known_at_time_task for a complete, verified historical slice. This plain tool returns raw rows for data workflows. Use `indicator_visual_artifact` when the host should render an MCP App chart. Use `limit`, `offset`, or `page` to page through broad histories; check `pagination.next_offset` and `pagination.page_includes_latest_available` in the result. Responses default to official-source rows only; prohibited private aggregator rows are always removed. Always call data_catalogue(currency) first to get the exact indicator slug. USD indicators are free; non-USD requires API key. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Call data_catalogue(currency) for the exact indicator slugs; the `indicator` parameter below also lists them. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "indicator_queryArguments",
  "properties": {
    "page": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        1,
        2
      ],
      "description": "One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`."
    },
    "slug": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd:cpi",
        "jpy:policy_rate",
        "eur:gdp"
      ],
      "description": "Optional compound `\"<currency>:<indicator>\"` slug (e.g. `\"usd:cpi\"`, `\"jpy:policy_rate\"`). Many small / open tool-calling models concatenate the two parts anyway. When supplied, overrides `currency` and `indicator`."
    },
    "as_of": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Historical decision cutoff with explicit timezone, or YYYY-MM-DD at UTC midnight; verifies vintages before returning rows."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20,
        100
      ],
      "description": "Maximum rows to return from the existing REST pagination path. Defaults to 20; maximum 100."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "examples": [
        0,
        20
      ],
      "description": "Zero-based row offset after most-recent-first ordering."
    },
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Optional if `slug` is provided as a `\"usd:cpi\"`-style compound. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Indicator slug for the given currency. Optional if `slug` is provided as a `\"usd:cpi\"`-style compound. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "revisions": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Revision view: latest, first, final or all. Historical replay uses latest among vintages eligible at as_of."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    },
    "value_mode": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Value mode: normalized or source. Historical replay defaults to unchanged source values and requires raw series mode."
    },
    "series_mode": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Series mode: canonical or raw. Historical replay defaults to raw."
    },
    "availability": {
      "type": "string",
      "default": "public",
      "description": "Replay clock: public or captured. Used with as_of."
    },
    "official_only": {
      "type": "boolean",
      "default": true,
      "examples": [
        true
      ],
      "description": "When true, return only official-source rows and remove explicit fallback observations. Prohibited private aggregator rows are always removed."
    },
    "dataset_version": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional content version; use the first page's version on subsequent pages to reject changed data."
    }
  }
}
    arguments 202 lines
  • plot_visual_artifact unknown never probed

    Build a generic MCP Apps chart from one or more FXMacroData endpoint families. Use this for arbitrary plot requests, multi-series charts, and actual-vs-consensus views that need to combine announcements with event_predictions. Supported series sources are announcements, predictions, forex, commodities, and cot. For example, plot USD policy-rate midpoint actuals against market consensus by passing one announcements series for `usd/policy_rate_midpoint` and one predictions series for `usd/policy_rate_midpoint` with `prediction_class=forecaster_survey`. This tool never fetches arbitrary URLs or runs custom chart code; it only composes approved FXMacroData API surfaces into the comparison chart app. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "plot_visual_artifactArguments",
  "properties": {
    "base": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "eur",
        "aud",
        "usd"
      ],
      "description": "Base currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "page": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        1
      ],
      "description": "One-based page number per source."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20,
        100
      ],
      "description": "Maximum rows per source. Defaults to 20; maximum 100."
    },
    "query": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "plot USD policy-rate midpoint actual vs market consensus",
        "compare AUD and USD inflation"
      ],
      "description": "Optional natural-language request to preserve in the payload title/context."
    },
    "quote": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency for single-series forex plots. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "USD policy-rate actual vs consensus"
      ],
      "description": "Optional chart title. Defaults to query or an auto-generated title."
    },
    "y_key": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "val",
        "predicted_value",
        "rate"
      ],
      "description": "Single-series metric field. Defaults by source: val for announcements and commodities, predicted_value for predictions, rate for forex, noncommercial_net for COT."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "examples": [
        0,
        20
      ],
      "description": "Zero-based row offset per source."
    },
    "series": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "additionalProperties": true
          }
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        [
          {
            "label": "USD policy midpoint actual",
            "source": "announcements",
            "currency": "usd",
            "indicator": "policy_rate_midpoint"
          },
          {
            "label": "Dealer survey median",
            "source": "predictions",
            "currency": "usd",
            "indicator": "policy_rate_midpoint",
            "prediction_class": "forecaster_survey"
          }
        ]
      ],
      "description": "Optional list of series specs. Each spec supports `source` (announcements, predictions, forex, commodities, cot), `currency`, `indicator`, `base`, `quote`, `label`, `y_key`, `metric`, `prediction_class`, `prediction_source`, `start_date`, `end_date`, `limit`, `offset`, and `page`."
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "announcements",
        "predictions",
        "forex"
      ],
      "description": "Single-series source when `series` is omitted. Supported values: announcements, predictions, forex, commodities, cot."
    },
    "x_axis": {
      "type": "string",
      "default": "date",
      "examples": [
        "date",
        "announcement_datetime"
      ],
      "description": "Field to use as the shared x-axis. Supported: date, announcement_datetime, announcement_datetime_local, generated_at, observation_datetime."
    },
    "y_label": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "Policy Rate Midpoint",
        "Value"
      ],
      "description": "Optional y-axis label for the chart."
    },
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "Single-series currency for announcements, predictions, or COT. Supported macro currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Supported COT currencies: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Single-series indicator for announcements, predictions, or commodities. Supported macro indicators: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages. Supported commodity indicators: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver."
    },
    "chart_kind": {
      "type": "string",
      "default": "line",
      "examples": [
        "line",
        "step"
      ],
      "description": "Initial chart view. Supported: line, area, bar, dot, step."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    },
    "prediction_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "fxmacrodata"
      ],
      "description": "Optional legacy prediction-type filter for prediction series. Prefer prediction_class."
    },
    "prediction_source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "ny_fed_sme",
        "philly_fed_spf"
      ],
      "description": "Optional prediction source filter for prediction series."
    }
  }
}
    arguments 308 lines
  • indicator_visual_artifact unknown never probed

    Same payload as indicator_query, but also returns MCP Apps metadata so compatible clients (Claude Desktop, ChatGPT, Codex, etc.) render an interactive line chart instead of a JSON dump. Prefer this by default for indicator time-series requests, especially when the user asks to show, tell, explain, compare, inspect a trend, or review a recent window. For broad histories, use the existing `limit`, `offset`, or `page` controls and inspect `pagination.next_offset` rather than retrying with arbitrary shorter windows. Only fall back to indicator_query when the user explicitly wants a raw table, plain text list, JSON, exact rows, or minimal structured data. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD. Call data_catalogue(currency) for the exact indicator slugs; the `indicator` parameter below also lists them. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "indicator_visual_artifactArguments",
  "required": [
    "currency",
    "indicator"
  ],
  "properties": {
    "page": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        1,
        2
      ],
      "description": "One-based page number. When supplied, the REST endpoint derives offset as `(page - 1) * limit`."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20,
        100
      ],
      "description": "Maximum rows to render from the existing REST pagination path. Defaults to 20; maximum 100."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "examples": [
        0,
        20
      ],
      "description": "Zero-based row offset after most-recent-first ordering."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Indicator slug. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 100 lines
  • forex_visual_artifact unknown never probed

    Same payload as forex, but packaged with MCP Apps chart metadata so compatible clients render an interactive spot-rate chart inline. Prefer this by default for FX pair time-series requests, especially for prompts like 'show me AUD/USD', 'tell me the last 30 days', 'how has EUR/USD moved recently', or any request where a trend view is more useful than raw rows. Only prefer plain forex when the user explicitly asks for a table, raw values, JSON, CSV-style output, or exact row-by-row data. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "forex_visual_artifactArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicators": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "sma_50,sma_200",
        "rsi_14",
        "ema_20,atr_14"
      ],
      "description": "Optional technical indicators to include in the raw payload. Supported: adx_14, atr_14, bollinger_bands, cci_20, donchian_20, ema_12, ema_20, ema_200, ema_26, ema_50, macd, macd_histogram, macd_signal, rsi_14, sma_20, sma_200, sma_50, stochastic_14_3, williams_r_14, all."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 78 lines
  • commodities_visual_artifact unknown never probed

    Same payload as commodities, but packaged with MCP Apps chart metadata so compatible clients render an interactive commodity chart inline. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "commodities_visual_artifactArguments",
  "required": [
    "indicator"
  ],
  "properties": {
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "crude_oil_inventories",
        "gold",
        "natural_gas",
        "natural_gas_storage",
        "oil_brent",
        "oil_wti"
      ],
      "description": "Commodity indicator slug. Supported: crude_oil_inventories, gold, natural_gas, natural_gas_storage, oil_brent, oil_wti, platinum, silver."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 53 lines
  • cot_visual_artifact unknown never probed

    Same payload as cot_data, but with MCP Apps chart metadata. By default it charts noncommercial net positioning; pass `metric` to chart another COT field. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "cot_visual_artifactArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "metric": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "noncommercial_net",
      "examples": [
        "noncommercial_net",
        "noncommercial_net_zscore",
        "noncommercial_long",
        "open_interest"
      ],
      "description": "Field to plot from each COT row. Typical values: noncommercial_net, noncommercial_net_zscore, noncommercial_long, noncommercial_short, open_interest."
    },
    "currency": {
      "type": "string",
      "examples": [
        "eur",
        "jpy",
        "gbp",
        "aud"
      ],
      "description": "3-letter ISO currency code for the FX futures contract (case-insensitive). Supported: AUD, CAD, CHF, EUR, GBP, JPY, MXN, NZD, USD, XAU."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 69 lines
  • macro_briefing_task unknown never probed

    Build a compact macro briefing for a currency by combining catalogue, key macro series, release-calendar, prediction, news, risk-sentiment, COT, seasonality, and FX technical context. Supports MCP Tasks for async execution when clients send a task-augmented request. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "macro_briefing_taskArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    }
  }
}
    arguments 19 lines
  • indicator_intel_task unknown never probed

    Build an intelligence pack for one indicator by combining chart-ready series data, derived analytics, and nearest release timing context. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "indicator_intel_taskArguments",
  "required": [
    "currency",
    "indicator"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Indicator slug for the given currency. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 62 lines
  • pair_intel_task unknown never probed

    Build an intelligence pack for an FX pair by combining policy-rate spread context, spot-rate context, and release-timing metadata. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "pair_intel_taskArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 61 lines
  • macro_heatmap_task unknown never probed

    Build a cross-currency macro heatmap from indicator time series and return a matrix with latest values, recent changes, and z-scores. Supports MCP Tasks for async execution when clients send task-augmented requests.

    mcp-tool

    {
  "type": "object",
  "title": "macro_heatmap_taskArguments",
  "properties": {
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "currencies": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd,eur,gbp,jpy",
        "aud,cad,chf,nzd",
        "usd,sek,nok,pln"
      ],
      "description": "Comma-separated 3-letter currency codes (lowercase preferred). Supported values include: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "indicators": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "policy_rate,inflation,gdp",
        "inflation,unemployment,retail_sales"
      ],
      "description": "Comma-separated indicator slugs to include in the matrix. Supported values include: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 71 lines
  • policy_scenario_modeler_task unknown never probed

    Run a policy-rate spread what-if scenario for an FX pair and estimate directional spot impact using an explicit heuristic elasticity assumption. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: requires an FXMacroData API key; an anonymous call returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "policy_scenario_modeler_taskArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "shock_bps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 25,
      "examples": [
        25,
        50,
        -25
      ],
      "description": "Policy shock size in basis points (100 bps = 1.00 percentage point)."
    },
    "shock_leg": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "base",
      "examples": [
        "base",
        "quote"
      ],
      "description": "Which leg receives the policy shock: base or quote."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    },
    "policy_shock_bps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        25,
        50
      ],
      "description": "Optional alias for shock_bps for compatibility with host-side app payloads."
    },
    "elasticity_per_100bps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 0.8,
      "examples": [
        0.5,
        0.8,
        1.2
      ],
      "description": "Heuristic percent change in FX spot for a 100 bps spread change. Used as a scenario assumption, not a forecast guarantee."
    }
  }
}
    arguments 127 lines
  • macro_war_room_task unknown never probed

    Build a multi-panel macro market cockpit that combines FX sessions, upcoming release queue, pair context, and generated risk alerts. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "macro_war_room_taskArguments",
  "properties": {
    "base": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "eur",
        "gbp",
        "aud",
        "usd"
      ],
      "description": "Base currency for pair context, 3-letter ISO code (case-insensitive). Defaults to the release currency when omitted. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "usd",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency for pair context, 3-letter ISO code (case-insensitive). Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "usd",
      "examples": [
        "usd",
        "eur",
        "gbp"
      ],
      "description": "Release currency used for queue and spotlight indicator. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "inflation",
      "examples": [
        "inflation",
        "policy_rate",
        "gdp"
      ],
      "description": "Spotlight indicator slug for release context. Supported examples: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 107 lines
  • fx_backtest_task unknown never probed

    Run a spot-only FX backtest using historical policy-rate-differential and/or lagged momentum signals. Download complete histories, verify vintages and price coverage, and charge opening, rebalancing and closing costs. The carry signal does not include funding income or broker rollover. Supports MCP Tasks for async execution when clients send task-augmented requests.

    mcp-tool

    {
  "type": "object",
  "title": "fx_backtest_taskArguments",
  "required": [
    "base",
    "quote"
  ],
  "properties": {
    "base": {
      "type": "string",
      "examples": [
        "eur",
        "gbp",
        "aud"
      ],
      "description": "Base currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "quote": {
      "type": "string",
      "examples": [
        "usd",
        "jpy",
        "chf"
      ],
      "description": "Quote currency, 3-letter ISO code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive upper bound, YYYY-MM-DD."
    },
    "strategy": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": "carry_momentum",
      "examples": [
        "carry_momentum",
        "carry",
        "momentum"
      ],
      "description": "Signal mode: carry, momentum, or carry_momentum."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Inclusive lower bound, YYYY-MM-DD."
    },
    "event_gated": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ],
      "default": false,
      "examples": [
        true,
        false
      ],
      "description": "When true, allow positions only after verified historical policy publications for either currency. This does not use future calendars or trade before a release."
    },
    "initial_capital": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 100000,
      "examples": [
        10000,
        100000
      ],
      "description": "Starting capital for equity-curve calculations."
    },
    "event_window_days": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 1,
      "examples": [
        0,
        1,
        2
      ],
      "description": "Additional calendar days after the first UTC decision following publication; 0 permits that first day only."
    },
    "momentum_lookback": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": 5,
      "examples": [
        5,
        10,
        20
      ],
      "description": "Momentum lookback in observations for the momentum signal."
    },
    "transaction_cost_bps": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": 2,
      "examples": [
        1,
        2,
        5
      ],
      "description": "Per-side transaction cost in basis points applied on position changes."
    }
  }
}
    arguments 160 lines
  • macro_research_pack_task unknown never probed

    Bundle catalogue, indicator history, next release timing, and optional FX pair context into one persistent-host-friendly research payload. Supports MCP Tasks for async execution when clients send task-augmented requests. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "macro_research_pack_taskArguments",
  "required": [
    "currency",
    "indicator"
  ],
  "properties": {
    "base": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "eur",
        "usd"
      ],
      "description": "Optional FX base currency for pair context."
    },
    "quote": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd",
        "jpy"
      ],
      "description": "Optional FX quote currency for pair context."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code. Supported: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, HUF, ILS, JPY, KRW, MYR, NGN, NOK, NZD, PEN, SEK, THB, TWD, USD."
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive upper bound, YYYY-MM-DD."
    },
    "indicator": {
      "type": "string",
      "examples": [
        "policy_rate",
        "inflation",
        "unemployment",
        "gdp"
      ],
      "description": "Indicator slug. Supported: afe_dollar_index, average_hourly_earnings, average_hourly_earnings_mom, balance_on_goods, balance_on_services, bgcr, breakeven_inflation_rate, broad_dollar_index, broad_money, building_approvals, building_permits, business_confidence, capital_account_balance, cb_assets, commodity_price_energy, commodity_price_ex_energy, commodity_price_index, commodity_prices, consumer_confidence, core_inflation, core_inflation_median, core_inflation_mom, core_inflation_trim, core_pce, core_pce_mom, credit_growth, crude_oil_inventories, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, effr, eme_dollar_index, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, fx_reserves, gdp, gdp_growth_q4_yoy, gold_reserves, gov_bond_10y, gov_bond_15y, gov_bond_1_5m, gov_bond_1m, gov_bond_1y, gov_bond_20y, gov_bond_25y, gov_bond_2m, gov_bond_2y, gov_bond_30y, gov_bond_3m, gov_bond_3y, gov_bond_40y, gov_bond_4m, gov_bond_4y, gov_bond_5y, gov_bond_6m, gov_bond_6y, gov_bond_7y, gov_bond_8y, gov_bond_9y, government_debt, house_price_index, house_prices, household_credit, household_spending, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, nairu, natural_gas_storage, net_foreign_asset_position, non_farm_payrolls, non_farm_payrolls_change, obfr, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, primary_income_balance, real_yield_20y, real_yield_30y, real_yield_5y, real_yield_7y, retail_sales, retail_sales_control_group, retail_sales_ex_autos, retail_sales_ex_autos_and_gas, risk_free_rate, secondary_income_balance, sight_deposits, snb_balance_sheet, sofr_average_180d, sofr_average_30d, sofr_average_90d, sofr_index, terms_of_trade, tgcr, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages."
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2020-01-01",
        "2024-06-30"
      ],
      "description": "Optional inclusive lower bound, YYYY-MM-DD."
    }
  }
}
    arguments 94 lines
  • prediction_coverage unknown never probed

    List which publishers produce pre-release forecasts for a currency's indicators, what class of forecast each one is (compiled consensus, forecaster survey, market implied, model nowcast, central-bank projection), whether any of them is a genuine consensus, and how far the verified archive runs. Call this whenever the user asks whether a consensus, forecast or estimate exists for a release -- 'do you have the consensus for US CPI', 'what forecast do you have for payrolls' -- BEFORE calling event_predictions, and whenever event_predictions returns nothing or returns subscription_required. It needs no API key and works for every served currency. It returns no forecast values: those require a subscription. Its answer distinguishes the two cases a user cannot otherwise tell apart -- no publisher produces this forecast for anybody (no subscription adds it), versus the data exists and is behind the paywall. Never report a pair listed here as unavailable. Access: free for every currency, no API key required. It returns coverage metadata only; forecast values need a subscription.

    mcp-tool

    {
  "type": "object",
  "title": "prediction_coverageArguments",
  "properties": {
    "currency": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "usd",
        "eur",
        "jpy"
      ],
      "description": "Optional 3-letter currency code. Omit for the cross-currency summary; pass one for per-indicator detail."
    }
  }
}
    arguments 23 lines
  • market_sessions unknown never probed

    Tell the user which FX trading sessions are currently open (Sydney, Tokyo, London, New York) and when the next session opens/closes. Use this when the user asks 'is the market open?', 'when does London open?', or 'which sessions overlap right now?'. Pass an ISO-8601 UTC timestamp via `at` to get the snapshot for a specific moment instead of now. Accounts for weekends and major banking holidays.

    mcp-tool

    {
  "type": "object",
  "title": "market_sessionsArguments",
  "properties": {
    "at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "2025-06-15T13:30:00Z",
        "2025-12-25T00:00:00Z"
      ],
      "description": "Optional ISO-8601 UTC timestamp; defaults to now. Use to snapshot session state at a specific moment."
    }
  }
}
    arguments 22 lines
  • financial_prices unknown never probed

    Read persisted official financial price observations: government yield curves, individual securities, overnight benchmarks and reference prices. Preserves issuer, instrument, maturity, curve type and source precision. Requires an API key; an empty result means no stored observations for the selection. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "financial_pricesArguments",
  "required": [
    "currency"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "default": 100
    },
    "issuer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "offset": {
      "type": "integer",
      "default": 0
    },
    "source": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "measure": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "currency": {
      "type": "string"
    },
    "end_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "start_date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "instrument_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  }
}
    arguments 86 lines
  • official_dataset_family unknown never probed

    Get metadata-first official dataset payloads grouped by API endpoint type. Use endpoint_type to pick the API taxonomy group and dataset to choose the specific series family. Supported endpoint types: monetary_policy, fiscal_policy, international_trade, statistics_releases. Supported datasets: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements. Access: USD is available without an API key; every other currency returns subscription_required with a subscribe link.

    mcp-tool

    {
  "type": "object",
  "title": "official_dataset_familyArguments",
  "required": [
    "endpoint_type",
    "dataset",
    "currency"
  ],
  "properties": {
    "dataset": {
      "type": "string",
      "examples": [
        "cb_liquidity",
        "treasury_cash",
        "bop",
        "credit_conditions"
      ],
      "description": "Dataset slug within the selected endpoint_type. Supported: auction_metrics, bop, capital_flows, cb_liquidity, credit_conditions, external_debt, fx_intervention, iip, services_trade, treasury_cash, wage_settlements."
    },
    "currency": {
      "type": "string",
      "examples": [
        "usd",
        "eur",
        "gbp",
        "jpy"
      ],
      "description": "3-letter ISO currency code (case-insensitive)."
    },
    "component": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "examples": [
        "current_account",
        "services_balance",
        "financial_account"
      ],
      "description": "Required only when dataset='bop'. Supported bop components: goods_balance, services_balance, primary_income, secondary_income, current_account, capital_account, financial_account."
    },
    "endpoint_type": {
      "type": "string",
      "examples": [
        "monetary_policy",
        "fiscal_policy",
        "international_trade",
        "statistics_releases"
      ],
      "description": "Endpoint taxonomy group from the API structure. Supported: monetary_policy, fiscal_policy, international_trade, statistics_releases."
    }
  }
}
    arguments 58 lines
_ try it over mcp through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/8e9ed03031feebee/badge.svg)](https://brick.blue/agent/8e9ed03031feebee)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Own the domain? Prove it and the listing carries a verified badge here too: passport.

_ how we knowoff the mcp door
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on fxmacrodata.com 2 entries

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.