io.github.cyanheads/exchange-rates-mcp-server
REMOTE · EXCHANGE-RATES.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3
Convert currencies, get FX rates, and query historical ECB exchange rate data.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 7 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability84
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1634 tokens (~136/item across 12 items; 7 tools + 5 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · exchange-rates.caseyjhand.com
claude mcp add --transport http cyanheads-exchange-rates-mcp-server https://exchange-rates.caseyjhand.com/mcp
[mcp_servers.cyanheads-exchange-rates-mcp-server] url = "https://exchange-rates.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-exchange-rates-mcp-server": {
"type": "remote",
"url": "https://exchange-rates.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-exchange-rates-mcp-server --url https://exchange-rates.caseyjhand.com/mcp --transport streamable-http
mcp_servers:
cyanheads-exchange-rates-mcp-server:
url: "https://exchange-rates.caseyjhand.com/mcp" {
"mcpServers": {
"cyanheads-exchange-rates-mcp-server": {
"type": "http",
"url": "https://exchange-rates.caseyjhand.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
- 31 Jul 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Tool “fx_dataframe_query” rewrote its description, which is the text the model reads security
- Tool “fx_get_rates” rewrote its description, which is the text the model reads security
- Tool “fx_get_timeseries” rewrote its description, which is the text the model reads security
- Tool “fx_get_rate” rewrote its description, which is the text the model reads security
- Tool “fx_dataframe_describe” rewrote its description, which is the text the model reads security
- Schema quality: 116 → 136 ▼ functional
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- Server version: 0.1.5 → 0.2.1 functional
- “fx_get_rates” reworded the description of “symbols” cosmetic
- “fx_convert_currency” reworded the description of “amount” cosmetic
- 30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 28 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 27 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Jul 26 68
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://exchange-rates.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 7 Jul 2026 | 5 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | 5aad900eb2055a0b0ea55912ec19680c |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC secure
Validation of exchange-rates.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| caseyjhand.com. | present | 2371 | 13 | Verified |
| exchange-rates.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://exchange-rates.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://exchange-rates.caseyjhand.com/mcp | HTTPS enforced | 301 | https://exchange-rates.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
fx_convert_currency Fx Convert Currency ~190
Convert an amount between any two currencies at the latest or a historical rate. Returns the converted amount, the rate used, the actual rate date, and whether the date was snapped from a weekend/holiday to the prior business day. Cross-rates are triangulated through EUR automatically.
| Name | Type | Req | Description |
|---|---|---|---|
| amount | number | yes | Amount in the base currency to convert. Must be greater than zero. |
| base_currency | string | yes | ISO 4217 source currency code (e.g. USD). Call fx_list_currencies to get valid codes. |
| date | string | — | ISO 8601 date (YYYY-MM-DD) for a historical rate. Omit for the latest available rate. ECB data starts 1999-01-04. Future dates are not supported. |
| quote_currency | string | yes | ISO 4217 target currency code (e.g. EUR). The amount will be expressed in this currency. |
| Name | Type | Req | Description |
|---|---|---|---|
| base_amount | number | yes | The input amount in the base currency. |
| base_currency | string | yes | Source currency code. |
| date_snapped | boolean | yes | True when the API returned a different date than requested — ECB silently snaps weekend/holiday requests to the prior business day. |
| quote_amount | number | yes | The converted amount in the quote currency, rounded to 6 decimal places. |
| quote_currency | string | yes | Target currency code. |
| rate | number | yes | Exchange rate used: units of quote currency per 1 unit of base currency. |
| rate_date | string | yes | Actual date of the rate used for conversion. |
| rate_type | string | yes | Always "ECB reference (mid-market)" — these are reference rates, not tradeable bid/ask. |
| source | string | yes | Always "ECB via Frankfurter" — the upstream data provider. |
No examples provided.
fx_dataframe_describe Fx Dataframe Describe ~112
List tables and columns staged on a DataCanvas from a prior fx_get_timeseries call. Required first step before fx_dataframe_query — use it to discover table names and column schemas. Requires DataCanvas (CANVAS_PROVIDER_TYPE=duckdb) — without it this tool is not listed at all and fx_get_timeseries returns every range inline.
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | Canvas ID returned by fx_get_timeseries. Re-run fx_get_timeseries to obtain a fresh canvas_id if this one has expired. |
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | The canvas ID echoed back — use this in fx_dataframe_query. |
| expires_at | string | yes | ISO 8601 timestamp when this canvas will be evicted. |
| tables | array | yes | All tables and views currently staged on this canvas. |
No examples provided.
fx_dataframe_query Fx Dataframe Query ~185
Run a read-only SQL SELECT against DataCanvas tables staged by fx_get_timeseries. Supports aggregations, GROUP BY, window functions, and JOINs across multiple registered tables. Run fx_dataframe_describe first to discover table names and column schemas. Requires DataCanvas (CANVAS_PROVIDER_TYPE=duckdb) — without it this tool is not listed at all and fx_get_timeseries returns every range inline.
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | Canvas ID returned by fx_get_timeseries. Re-run fx_get_timeseries to obtain a fresh canvas_id if this one has expired. |
| query | string | yes | Read-only SQL SELECT statement. Reference tables by the names returned by fx_dataframe_describe or the table_name field from fx_get_timeseries. Example: SELECT date, rate FROM fx_usd_eur WHERE date >… |
| Name | Type | Req | Description |
|---|---|---|---|
| canvas_id | string | yes | The canvas ID used — pass to a subsequent fx_dataframe_query or fx_dataframe_describe call. |
| row_count | number | yes | Rows returned. Equals the materialized row count; when truncated is true this is the row cap, not the full result size. Narrow the SELECT (add WHERE/LIMIT or aggregate) to see all rows. |
| rows | array | yes | Result rows, capped at the canvas row limit (default 10 000). Each key is a column name from the query. |
| truncated | boolean | yes | True when the query produced more rows than the canvas row cap and the result was capped. Refine the query to materialize the complete result. |
No examples provided.
fx_get_rate Fx Get Rate ~224
Get the exchange rate for a currency pair on a given date (default: latest). Returns the rate, the actual rate date (which may differ from the requested date on weekends/holidays — ECB publishes business days only), and source provenance. Cross-rates are triangulated through EUR automatically. A same-currency pair returns a rate of 1, dated to the same publication day any other pair would report for that date. Use fx_convert_currency when you want the converted amount; use this tool when you only need the rate number.
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | ISO 4217 base currency code (e.g. USD). Call fx_list_currencies to get valid codes. |
| date | string | — | ISO 8601 date (YYYY-MM-DD). Omit for the latest available rate. ECB data starts 1999-01-04. Future dates are not supported. |
| quote_currency | string | yes | ISO 4217 quote currency code (e.g. EUR). The rate is expressed as "how many quote units per 1 base unit". |
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | The base currency code. |
| date_snapped | boolean | yes | True when the API returned a different date than requested — ECB silently snaps weekend/holiday requests to the prior business day. |
| quote_currency | string | yes | The quote currency code. |
| rate | number | yes | Exchange rate: units of quote currency per 1 unit of base currency. |
| rate_date | string | yes | Actual date of the rate returned. |
| rate_type | string | yes | Always "ECB reference (mid-market)" — these are reference rates, not tradeable bid/ask. |
| source | string | yes | Always "ECB via Frankfurter" — the upstream data provider. |
No examples provided.
fx_get_rates Fx Get Rates ~199
Get all available exchange rates for one base currency in a single snapshot. Useful for bulk comparison and seeding downstream tools. Returns a map of quote currency → rate plus the snapshot date. Optionally filter to a subset of quote currencies via symbols. Listing the base currency itself in symbols is accepted and returns a rate of 1 for it.
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | ISO 4217 base currency code (e.g. USD). Call fx_list_currencies to get valid codes. |
| date | string | — | ISO 8601 date (YYYY-MM-DD). Omit for the latest available rate. ECB data starts 1999-01-04. Future dates are not supported. |
| symbols | array | — | Optional list of quote currency codes to filter the response. Omit to return all ~30 supported currencies (the base is not among them). Including base_currency here is valid — it comes back with a ra… |
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | The base currency code. |
| rate_date | string | yes | Actual date of the rates. May differ from requested date on weekends/holidays — ECB publishes business days only; the API silently snaps to the prior business day. |
| rate_type | string | yes | Always "ECB reference (mid-market)" — these are reference rates, not tradeable bid/ask. |
| rates | object | yes | Map of quote currency code → exchange rate (units of quote per 1 base). |
| source | string | yes | Always "ECB via Frankfurter" — the upstream data provider. |
No examples provided.
fx_get_timeseries Fx Get Timeseries ~360
Get historical daily exchange rates for a currency pair over a date range. ECB publishes on business days only — weekends and holidays produce no entry, and no date outside the requested range is ever returned, so a range covering only non-publication days comes back with an empty rates map and a notice explaining why. A same-currency pair returns a rate of 1 on each publication day in the range. Short ranges (≤90 days by default) are returned inline as a date→rate map. When DataCanvas is enabled (CANVAS_PROVIDER_TYPE=duckdb) long ranges spill to it: the response carries spilled=true, a canvas_id, and a table_name — call fx_dataframe_describe to inspect the staged table, then fx_dataframe_query to run SQL against it. Without DataCanvas long ranges stay inline (spilled=false) and the notice says so.
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | ISO 4217 base currency code (e.g. USD). Call fx_list_currencies to get valid codes. |
| canvas_id | string | — | Optional canvas ID from a prior call. Omit on the first call to start a fresh canvas; pass the returned canvas_id to append tables to an existing canvas. |
| end_date | string | yes | ISO 8601 end date (YYYY-MM-DD). Must be >= start_date. Future dates are not supported. |
| quote_currency | string | yes | ISO 4217 quote currency code (e.g. EUR). Call fx_list_currencies to get valid codes. |
| start_date | string | yes | ISO 8601 start date (YYYY-MM-DD). ECB data starts 1999-01-04. The actual first data point may be later if start_date falls on a weekend/holiday. |
| Name | Type | Req | Description |
|---|---|---|---|
| base_currency | string | yes | Base currency code. |
| canvas_id | string | — | Canvas ID — present when spilled is true. Pass to fx_dataframe_query. |
| end_date | string | yes | Last date in the returned series. Always inside the requested range — earlier than the requested end when that day had no ECB fix, and equal to it when the series is empty. |
| notice | string | — | Explains a result that would otherwise look broken — an empty series, or a long range that stayed inline because DataCanvas is not configured. |
| quote_currency | string | yes | Quote currency code. |
| rate_count | number | yes | Total number of data points (publication days) inside the requested range. |
| rate_type | string | yes | Always "ECB reference (mid-market)" — these are reference rates, not tradeable bid/ask. |
| rates | object | yes | Date → rate map for the inline result. Publication days inside the requested range only. Truncated to a preview when the result was spilled to canvas; empty when the range contains no publication day… |
| source | string | yes | Always "ECB via Frankfurter" — the upstream data provider. |
| spilled | boolean | yes | True when the full result was staged on the DataCanvas (range exceeded threshold). |
| start_date | string | yes | First date in the returned series. Always inside the requested range — later than the requested start when that day had no ECB fix, and equal to it when the series is empty. |
| table_name | string | — | Canvas table name — present when spilled is true. Use in fx_dataframe_query SQL. |
No examples provided.
fx_list_currencies Fx List Currencies ~67
List all supported ISO 4217 currency codes with their full names. Call this before converting to disambiguate "dollars" (USD vs AUD vs CAD vs HKD vs SGD) or to validate a user-supplied currency code. Covers the ~30 ECB reference currencies.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| count | number | yes | Total number of supported currencies. |
| currencies | array | yes | All supported currencies, sorted alphabetically by code. |
| source | string | yes | Always "ECB via Frankfurter" — the upstream data provider. |
No examples provided.