@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.
Files changed (2) hide show
  1. package/README.md +22 -14
  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,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
- ## 🔑 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.
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
- 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
73
+ ```html
74
+ <a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>
75
+ ```
66
76
 
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.
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.9",
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": [