@allratestoday/mcp-server 0.7.17 → 0.7.19

package/README.md

@@ -8,6 +8,8 @@ Website: https://allratestoday.com · Hosted endpoint (no install): https://allr
 [![MCP](https://img.shields.io/badge/Model%20Context%20Protocol-1.x-blue.svg)](https://modelcontextprotocol.io)
 [![TypeScript](https://img.shields.io/badge/TypeScript-3178C6.svg)](https://www.typescriptlang.org/)
 
+[![AllRatesToday MCP server](https://mcprush.com/badge/allratestoday-mcp/card.svg)](https://mcprush.com/to/allratestoday-mcp?ref=badge)
+
 English | [简体中文](./README-zh-CN.md)
 
 **Give your AI assistant a live window into the foreign-exchange market. A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client fetch real-time currency rates, historical series, and multi-currency lookups from the [AllRatesToday API](https://allratestoday.com).**
@@ -31,7 +33,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 [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.
+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 [130+ central banks and 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 +59,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 [123 central banks and 5 tax authorities](https://allratestoday.com/central-bank-rates-api/institutions/). |
+| `list_central_banks` | ✅ | Codes, names and latest publication date of all [130+ central banks and 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. |
@@ -374,7 +376,7 @@ All supported currencies with codes, names, and symbols. Cached upstream for 24
 
 ### `list_central_banks`
 
-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.
+Every official source the server can quote — [120+ 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.
 
@@ -579,6 +581,7 @@ Recent changes. Full history: [GitHub Releases](https://github.com/AllRates-Toda
 - [Status](https://allratestoday.com/status)
 - [Postman collection](https://allratestoday.com/postman/)
 - [ChatGPT app](https://chatgpt.com/plugins/plugin_asdk_app_6ae1e76098f48191a285ac3f5ab7a83b) — ask ChatGPT for live and official central bank rates
+- [OpenAPI reference on Bump.sh](https://bump.sh/allratestoday/doc/allratestoday-api) — also on [SwaggerHub](https://app.swaggerhub.com/apis-docs/allratestoday/allratestoday-exchange-rate-central-bank-rates-api/2.2.0)
 
 ## 📜 License
 

package/dist/client.d.ts

@@ -78,7 +78,7 @@ export declare class AllRatesTodayClient {
         target: string;
         time: string;
     }[]>;
-    /** Every covered official source (123 central banks + 5 tax authorities). Keyless. */
+    /** Every covered official source (130+ central banks and 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 (123 central banks + 5 tax authorities). Keyless. */
+    /** Every covered official source (130+ central banks and 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 — 123 central banks + 5 tax authorities we carry',
+            '    • list_central_banks — 130+ central banks and 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 — 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.",
+        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 — 130+ central banks and 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.17",
+  "version": "0.7.19",
   "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": [