@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.
Files changed (2) hide show
  1. package/README.md +19 -25
  2. 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
- See [GitHub Releases](https://github.com/AllRates-Today/mcp-server/releases) for the full list. Recent highlights:
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.8",
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": [