FXMacroData

{
  "capabilities": {
    "pushNotifications": false,
    "stateTransitionHistory": false,
    "streaming": false
  },
  "defaultInputModes": [
    "application/json",
    "text/plain"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "description": "Macroeconomic and FX data agent. Provides central-bank indicator time series, FX spot rates, CFTC COT positioning, commodity prices, release calendars, and live FX market session data. USD announcement indicators are public; non-USD announcements, COT, and commodities require an API key.",
  "documentationUrl": "https://fxmacrodata.com/documentation",
  "name": "FXMacroData",
  "preferredTransport": "JSONRPC",
  "protocolVersion": "0.3.0",
  "provider": {
    "organization": "FXMacroData",
    "url": "https://fxmacrodata.com"
  },
  "security": [
    {
      "apiKey": []
    }
  ],
  "securitySchemes": {
    "apiKey": {
      "description": "FXMacroData API key. Pass as query parameter ?api_key=YOUR_KEY.",
      "in": "query",
      "name": "api_key",
      "type": "apiKey"
    }
  },
  "skills": [
    {
      "description": "List available macroeconomic indicators for a currency. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.",
      "examples": [
        "{\"skill\": \"data_catalogue\", \"currency\": \"USD\"}",
        "{\"skill\": \"data_catalogue\", \"currency\": \"EUR\"}"
      ],
      "id": "data_catalogue",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "Data Catalogue",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "macro",
        "catalogue",
        "indicators"
      ]
    },
    {
      "description": "Get upcoming macroeconomic release dates for a currency and optional indicator. Supported currencies: AED, ARS, AUD, BOB, BRL, CAD, CHF, CLP, CNH, CNY, COMM, COP, CZK, DKK, DZD, EGP, EUR, GBP, HKD, HUF, IDR, ILS, INR, JPY, KRW, MAD, MXN, MYR, NGN, NOK, NZD, PEN, PHP, PKR, PLN, RUB, SAR, SEK, SGD, THB, TRY, TWD, USD, UYU, VND, ZAR.",
      "examples": [
        "{\"skill\": \"release_calendar\", \"currency\": \"USD\"}",
        "{\"skill\": \"release_calendar\", \"currency\": \"EUR\", \"indicator\": \"inflation\"}"
      ],
      "id": "release_calendar",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "Release Calendar",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "macro",
        "calendar",
        "schedule",
        "releases"
      ]
    },
    {
      "description": "Get macroeconomic indicator time series for a currency. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD. Supported indicators: average_hourly_earnings, balance_on_goods, balance_on_services, breakeven_inflation_rate, 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, credit_growth, current_account_balance, dairy_exports, deposit_rates, durable_goods_orders, employment, exports, financial_account_balance, foreign_reserves, full_time_employment, gdp, gdp_growth_q4_yoy, gdp_growth_qoq_saar, gdp_quarterly, gold_reserves, gov_bond_10y, gov_bond_1y, gov_bond_20y, gov_bond_2y, gov_bond_30y, gov_bond_3y, gov_bond_40y, gov_bond_4y, gov_bond_5y, gov_bond_7y, government_debt, house_price_index, household_credit, housing_starts, imports, inflation, inflation_linked_bond, inflation_mom, initial_jobless_claims, international_assets, international_liabilities, job_openings, m1, m2, m3, monthly_cpi, nairu, net_foreign_asset_position, non_farm_payrolls, part_time_employment, participation_rate, pce, pce_mom, policy_rate, policy_rate_midpoint, policy_rate_mlf, policy_rate_mro, policy_rate_target_lower, ppi, ppi_mom, primary_income_balance, retail_sales, risk_free_rate, secondary_income_balance, sight_deposits, terms_of_trade, trade_balance, trade_weighted_index, trimmed_mean_inflation, unemployment, wage_price_index, wages.",
      "examples": [
        "{\"skill\": \"indicator_query\", \"currency\": \"USD\", \"indicator\": \"inflation\"}",
        "{\"skill\": \"indicator_query\", \"currency\": \"EUR\", \"indicator\": \"gdp\", \"start_date\": \"2020-01-01\"}"
      ],
      "id": "indicator_query",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "Indicator Query",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "macro",
        "indicators",
        "time-series",
        "announcements"
      ]
    },
    {
      "description": "Get FX spot rate time series for a currency pair with optional technical indicators. Supported currencies: AUD, BRL, CAD, CHF, CNH, CNY, DKK, EUR, GBP, ILS, JPY, NGN, NOK, NZD, PEN, SEK, THB, USD.",
      "examples": [
        "{\"skill\": \"forex\", \"base\": \"EUR\", \"quote\": \"USD\"}",
        "{\"skill\": \"forex\", \"base\": \"GBP\", \"quote\": \"USD\", \"start_date\": \"2024-01-01\"}"
      ],
      "id": "forex",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "FX Spot Rates",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "fx",
        "forex",
        "spot",
        "rates"
      ]
    },
    {
      "description": "Get CFTC Commitment of Traders (COT) weekly positioning data for a currency's FX futures contract. Supported currencies: AUD, CAD, CHF, EUR, GBP, HUF, JPY, MXN, NZD, TRY, USD, XAU.",
      "examples": [
        "{\"skill\": \"cot_data\", \"currency\": \"EUR\"}",
        "{\"skill\": \"cot_data\", \"currency\": \"JPY\", \"start_date\": \"2024-01-01\"}"
      ],
      "id": "cot_data",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "COT Report",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "cot",
        "positioning",
        "futures",
        "cftc"
      ]
    },
    {
      "description": "Get commodity and energy price time series. Supported indicators: gold, natural_gas, oil_brent, oil_wti, platinum, silver.",
      "examples": [
        "{\"skill\": \"commodities\", \"indicator\": \"gold\"}",
        "{\"skill\": \"commodities\", \"indicator\": \"silver\", \"start_date\": \"2024-01-01\"}"
      ],
      "id": "commodities",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "Commodity Prices",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "commodities",
        "gold",
        "silver",
        "platinum",
        "metals"
      ]
    },
    {
      "description": "Get the current FX market-session timetable and overlap windows, or request a snapshot for a specific UTC timestamp.",
      "examples": [
        "{\"skill\": \"market_sessions\"}",
        "{\"skill\": \"market_sessions\", \"at\": \"2024-06-01T09:00:00Z\"}"
      ],
      "id": "market_sessions",
      "inputModes": [
        "application/json",
        "text/plain"
      ],
      "name": "FX Market Sessions",
      "outputModes": [
        "application/json"
      ],
      "tags": [
        "fx",
        "sessions",
        "market-hours"
      ]
    }
  ],
  "url": "https://mcp.fxmacrodata.com/a2a",
  "version": "1.0.0"
}