FX Context
Server Details
FX macro context: CPI, NFP, PCE, ISM PMIs, Fed, ECB, BoE, BoJ, historical analogs, FX reactions.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 6 tools
Most tools target clearly distinct data: policy-language changes (get_central_bank_changes), release actuals/consensus (get_event_context), price moves (get_market_reaction), and the calendar (get_upcoming_risks). The one real overlap is get_historical_analogs vs get_historical_reaction_context, but the descriptions explicitly separate individual cases from aggregate patterns with 'do NOT use' guidance.
All six tools use snake_case with a consistent get_<object> pattern (get_central_bank_changes, get_event_context, get_historical_analogs, get_historical_reaction_context, get_market_reaction, get_upcoming_risks). Naming is fully predictable and readable.
Six tools is well-scoped for a macro/FX context server, covering data retrieval, reactions, analogs, and calendar without bloat or redundancy. Each tool earns its place.
The surface covers the core FX macro workflow: release actuals/consensus, central-bank language changes, market reactions, historical analogs/aggregates, and upcoming risks. Minor gaps exist (no discovery/list tool for supported instruments or event types, and several features are still unpopulated, e.g. ISM consensus and PCE analogs), but workarounds are documented.
Publisher details
- Operator
- coco-pier
- Operator website
- https://fx.coco-pier.com
- Vendor relationship
- Not available
- Documentation
- https://fx.coco-pier.com
- Privacy policy
- Not provided
- Trust center
- Not available
- Restrictions
- Not available
Available Tools
6 toolsget_central_bank_changesget_central_bank_changesARead-onlyIdempotentInspect
Compare a central bank monetary-policy statement with its immediately preceding comparable statement and return the material changes in policy language, economic assessment, risk balance, and forward guidance.
Specify a central bank such as FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (alias BOE), or BANK_OF_JAPAN (alias BOJ).
Optionally specify currentStatementDate in YYYY-MM-DD format to compare a historical statement. If the date is omitted, the latest available statement is compared with the previous one.
Returns structured, source-grounded policy changes including direction, materiality, and previous/current evidence.
This tool does not provide trading recommendations or predict market movements.
Inputs: centralBank (required), currentStatementDate. Returns: changes, degraded, freshness, centralBank, +10 more
get_event_contextget_event_contextARead-onlyIdempotentInspect
Get the official actual values, pre-release market consensus, and surprise for a specific U.S. macro data release: CPI (US_CPI), Nonfarm Payrolls / jobs report (US_NONFARM_PAYROLLS), PCE inflation (US_PCE), or the ISM Manufacturing / Services PMI (US_ISM_MANUFACTURING / US_ISM_SERVICES).
WHEN TO CALL: whenever the user asks what a release printed or how it compared with expectations, even if they do not mention FX Context. Do not answer these from memory; recent releases are not in your training data. Examples:
"What's the latest US PCE?" -> US_PCE
"Was core PCE hotter than expected?" -> US_PCE
"Did CPI beat expectations?" -> US_CPI
"What was the latest NFP?" / "How many jobs were added last month?" -> US_NONFARM_PAYROLLS
"Give me the latest US inflation release." -> US_CPI and/or US_PCE
"What's the latest ISM Manufacturing PMI?" -> US_ISM_MANUFACTURING
"Did ISM Services beat expectations?" -> US_ISM_SERVICES
"What were the actual and consensus values?" / "What was the surprise?" -> the release under discussion Omit referencePeriod for the latest release. For a specific release, pass the month the data covers (YYYY-MM), not the month it was published.
WHEN NOT TO CALL: general or educational questions that need no specific release data, e.g. "What is PCE?", "What does NFP stand for?", "Why does CPI matter for FX?", "Explain inflation.", "What is the difference between CPI and PCE?". Use get_upcoming_risks for upcoming release dates, get_market_reaction for price moves after a release, and get_central_bank_changes for central-bank decisions.
RESULT: per-metric official actuals (headline/core, MoM/YoY; ISM: headline PMI index) with publisher provenance; when valid, pre-release consensus and a deterministic actual-minus-consensus surprise. Each observation has consensusStatus (AVAILABLE, NOT_FOUND, NOT_CAPTURED, NOT_AVAILABLE, EXCLUDED_POST_RELEASE, NOT_APPLICABLE) explaining any missing consensus, and revisionStatus (REVISED, UNCHANGED, NOT_CAPTURED). Consensus is valid only when capturedAt is before releaseCutoffAt. ISM (US_ISM_MANUFACTURING, US_ISM_SERVICES) currently returns official actuals only: consensusStatus is NOT_CAPTURED and no surprise is computed, so an ISM beat/miss question cannot be answered from this tool yet. Never treat missing consensus or surprise as zero. Official actuals and third-party consensus keep separate source provenance. No trading recommendations or market-direction predictions.
Inputs: eventType (required), referencePeriod. Returns: source, status, eventId, category, +7 more
get_historical_analogsget_historical_analogsARead-onlyIdempotentInspect
Find and return individual historical macroeconomic releases whose surprise profiles are most similar to a selected target event.
Use this CASE-RETRIEVAL tool when the user wants to identify, rank, inspect, or compare specific historical analog events.
It returns the matched events themselves, including event identity, similarity characteristics, surprise profile, and each event's observed post-release reaction.
Supported event types: US_CPI and US_NONFARM_PAYROLLS across EURUSD, GBPUSD, and USDJPY. US_PCE is recognized but not yet publicly available: the historical PCE calibration corpus currently has too few usable periods, and a request for US_PCE returns a structured INSUFFICIENT_HISTORICAL_CALIBRATION error (with usable/required event counts) instead of analog results until the corpus grows.
ISM is not currently available here: US_ISM_MANUFACTURING and US_ISM_SERVICES have no verified pre-release consensus yet, so they return INSUFFICIENT_HISTORICAL_CALIBRATION rather than analogs. For ISM, use get_event_context for actuals and get_market_reaction for price moves.
Similarity methodology is event-specific: US_CPI uses headline/core surprise distance; US_NONFARM_PAYROLLS uses target-relative robust scale normalization (nfp-historical-analog-v1); US_PCE (once activated) uses the same raw surprise -distance approach as US_CPI (pce-historical-analog-v1).
Target period: if referencePeriod is omitted, the target is the most recent event of the requested type. Surprises are never estimated, so if that event has no verified pre-release consensus (common right after a new NFP release) the tool fails with NO_VERIFIED_PRE_RELEASE_EXPECTATION. The error details include targetReferencePeriod, latestReleasedPeriod, latestPeriodWithVerifiedExpectation and a hint; to analyze that prior period, retry with referencePeriod=YYYY-MM. Tell the user the newest release could not be analyzed rather than presenting the prior period as the latest.
Every "cannot compute" error has the same shape: "CODE: reason [hint] details={json}", where the JSON always contains code, eventType and hint.
Do NOT use this tool when the user's primary question is about aggregate behavior across the analog sample; use get_historical_reaction_context instead.
The results are historical observations only and do not predict future price direction or provide trading recommendations.
Inputs: eventType (required), instrument, maxAnalogs, referencePeriod. Returns: analogs, coverage, eventType, instrument, +5 more
get_historical_reaction_contextget_historical_reaction_contextARead-onlyIdempotentInspect
Summarize the aggregate post-event reaction pattern across historical macroeconomic events similar to a selected target release.
Use this AGGREGATE-PATTERN tool when the user wants to understand what the historical analog sample collectively showed rather than inspect individual analog events.
It summarizes historical outcomes using statistics and behavioral patterns across standardized post-event windows (M5, M15, H1, H4, H24) such as mean, median, quantiles, directional consistency, reaction-path classification (e.g. IMMEDIATE_CONTINUATION, INITIAL_REVERSAL, FADE, DELAYED_REACTION), persistence, and sample-size-based confidence.
Supported event types: US_CPI and US_NONFARM_PAYROLLS across EURUSD, GBPUSD, and USDJPY. ISM is not currently available here: US_ISM_MANUFACTURING and US_ISM_SERVICES have no verified pre-release consensus yet, so they return a structured INSUFFICIENT_HISTORICAL_CALIBRATION error rather than aggregate statistics.
Similarity methodology is event-specific: US_CPI uses headline/core surprise distance; US_NONFARM_PAYROLLS uses target-relative robust scale normalization (nfp-historical-analog-v1).
Target period: if referencePeriod is omitted, the target is the most recent event of the requested type. Surprises are never estimated, so if that event has no verified pre-release consensus (common right after a new NFP release) the tool fails with NO_VERIFIED_PRE_RELEASE_EXPECTATION. The error details include targetReferencePeriod, latestReleasedPeriod, latestPeriodWithVerifiedExpectation and a hint; to analyze that prior period, retry with referencePeriod=YYYY-MM. Tell the user the newest release could not be analyzed rather than presenting the prior period as the latest.
Every "cannot compute" error has the same shape: "CODE: reason [hint] details={json}", where the JSON always contains code, eventType and hint.
Do NOT use this tool when the user's primary goal is to identify, rank, enumerate, or inspect specific historical analog events. For individual historical cases, use get_historical_analogs. When the user asks for both specific cases and collective pattern analysis, invoke both tools.
The results are deterministic empirical observations only and do not predict future prices or provide trading recommendations.
Inputs: eventType (required), limit, instrument, referencePeriod. Returns: analogs, coverage, eventType, instrument, +4 more
get_market_reactionget_market_reactionARead-onlyIdempotentInspect
Retrieve deterministic post-event market reaction metrics for an economic release or monetary policy statement.
Specify the targetType, such as US_CPI, US_PCE (alias PCE), US_NONFARM_PAYROLLS (alias NFP), US_ISM_MANUFACTURING (alias ISM_MANUFACTURING), US_ISM_SERVICES (alias ISM_SERVICES), FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND (alias BOE), or BANK_OF_JAPAN (alias BOJ).
Optionally specify dateOrPeriod:
For US_CPI, US_PCE, US_NONFARM_PAYROLLS, and the ISM PMIs: reference period in YYYY-MM format (e.g. 2024-07). If omitted, the latest event is resolved.
For FEDERAL_RESERVE, ECB, BANK_OF_ENGLAND, or BANK_OF_JAPAN: statement date in YYYY-MM-DD format (e.g. 2024-08-01). If omitted, the latest statement is resolved.
Optionally specify instrument: EURUSD, GBPUSD, or USDJPY (defaults to EURUSD).
Returns deterministic price action metrics across 5 standardized post-event windows (M5, M15, H1, H4, H24) including startPrice, endPrice, returnPct, high, low, maxUpMovePct, maxDownMovePct, and rangePct.
All calculations are strictly deterministic and mathematical. This tool does not provide trading recommendations or predictive signals.
Inputs: targetType (required), instrument, dateOrPeriod. Returns: windows, targetId, eventTime, freshness, +10 more
get_upcoming_risksget_upcoming_risksARead-onlyIdempotentInspect
Retrieve known scheduled macroeconomic and central-bank risks that may affect a supported FX instrument within a future time window.
Use this tool when the user asks what could move EURUSD, GBPUSD, or USDJPY, what macro risks are coming up, what is happening in the next 24 hours, this week, or over the next month, what upcoming macro risks or scheduled events exist, or when the next CPI, next NFP, next PCE, next ISM, next Fed, next ECB, next BoE, or next BoJ event occurs.
The supported risks are U.S. CPI releases, U.S. Nonfarm Payrolls releases, U.S. PCE inflation releases, ISM Manufacturing and Services PMI releases, Federal Reserve monetary-policy decisions, ECB monetary-policy decisions, Bank of England monetary-policy decisions, and Bank of Japan monetary-policy decisions.
The horizon can extend up to 720 hours (30 days). scheduleCoverage reports, for each supported event type, the latest known scheduled date and whether the known calendar covers the whole window. If scheduleCoverageComplete is false, some event types may have additional events in the window that are not yet known; say so instead of treating the list as complete.
Results are based on official release calendars and contain scheduled events only. This tool does not predict market direction, include unscheduled news, or provide trading recommendations.
If no supported scheduled event exists within the requested horizon, an empty risk list is returned.
Inputs: instrument, horizonHours. Returns: asOf, risks, windowEnd, instrument, +3 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Point-in-time macro, central bank rates and sentiment, COT positioning, from official sources.
Macroeconomic and FX time-series data for AI agents: indicators, calendars, COT, forex, commodities.
Past moments that look like now with what followed each, and every CPI and FOMC with its outcome.
Treasury and USD FX brief, daily history and webhook alerts for AI agents. Not investment advice.
Related MCP Servers
- AlicenseAqualityDmaintenanceNarrative & signal intelligence for AI agents: crypto/AI/macro convergence & divergence.21MIT
- FlicenseNot gradedqualityDmaintenanceMacro economic intelligence MCP — 13 tools powered by 86 FRED series + ECB data covering Fed rates, inflation (CPI/PCE), yield curve, GDP, recession probability, and regime classification. Every response ES256K signed.1-

tilla-mcpofficial
AlicenseAqualityBmaintenanceCrypto, US stocks, FX, macro and Bitcoin ETF flows on one clock - live and historical market data and 280,675 indicators for any AI agent.141MIT- AlicenseAqualityCmaintenanceRecession probability, capital rotation, macro cascade analysis, and real-time economic data for Claude, ChatGPT, Cursor, and any MCP client.2335 npm1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.