@allratestoday/mcp-server 0.7.16 → 0.7.17

package/README.md

@@ -31,7 +31,7 @@ After installation, your assistant can answer questions like:
 
 ## ⚖️ Mid-market vs official central-bank rates
 
-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 [122 central banks and 4 tax authorities](https://allratestoday.com/central-bank-rates-api/institutions/) (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.
+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 [123 central banks and 5 tax authorities](https://allratestoday.com/central-bank-rates-api/institutions/) (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.
 
 ## 🔑 Get your API key (free)
 
@@ -57,7 +57,7 @@ Install it with no configuration at all and it starts, connects, and answers:
 |---|---|---|
 | `get_exchange_rate` | ✅ | An **official central-bank rate**: the ECB reference table first, else the central bank that issues the target or source currency (USD/GBP → Bank of England, USD/INR → Reserve Bank of India). The response carries `bank`, `rate_date`, `derived` and a note saying so, so the assistant never passes it off as a live quote. Only pairs one bank publishes, or their inverses (flagged `derived: true`), work keyless; other crosses are refused with a pointer to the key. |
 | `list_currencies` | ✅ | All 160+ supported ISO 4217 codes. |
-| `list_central_banks` | ✅ | Codes, names and latest publication date of all [122 central banks and 4 tax authorities](https://allratestoday.com/central-bank-rates-api/institutions/). |
+| `list_central_banks` | ✅ | Codes, names and latest publication date of all [123 central banks and 5 tax authorities](https://allratestoday.com/central-bank-rates-api/institutions/). |
 | `get_official_rates` | ✅ | Latest **official table** (or one pair) published by any of them. A dated table needs a paid-plan key. |
 | `get_reference_rate` | ✅ | The **Daily Reference Rate**: one never-revised table per business day, fixed at 16:00 London. A past date needs a paid-plan key. |
 | `request_trial_key` | ✅ | Self-issues a 100-call, 7-day key with no account and adopts it for the session. |
@@ -129,8 +129,7 @@ Each client reads MCP servers from a different config file. Pick yours below.
 The fastest path uses the built-in CLI:
 
 ```bash
-claude mcp add allratestoday -- npx -y @allratestoday/mcp-server
-claude mcp env allratestoday ALLRATES_API_KEY=art_live_xxxxx
+claude mcp add allratestoday -e ALLRATES_API_KEY=art_live_xxxxx -- npx -y @allratestoday/mcp-server
 ```
 
 Restart Claude Code. Verify by asking it: *"What's the current USD to EUR rate?"*
@@ -375,7 +374,7 @@ All supported currencies with codes, names, and symbols. Cached upstream for 24
 
 ### `list_central_banks`
 
-Every official source the server can quote — [122 central banks](https://allratestoday.com/central-bank-rates-api/institutions/) plus HMRC, the US Treasury, Swiss BAZG and India's CBIC — with the `code` that `get_official_rates` takes as `bank`, the institution's name, its latest publication date, `age_days`, its publication `cadence` and a `stale` flag when it is behind its own schedule. Keyless.
+Every official source the server can quote — [123 central banks](https://allratestoday.com/central-bank-rates-api/institutions/) plus HMRC, the US Treasury, Swiss BAZG, India's CBIC and Peru's SUNAT — with the `code` that `get_official_rates` takes as `bank`, the institution's name, its latest publication date, `age_days`, its publication `cadence` and a `stale` flag when it is behind its own schedule. Keyless.
 
 **Input** — none.
 

package/dist/client.d.ts

@@ -78,7 +78,7 @@ export declare class AllRatesTodayClient {
         target: string;
         time: string;
     }[]>;
-    /** Every covered official source (121 central banks + 3 tax authorities). Keyless. */
+    /** Every covered official source (123 central banks + 5 tax authorities). Keyless. */
     listCentralBanks(): Promise<{
         sources: {
             code: string;

package/dist/client.js

@@ -200,7 +200,7 @@ export class AllRatesTodayClient {
                 : new NeedsKeyError('Multi-target rates'));
         return this.request('/v1/rates', params);
     }
-    /** Every covered official source (121 central banks + 3 tax authorities). Keyless. */
+    /** Every covered official source (123 central banks + 5 tax authorities). Keyless. */
     listCentralBanks() {
         return this.request(this.keyless ? '/open/central-banks' : '/v1/central-banks', {});
     }

package/dist/index.js

@@ -43,7 +43,7 @@ async function main() {
             '  Available now, no key needed:',
             '    • get_exchange_rate  — official central-bank rate (ECB, else the issuing bank)',
             '    • list_currencies    — all supported currency codes',
-            '    • list_central_banks — 121 central banks + 3 tax authorities we carry',
+            '    • list_central_banks — 123 central banks + 5 tax authorities we carry',
             '    • get_official_rates — latest official table (or one pair) from any of them',
             '    • get_reference_rate — Daily Reference Rate, one fixed table per business day (16:00 London)',
             '    • request_trial_key  — self-issue a 100-call, 7-day key without an account',
@@ -176,7 +176,7 @@ async function main() {
     });
     server.registerTool('list_central_banks', {
         title: 'List covered central banks & tax authorities',
-        description: "Call this FIRST when you need a bank code, or for 'which central banks do you cover?' / 'do you have rates from X?'. Returns every covered source — 121 central banks plus 3 tax authorities (HMRC, US Treasury, Swiss BAZG) — with `code` (what get_official_rates takes as `bank`), name, latest publication date and whether it is behind schedule. No API key needed.",
+        description: "Call this FIRST when you need a bank code, or for 'which central banks do you cover?' / 'do you have rates from X?'. Returns every covered source — 123 central banks plus 5 tax authorities (HMRC, US Treasury, Swiss BAZG, India CBIC, Peru SUNAT) — with `code` (what get_official_rates takes as `bank`), name, latest publication date and whether it is behind schedule. No API key needed.",
         inputSchema: {},
         outputSchema: {
             sources: z.array(z.object({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allratestoday/mcp-server",
-  "version": "0.7.16",
+  "version": "0.7.17",
   "mcpName": "io.github.cahthuranag/mcp-server",
   "description": "MCP server for AllRatesToday — let AI coding tools (Claude Code, Cursor, Claude Desktop) fetch real-time and historical currency exchange rates.",
   "keywords": [