@allratestoday/mcp-server 0.7.8 → 0.7.10
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 +19 -25
- 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,23 +68,6 @@ 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
|
-
## 🔑 Get your API key (free)
|
|
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.
|
|
61
|
-
|
|
62
|
-
1. Register at [allratestoday.com/register](https://allratestoday.com/register) — 30 seconds
|
|
63
|
-
2. Verify your email
|
|
64
|
-
3. Copy your key from the dashboard (format: `art_live_xxxxx`)
|
|
65
|
-
4. Use it as `ALLRATES_API_KEY` in the configs below
|
|
66
|
-
|
|
67
|
-
Without one the server prints a short summary of keyless mode on stderr and
|
|
68
|
-
keeps running — it never exits, because an MCP server that exits breaks the
|
|
69
|
-
host client's whole configuration.
|
|
70
|
-
|
|
71
71
|
## 🧩 Easiest install: the Claude Code plugin
|
|
72
72
|
|
|
73
73
|
If you use Claude Code, install the plugin instead of configuring this server by
|
|
@@ -554,19 +554,13 @@ server.json # MCP registry manifest
|
|
|
554
554
|
|
|
555
555
|
## 📝 Changelog
|
|
556
556
|
|
|
557
|
-
|
|
557
|
+
Recent changes. Full history: [GitHub Releases](https://github.com/AllRates-Today/mcp-server/releases).
|
|
558
558
|
|
|
559
|
+
- **0.7.9** — README: changelog trimmed to the 0.7.x line
|
|
559
560
|
- **0.7.8** — README: MCP Inspector test guide, example prompts for every tool, hosted `?api_key=` security note, ChatGPT FAQ and 401 row corrected, history consistently paid-plan
|
|
560
561
|
- **0.7.6** — Keyless `get_rates_authenticated` with `time` now says a paid plan is needed; README: free tier no longer listed as covering history, `source` example is `mid-market`
|
|
561
562
|
- **0.7.4** — Keyless `get_exchange_rate` falls back from the ECB table to the central bank that issues the target or source currency (USD/GBP, GBP/JPY, USD/INR now answer keyless), same as the hosted endpoint; response adds `bank`. Dated-table errors say a paid plan is needed. README: real response shapes, tool counts, 300-lifetime free tier
|
|
562
563
|
- **0.7.0** — `get_reference_rate` (Daily Reference Rate, 16:00 London, keyless latest table) and `request_trial_key` (self-issued 100-call trial key adopted for the session)
|
|
563
|
-
- **0.6.1** — README: Claude Code plugin and hosted `/api/mcp` endpoint cross-links; coverage wording refreshed
|
|
564
|
-
- **0.6.0** — Official rates: new keyless `list_central_banks` and `get_official_rates` tools expose the latest table from 121 central banks + 3 tax authorities (dated tables need the key)
|
|
565
|
-
- **0.5.0** — Keyless mode: the server starts and answers without an API key (`get_exchange_rate` via the open ECB reference table, `list_currencies` unchanged); metered tools return actionable sign-up guidance instead of the process exiting
|
|
566
|
-
- **0.4.x** — README overhaul; registry metadata updates
|
|
567
|
-
- **0.3.x** — API key required for all tools; fail-fast at startup with clear error
|
|
568
|
-
- **0.2.x** — Removed news tool, required auth on `get_historical_rates`
|
|
569
|
-
- **0.1.x** — Initial release with 5 tools
|
|
570
564
|
|
|
571
565
|
## 🔗 Links
|
|
572
566
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allratestoday/mcp-server",
|
|
3
|
-
"version": "0.7.
|
|
3
|
+
"version": "0.7.10",
|
|
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": [
|