@allratestoday/mcp-server 0.7.12 → 0.7.13

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 CHANGED
@@ -36,8 +36,7 @@ With a key, `get_exchange_rate`, `get_historical_rates` and `get_rates_authentic
36
36
  ## 🔑 Get your API key (free)
37
37
 
38
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**.
39
+ multi-target lookups. The free tier is enough for development and trying it out — **no credit card required**.
41
40
  Historical series, point-in-time lookups and dated official and reference-rate
42
41
  tables need a paid plan from €4.99/month.
43
42
 
@@ -469,7 +468,7 @@ Set these in your MCP client's config (in the `env` block) — not in your shell
469
468
 
470
469
  ## 💳 Plans
471
470
 
472
- A free tier and paid plans are available — see [allratestoday.com/pricing](https://allratestoday.com/pricing) for current quotas. The free tier is 300 requests, lifetime (it never resets), and covers real-time rates and multi-target lookups. All history and dated rates — mid-market history, point-in-time lookups, dated official and reference-rate tables — need a paid plan (free and trial keys get `403 historical_requires_paid_plan`). The Official Rates plan covers official central-bank and tax-authority rates only (no market rates).
471
+ A free tier and paid plans are available — see [allratestoday.com/pricing](https://allratestoday.com/pricing) for current quotas. The free tier covers real-time rates and multi-target lookups. All history and dated rates — mid-market history, point-in-time lookups, dated official and reference-rate tables — need a paid plan (free and trial keys get `403 historical_requires_paid_plan`). The Official Rates plan covers official central-bank and tax-authority rates only (no market rates).
473
472
 
474
473
  ## 🛠️ Troubleshooting
475
474
 
@@ -481,7 +480,7 @@ A free tier and paid plans are available — see [allratestoday.com/pricing](htt
481
480
  | `HTTP 403 — Historical rates require a paid plan` | `get_historical_rates`, or `time` on `get_rates_authenticated`, on a free or trial key | Upgrade at /pricing — history is paid-only |
482
481
  | `HTTP 403 — Historical central bank rates require a paid plan` | `date` given to `get_official_rates` / `get_reference_rate` on a free key | Omit `date` for the latest table, or upgrade at /pricing |
483
482
  | Every call returns "Invalid AllRatesToday API key" | Key is malformed (missing prefix, truncated, or revoked) | Copy a fresh key from the dashboard |
484
- | Tools return "AllRatesToday API quota exceeded" | Quota used up — the free tier is 300 requests lifetime and never resets; paid plans are monthly | Upgrade at [/pricing](https://allratestoday.com/pricing) |
483
+ | Tools return "AllRatesToday API quota exceeded" | Quota used up — the free tier does not reset; paid plans are monthly | Upgrade at [/pricing](https://allratestoday.com/pricing) |
485
484
  | Historical tool returns "Bad request" | Invalid period or unknown currency code | Period must be `1d`/`7d`/`30d`/`1y`; codes must be 3 letters |
486
485
  | Server starts but tools never appear | Client didn't reload after config change | Fully quit (not just close) and reopen the client |
487
486
  | `npx` runs but hangs forever | The server is waiting for an MCP client to connect — normal when run from a shell | Let your MCP client launch it |
@@ -511,7 +510,7 @@ The server maps API errors to clear, actionable messages the assistant can relay
511
510
  ## ❓ FAQ
512
511
 
513
512
  **Is the free plan really enough for normal use?**
514
- For trying it out and light dev use. It is 300 requests in total (lifetime, no monthly reset); regular use or production needs a paid tier. Keyless mode costs nothing and has no quota.
513
+ For trying it out and light dev use. It does not reset monthly; regular use or production needs a paid tier. Keyless mode costs nothing and has no quota.
515
514
 
516
515
  **Do you store my conversation or query data?**
517
516
  No. Only your API key and the request parameters (source, target, period, time) are sent to allratestoday.com — never the LLM's conversation context.
@@ -567,7 +566,7 @@ Recent changes. Full history: [GitHub Releases](https://github.com/AllRates-Toda
567
566
  - **0.7.9** — README: changelog trimmed to the 0.7.x line
568
567
  - **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
569
568
  - **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`
570
- - **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
569
+ - **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, lifetime free tier
571
570
  - **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)
572
571
 
573
572
  ## 🔗 Links
package/dist/client.js CHANGED
@@ -143,7 +143,7 @@ export class AllRatesTodayClient {
143
143
  adopted: Boolean(key),
144
144
  note: 'This server now uses the trial key for the rest of this session. To keep it after a restart, ' +
145
145
  'put it in the MCP config: "env": { "ALLRATES_API_KEY": "<key>" }. For a lasting key register free ' +
146
- 'at https://allratestoday.com/register (300 calls) or see https://allratestoday.com/pricing.',
146
+ 'at https://allratestoday.com/register (free) or see https://allratestoday.com/pricing.',
147
147
  };
148
148
  }
149
149
  async getRate(source, target) {
package/dist/index.js CHANGED
@@ -273,7 +273,7 @@ async function main() {
273
273
  });
274
274
  server.registerTool('request_trial_key', {
275
275
  title: 'Request a trial API key',
276
- description: 'Self-issue an AllRatesToday API key with 100 lifetime calls, valid 7 days, with no account and no email. Use it when another tool answered "needs an API key" and the user wants real-time rates or history right now. The key is adopted by this server for the rest of the session and returned once — tell the user to put it in the MCP config as ALLRATES_API_KEY to keep it. Capped at 3 keys per IP per day. For a lasting key, register at https://allratestoday.com/register (free, 300 calls) or see https://allratestoday.com/pricing.',
276
+ description: 'Self-issue an AllRatesToday API key with 100 lifetime calls, valid 7 days, with no account and no email. Use it when another tool answered "needs an API key" and the user wants real-time rates or history right now. The key is adopted by this server for the rest of the session and returned once — tell the user to put it in the MCP config as ALLRATES_API_KEY to keep it. Capped at 3 keys per IP per day. For a lasting key, register at https://allratestoday.com/register (free) or see https://allratestoday.com/pricing.',
277
277
  inputSchema: {
278
278
  agent: z.string().max(80).optional().describe('Optional: the agent or product requesting the key.'),
279
279
  purpose: z.string().max(200).optional().describe('Optional: one line on what the rates are for.'),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@allratestoday/mcp-server",
3
- "version": "0.7.12",
3
+ "version": "0.7.13",
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": [