What it adds

Tools 73

fxmd_healthfxmd_pingfxmd_forexfxmd_intraday_reference_ratesfxmd_fx_sourcesfxmd_fx_source_universefxmd_data_cataloguefxmd_release_calendarfxmd_market_sessionsfxmd_rate_differentialsfxmd_curvesfxmd_financial_pricesfxmd_press_releasesfxmd_risk_sentimentfxmd_factorsfxmd_event_predictionsfxmd_latest_announcementsfxmd_indicator_historyfxmd_cotfxmd_latest_commoditiesfxmd_commoditiesfxmd_announcement_changesfxmd_stream_eventsfxmd_mcp_pingfxmd_mcp_mcp_capabilitiesfxmd_mcp_mcp_auth_guidefxmd_mcp_subscribe_for_mcp_accessfxmd_mcp_data_cataloguefxmd_mcp_risk_sentimentfxmd_mcp_macro_newsfxmd_mcp_release_calendarfxmd_mcp_release_calendar_visual_artifactfxmd_mcp_event_predictionsfxmd_mcp_latest_announcementsfxmd_mcp_announcement_changesfxmd_mcp_press_releasesfxmd_mcp_macro_factorfxmd_mcp_fx_reference_sourcesfxmd_mcp_fx_reference_universefxmd_mcp_fx_intraday_reference_ratesfxmd_mcp_rate_curvefxmd_mcp_rate_differentialsfxmd_mcp_latest_commoditiesfxmd_mcp_forexfxmd_mcp_seasonalityfxmd_mcp_indicator_queryfxmd_mcp_plot_visual_artifactfxmd_mcp_indicator_visual_artifactfxmd_mcp_forex_visual_artifactfxmd_mcp_commodities_visual_artifactfxmd_mcp_cot_visual_artifactfxmd_mcp_policy_rate_differential_visual_artifactfxmd_mcp_macro_briefing_taskfxmd_mcp_indicator_intel_taskfxmd_mcp_pair_intel_taskfxmd_mcp_macro_heatmap_taskfxmd_mcp_policy_scenario_modeler_taskfxmd_mcp_macro_war_room_taskfxmd_mcp_event_impact_replay_taskfxmd_mcp_quant_scenario_lab_taskfxmd_mcp_known_at_time_taskfxmd_mcp_macro_regime_classifier_taskfxmd_mcp_release_risk_score_taskfxmd_mcp_portfolio_risk_engine_taskfxmd_mcp_fx_trade_setup_taskfxmd_mcp_fx_backtest_taskfxmd_mcp_macro_research_pack_taskfxmd_mcp_market_sessionsfxmd_mcp_cot_datafxmd_mcp_commoditiesfxmd_mcp_financial_pricesfxmd_mcp_official_dataset_familyfxmd_usd_macro_brief

README

From the reviewed commit 5b52fec ↗; it updates when the author re-pins.

FXMacroData for Hermes

Bring your FXMacroData subscription into Hermes for cross-currency macro research, full available indicator histories and release-calendar analysis. Native research tools keep source citations attached to the data in your conversations.

Subscribe to FXMacroData for access to non-USD datasets, FX rates, commodities, positioning and full available history.

You can evaluate the plugin before subscribing. Without a key, the REST tools serve the data catalogue for every currency, the USD release calendar and the most recent 90 days of USD announcements on a 15-minute delay, with a fair-use limit of 100 requests a day. Through the hosted MCP tools, USD releases, the USD calendar and the USD catalogue work without a key; other currencies, FX rates and the rest need a key.

The full inventory contains 23 public REST operations and 49 hosted MCP tools, plus a /fxmacrodata USD macro brief command. Every operation has its own native tool and original input schema. See the operation matrix.

Install

hermes plugins install fxmacrodata/hermes-fxmacrodata
hermes plugins enable fxmacrodata

Hermes installs the plugin's PyPI dependencies (requests, urllib3, jsonschema, referencing) with bounded version ranges. The FXMacroData client ships inside the plugin, so nothing is downloaded from outside PyPI.

Restart Hermes after enabling the plugin. Ask: "Use FXMacroData to discover USD indicators, inspect policy-rate history, and show the upcoming release calendar with source citations." Or enter /fxmacrodata policy_rate.

You can also install the package into the Python environment Hermes runs in (uv pip install .) and enable it through its hermes_agent.plugins entry point. Validate a checkout with hermes plugins validate /path/to/hermes-fxmacrodata --install-deps.

Connect your subscription

Set FXMACRODATA_API_KEY in the process environment or a configured Hermes secret source. It is the only credential the plugin reads, and it is optional. Do not place keys in prompts, tool arguments, plugin settings, shared files or command history.

The key is read when a call starts, trimmed, and refused (without being repeated) if it contains spaces or control characters. REST calls send it as an X-API-Key header and MCP calls as an Authorization: Bearer header; it never appears in a URL. Redirects are never followed, so the key cannot be forwarded to another host. Each call closes its own HTTP/MCP session.

The only plugin setting is plugins.entries.fxmacrodata.settings.timeout_seconds (default 30, clamped to 1-120 seconds).

Network, files and processes

Tool calls make HTTPS requests to api.fxmacrodata.com (REST) and mcp.fxmacrodata.com (hosted MCP) only, carrying the tool arguments and, when set, your FXMACRODATA_API_KEY. Nothing else is contacted.
Registering the tools makes no network calls. The tool list is packaged with the plugin; it is not fetched at runtime and the plugin never updates itself.
The plugin writes no files, runs no shell commands, starts no background processes and stores no credentials. fxmd_stream_events captures a finite number of events within a finite timeout and then closes.
No telemetry or usage reporting. Static campaign tags appear only on fxmacrodata.com website links in tool output.

Results and research

Tool results contain the original response in data, an additive records view, the operation name and source citations. Pagination and date filters keep their public API meanings: list endpoints return 20 rows by default, and calendar date is the reference period while announcement_datetime is the release time.

Keyless responses can carry free-tier window and delay messages. The plugin copies them into a notices list so the agent can say that data is delayed or limited instead of presenting it as current. A successful HTTP status whose body is an error (for example api_key_required) is reported as an error with the subscribe link. Currency codes, YYYY-MM-DD dates, date ranges and indicator slugs are validated before any request is made.

fxmd_usd_macro_brief composes catalogue discovery, recent history and the release calendar. Failed sections remain explicit and complete is false; empty records are unavailable data. Keep observed releases, scheduled events, market consensus and FXMacroData-generated predictions distinct. MCP text, structured content and resource links are preserved; interactive MCP Apps are not rendered by this plugin.

FXMacroData · Public API reference

← Back to the catalog · catalog built Oct 6, 2026