EMpulse Street FX Index

io.github.empulse-aiPublished by GitHub account empulse-aiv1.0.0Updated Oct 26, 2026

Street FX rates of emerging-market currencies vs USD: latest, history, premium, stress, events

VerifiedStreamable HTTPWeb executableFinanceBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for EMpulse Street FX Index: street exchange rates of emerging-market currencies vs USD, plus payment-rail and liquidity data.

What you can do
  • Look up latest or dated street rates, buy/sell, spread, changes and confidence for a currency
  • Pull daily rate history over a date range and list covered currencies with plan coverage
  • Compare street rates with official central-bank rates, and read stress flags and dated FX events
  • Check payment-rail health and status incidents, unmet payment demand and USDT liquidity by market
  • Read the index methodology and request a free API key by email
When to use it
Useful when an assistant needs emerging-market street FX rates, currency-premium or stress signals, or payment-rail reliability for a country, with citations attached to each figure. It suits research, reporting and market-monitoring questions rather than official or interbank rate lookups.
Requirements
Remote endpoint at api.empulse.ai over streamable HTTP; no local runtime needed. An optional API key is sent in the X-API-Key header (or EMPULSE_API_KEY for the stdio bridge); without it the free level applies. A free key can be requested by email. Network access required.
Before you install
The API key is a credential sent in the X-API-Key header; keep it out of shared configs. request_free_key sends an email address to the provider and returns a key. Some tools (official-vs-street, hourly, rail incidents, parts of unmet demand and liquidity) need paid Pro or Enterprise plans. Figures are third-party street estimates, not official rates or investment advice.

Installation

In SourceWeft

  1. Open EMpulse Street FX Index in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.empulse-ai%2Fempulse-street-fx/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "empulse-street-fx-index": {
      "type": "http",
      "url": "https://api.empulse.ai/mcp"
    }
  }
}

README

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-mcpEMPULSE_API_KEY=emp_... uvx empulse-mcp

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

json
{  "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).

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).

Source: README.md at commit 51065da

Tools

13

get_street_rate

Street rate of a currency

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.

Parametersdatelangcurrencyrequired

get_rate_history

Street rate history

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.

Parameterslangto_datecurrencyrequiredfrom_date

list_currencies

Covered currencies

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.

Takes no parameters.

get_official_vs_street

Official vs street premium

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.

Parameterslangcurrencyrequired

get_stress_signals

FX stress signals

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.

Parameterscurrency

get_fx_events

Currency-infrastructure events

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).

Parametersdayscountrycurrency

get_hourly

Hourly street rates (Pro)

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.

Parametersdatecurrencyrequired

get_rail_health

Payment rails of a country today

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.

Parameterscurrencyrequired

get_rail_incidents

Payment-rail status changes (Pro)

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.

Parametersdayscurrency

get_unmet_demand

Unmet payment demand

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.

Parameterscurrency

get_usdt_liquidity

USDT liquidity of a currency

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.

Parameterscurrencyrequired

get_methodology

Methodology and how to cite

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

Takes no parameters.

request_free_key

Request a free API key

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.

Parametersemailrequired

Version history

1
  1. v1.0.0LatestOct 26, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.