@allratestoday/mcp-server 0.7.9 → 0.7.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -14
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -33,6 +33,23 @@ After installation, your assistant can answer questions like:
|
|
|
33
33
|
|
|
34
34
|
With a key, `get_exchange_rate`, `get_historical_rates` and `get_rates_authenticated` return a **mid-market rate**, refreshed every ~60 seconds — the right number for price display, conversion, and anything that should track the market. It is *not* the official rate a tax authority or auditor may require. For those, call **`get_official_rates`**: the latest table published by any of 121 central banks and 3 tax authorities (ECB, Fed, HMRC, US Treasury, Swiss BAZG, …), fixed once published and carrying the institution's own `rate_date`, no key needed. `list_central_banks` gives the codes. Dated official tables (a past `date`) need an API key on a **paid plan** — a free key gets `403 Historical central bank rates require a paid plan`. Mid-market history (`get_historical_rates`, and `time` on `get_rates_authenticated`) is paid-plan too — free and trial keys get `403`. See the [central bank REST API](https://allratestoday.com/docs/#central-bank) and [per-bank npm SDKs](https://allratestoday.com/central-bank-rates-api/). The two can diverge by several percent, so pick by use case, not convenience.
|
|
35
35
|
|
|
36
|
+
## 🔑 Get your API key (free)
|
|
37
|
+
|
|
38
|
+
A key unlocks **real-time mid-market rates across 160+ currencies** and
|
|
39
|
+
multi-target lookups. The free tier (300 requests, lifetime — it does not reset
|
|
40
|
+
monthly) is enough for development and trying it out — **no credit card required**.
|
|
41
|
+
Historical series, point-in-time lookups and dated official and reference-rate
|
|
42
|
+
tables need a paid plan from €4.99/month.
|
|
43
|
+
|
|
44
|
+
1. Register at [allratestoday.com/register](https://allratestoday.com/register) — 30 seconds
|
|
45
|
+
2. Verify your email
|
|
46
|
+
3. Copy your key from the dashboard (format: `art_live_xxxxx`)
|
|
47
|
+
4. Use it as `ALLRATES_API_KEY` in the configs below
|
|
48
|
+
|
|
49
|
+
Without one the server prints a short summary of keyless mode (below) on stderr and
|
|
50
|
+
keeps running — it never exits, because an MCP server that exits breaks the
|
|
51
|
+
host client's whole configuration.
|
|
52
|
+
|
|
36
53
|
## 🔓 Keyless mode — what works with no setup
|
|
37
54
|
|
|
38
55
|
Install it with no configuration at all and it starts, connects, and answers:
|
|
@@ -51,22 +68,13 @@ Install it with no configuration at all and it starts, connects, and answers:
|
|
|
51
68
|
The keyless path reads the open, edge-cached `/api/open/central-bank/{bank}`
|
|
52
69
|
endpoints — no upstream cost, no rate limit to trip over, nothing to sign up for.
|
|
53
70
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
A key unlocks **real-time mid-market rates across 160+ currencies** and
|
|
57
|
-
multi-target lookups. The free tier (300 requests, lifetime — it does not reset
|
|
58
|
-
monthly) is enough for development and trying it out — **no credit card required**.
|
|
59
|
-
Historical series, point-in-time lookups and dated official and reference-rate
|
|
60
|
-
tables need a paid plan from €4.99/month.
|
|
71
|
+
**Attribution.** Keyless use requires a visible, followable link to AllRatesToday wherever the rates are shown (a footer, an about page, a README). With an API key it is appreciated but not required.
|
|
61
72
|
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
4. Use it as `ALLRATES_API_KEY` in the configs below
|
|
73
|
+
```html
|
|
74
|
+
<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>
|
|
75
|
+
```
|
|
66
76
|
|
|
67
|
-
|
|
68
|
-
keeps running — it never exits, because an MCP server that exits breaks the
|
|
69
|
-
host client's whole configuration.
|
|
77
|
+
Markdown: `Exchange rates by [AllRatesToday](https://allratestoday.com)`. Full wording: <https://allratestoday.com/terms/#attribution>.
|
|
70
78
|
|
|
71
79
|
## 🧩 Easiest install: the Claude Code plugin
|
|
72
80
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allratestoday/mcp-server",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.11",
|
|
4
4
|
"mcpName": "io.github.cahthuranag/mcp-server",
|
|
5
5
|
"description": "MCP server for AllRatesToday — let AI coding tools (Claude Code, Cursor, Claude Desktop) fetch real-time and historical currency exchange rates.",
|
|
6
6
|
"keywords": [
|