Developer documentation

Context for your next agent.

Connect your agent to FXContext, explore structured macro events, and query policy changes.

Connect to FXContext

Connect your agent client directly to the hosted endpoint or run your own local instance using ./gradlew bootRun.

{
  "mcpServers": {
    "fxcontext": {
      "url": "https://fx.coco-pier.com/mcp"
    }
  }
}

Add the MCP server URL to a compatible client. The JSON is an example for clients accepting URL-based server configuration; other clients may use a settings screen or a different schema.

Get event context

The MCP tool get_event_context accepts an event type and an optional reference period. Omitting the period selects the latest stored event of that type.

{
  "name": "get_event_context",
  "arguments": {
    "eventType": "US_CPI",
    "referencePeriod": "2026-08"
  }
}

The REST endpoint is GET /api/v1/summary. It returns the latest macro facts across US CPI, Federal Reserve, and ECB policy releases, complete with post-event EURUSD market reaction metrics.

MCP tool catalog

Browse tool capabilities and example calls for the available FXContext MCP tools.

Economic event context

get_event_context

Retrieve structured factual context for supported economic releases.

get_event_context({
  "eventType": "US_CPI"
})

Use it when an agent needs the latest or historical facts for a supported macroeconomic release.

Central-bank policy changes

get_central_bank_changes

Compare a monetary-policy statement with its immediately preceding statement and identify material changes.

get_central_bank_changes({
  "centralBank": "FEDERAL_RESERVE"
})

Use it when an agent needs to understand what actually changed between central-bank meetings.

Post-event market reaction

get_market_reaction

Retrieve deterministic EURUSD price-action metrics following a supported macroeconomic event or central-bank statement.

get_market_reaction({
  "targetType": "US_CPI",
  "instrument": "EURUSD"
})

Use it when an agent needs to understand how EURUSD reacted after an event without relying on generated market commentary.

Upcoming macro risks

get_upcoming_risks

See scheduled CPI releases and central-bank decisions that could affect EURUSD.

get_upcoming_risks({
  "instrument": "EURUSD",
  "horizonHours": 24
})

Look ahead up to 168 hours. Returns scheduled events only, with an empty list when none fall within the window.

Historical event analogs

get_historical_analogs

Find similar past US CPI surprises and compare their observed EURUSD reactions.

get_historical_analogs({
  "eventType": "US_CPI",
  "instrument": "EURUSD",
  "limit": 5
})

Compare past outcomes using deterministic calculations. Historical observations are not forecasts. Optional referencePeriod: YYYY-MM; limit: 1–20.

Data you can trace

Current ingestion covers BLS Consumer Price Index data and Federal Reserve FOMC statements. Additional official sources shown on the homepage are planned integrations.

The homepage conversation and “Try it now” response are illustrative fixtures. The preview’s risk ratings and historical market moves are not live calculations. The current event-context tool returns factual event data.

What is available today

FXContext is in active development. This frontend provides product information, configuration examples, and a local sample. It does not create accounts, issue API keys, or send queries to a backend.

Hosted service access, future-risk aggregation, change summaries, and market-reaction analysis are not enabled by this homepage. No analytics or third-party tracking scripts are included.

View the project on GitHub →