Skip to main content
Glama
EMpulse Street FX Index

EMpulse Street FX Index

Official
by empulse-ai

empulse-mcp

A small stdio bridge to the EMpulse Street FX Index MCP server (https://api.empulse.ai/mcp) for clients that only speak stdio. Standard library only, no build step: every JSON-RPC message from stdin is posted to the remote server and the answer is written to stdout. Clients that support remote servers can skip this package and connect to the URL directly — see https://github.com/empulse-ai/empulse-mcp#connect.

Install and run

uvx empulse-mcp                       # or: pipx run empulse-mcp
EMPULSE_API_KEY=emp_... uvx empulse-mcp

Client configuration (Claude Desktop, Cursor, Windsurf, Zed, …):

{
  "mcpServers": {
    "empulse": {
      "command": "uvx",
      "args": ["empulse-mcp"],
      "env": { "EMPULSE_API_KEY": "emp_..." }
    }
  }
}

Environment: EMPULSE_API_KEY (optional — without it the free level applies: free currencies, data up to yesterday, a daily limit per network), EMPULSE_MCP_URL (default https://api.empulse.ai/mcp).

Related MCP server: latamfx-mcp

What the server offers

Street exchange rates of emerging-market currencies against the US dollar — the rate people actually pay where the official rate is managed, lagging or unavailable — built from transaction-based market data and quotes from independent public market sources, with a confidence class and the number of sources on every figure.

Tools: get_street_rate, get_rate_history, list_currencies, get_official_vs_street, get_stress_signals, get_fx_events, get_hourly, get_rail_health, get_rail_incidents, get_unmet_demand, get_usdt_liquidity, get_news_sentiment, get_rate_stack, get_corridor, get_methodology, request_free_key. Resources: empulse://methodology, empulse://coverage, empulse://pricing. Every answer carries source, as_of, confidence and a ready citation. Full description: https://empulse.ai/llms.txt · API docs: https://api.empulse.ai/docs

Citing

Cite as EMpulse Street FX Index with a link to the currency page (https://empulse.ai/rates/<CUR>). Street rates are not official or interbank rates and not investment advice. Terms: https://empulse.ai/terms

License

MIT for this bridge. The data is served under the EMpulse terms (https://empulse.ai/terms).

Available Tools

13 tools
get_fx_eventsCurrency-infrastructure eventsAInspect

A dated feed of events that move street FX in emerging markets — devaluations, cash and withdrawal limits, bans of stablecoin services, currency controls, payment outages — each a short quotation with a link to the public source. Filter by country or currency; days back from the latest day of your plan (free: 48-hour delay).

Inputs: days, country, currency. Returns: object

get_hourlyHourly street rates (Pro)AInspect

The street rate of a currency per UTC hour for one day, with the day's summary (vwap, high, low, hours, busiest hour). Pro and Enterprise keys; hours arrive with the daily update.

Inputs: currency (required), date. Returns: object

get_methodologyMethodology and how to citeAInspect

How the EMpulse Street FX Index is computed — components, confidence classes, outliers, revisions, coverage rules — as markdown, with the citation format.

Inputs: no named parameters. Returns: object

get_official_vs_streetOfficial vs street premiumBInspect

How far the street rate of a currency is from its official central-bank rate: official rate and its publication day, street rate, premium in percent, 7-day average and 30-day maximum. Pro and Enterprise keys.

Inputs: currency (required), lang. Returns: object

get_rail_healthPayment rails of a country todayAInspect

Which payment methods work in a country today and how reliably: for every method class (cards, bank transfers, instant transfers, e-wallets, mobile money, cash, crypto, direct local rails) and direction (pay-ins, payouts) a status — healthy / degraded / outage / no_data — with the time it began and a ready citation. Free level: the free currencies, one day behind. Pro keys of the Rail Health Index: today, every currency, the health index (100 = the rail's own norm), availability, supply.

Inputs: currency (required). Returns: object

get_rail_incidentsPayment-rail status changes (Pro)AInspect

Every change of status of a payment method class — degraded, outage, back to healthy — over the last days (default 30), newest first, each with a one-line summary ("Bank transfers (pay-ins) in Egypt: degraded since 2026-10-24 14:00 UTC"). Optionally one currency. Pro keys of the Rail Health Index.

Inputs: days, currency. Returns: object

get_rate_historyStreet rate historyAInspect

Daily street rates of a currency between two dates (inclusive, UTC days, at most 400 days per call): rate, buy, sell, confidence per day, plus a summary (first, last, change, low, high). Defaults: the last 30 days up to the latest day of your plan.

Inputs: currency (required), lang, to_date, from_date. Returns: object

get_street_rateStreet rate of a currencyAInspect

The latest street exchange rate of an emerging-market currency against the US dollar (USDT) from the EMpulse Street FX Index, or the rate on a given day: rate (mid), buy, sell, spread, 1/7/30-day changes, confidence class and a ready citation. Free access is delayed by one day; a Pro key gives the current day.

Inputs: currency (required), date, lang. Returns: object

get_stress_signalsFX stress signalsAInspect

Early warning from the street: a none / watch / alert flag per currency when the street market shows stress (a run of weakening days, a 7-day move in the top decile of the currency's own year, a buy–sell spread blow-out), with the rules that fired and the day the episode started. One currency or all. Pro and Enterprise keys.

Inputs: currency. Returns: object

get_unmet_demandUnmet payment demandAInspect

Where payment demand in emerging markets is not being served. Without a currency: the ranking of covered markets by the share of demand no rail served, with the trend. With a currency: its rank and trend (free level, one day behind); Pro keys of the Unmet Demand Map also get the unmet share, the not-connected share, the index against the 90-day norm, the reason classes and the hours of day, per direction and method class.

Inputs: currency. Returns: object

get_usdt_liquidityUSDT liquidity of a currencyAInspect

Where and when the dollar actually moves through USDT: the liquidity index of a currency (0–100, 50 = the market's own 90-day norm) with a ready citation. Free level: yesterday, the free currencies. Pro keys of USDT Liquidity & Premium: today, every currency, the pay-in / payout balance, the spread, the active hours of day, the premium over the official rate and the supply class.

Inputs: currency (required). Returns: object

list_currenciesCovered currenciesAInspect

Every currency of the EMpulse Street FX Index with its status (active, or coverage in progress while market sources are being added), the confidence class and the number of sources behind the latest day, coverage since, and whether your plan covers it.

Inputs: no named parameters. Returns: object

request_free_keyRequest a free API keyAInspect

Issue a free EMpulse API key for an email address, right here: the free currencies, data up to yesterday, 100 calls per day. The key is returned and also emailed with a ready example; send it in the X-API-Key header on this server and on the REST API.

Inputs: email (required). Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a clearly distinct data product or time granularity: latest rate, historical range, hourly rates, official-vs-street premium, stress signals, events, rail health, rail incidents, unmet demand, and USDT liquidity. The descriptions make the boundaries explicit, so an agent should not confuse similar-sounding tools like get_street_rate, get_rate_history, and get_hourly.

    Naming Consistency5/5

    All tools use snake_case with a predictable verb_noun or verb_noun_phrase pattern: get_*, list_*, and request_*. There are no mixed conventions or vague names.

    Tool Count5/5

    The set has 13 tools, which is well within a reasonable range for a multi-index FX and payments data API. Each tool appears to correspond to a distinct dataset or operation, with no obvious filler.

    Completeness4/5

    The surface covers the core lifecycle for this data domain: latest rates, history, hourly data, currency coverage, official comparisons, stress signals, events, rail health and incidents, unmet demand, USDT liquidity, methodology, and free-key issuance. Minor gaps remain, such as no explicit multi-currency latest-rate batch operation or account/usage management beyond requesting a free key, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Real-time Argentine exchange rates for AI agents. Dollar blue, oficial, MEP, CCL, crypto rates plus currency conversion and spread calculator.
      6
      8 npm
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to query public Latin American FX rates and perform auditable ledger reconciliation using a multi-rule matching engine.
      6
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides African central bank official and parallel market exchange rates with cross-provider reconciliation and staleness reporting for AI agents.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Exposes Argentine market data to AI agents, including MEP, CCL, official, blue and other dollar quotes, plus simulated USD/ARS paper-trading orders with deterministic risk guardrails, a kill switch and an auditable call log.
      5
      MIT