@allratestoday/central-bank-mcp 0.2.3 → 0.3.1

package/README.md

@@ -1,12 +1,14 @@
 # Central Bank Rates MCP Server — @allratestoday/central-bank-mcp
 
+Website: https://allratestoday.com/central-bank-rates-api/ · Hosted endpoint (no install): https://allratestoday.com/api/mcp · Docs: https://allratestoday.com/mcp/
+
 [![npm version](https://img.shields.io/npm/v/@allratestoday/central-bank-mcp.svg)](https://www.npmjs.com/package/@allratestoday/central-bank-mcp)
 [![npm downloads](https://img.shields.io/npm/dm/@allratestoday/central-bank-mcp.svg)](https://www.npmjs.com/package/@allratestoday/central-bank-mcp)
 [![license](https://img.shields.io/npm/l/@allratestoday/central-bank-mcp.svg)](./LICENSE)
 [![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/)
 
-**Give your AI assistant the official exchange rates that compliance, tax, and accounting actually require. A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client fetch published central-bank and tax-authority rates from 60+ institutions — ECB, Fed, Bank of Japan, HMRC, US Treasury, and more — via the [AllRatesToday API](https://allratestoday.com/central-bank-rates-api/).**
+**Give your AI assistant the official exchange rates that compliance, tax, and accounting actually require. A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client fetch published central-bank and tax-authority rates from 121 central banks and 3 tax authorities — ECB, Fed, Bank of Japan, HMRC, US Treasury, and more — via the [AllRatesToday API](https://allratestoday.com/central-bank-rates-api/).**
 
 After installation, your assistant can answer questions like:
 
@@ -41,6 +43,7 @@ Install it with no configuration at all and it starts, connects, and answers:
 | `get_official_rate_history` | 🔑 | Same. |
 | `compare_official_rates` | 🔑 | Same. |
 | `get_publication_calendar` | 🔑 | Same. |
+| `request_trial_key` | ✅ | Self-issues a 100-call, 7-day key with no account and adopts it for the session. |
 
 The keyless path reads the open, edge-cached `/api/open/central-bank/{bank}`
 endpoint — free to use with a visible attribution link back to allratestoday.com
@@ -146,6 +149,7 @@ Edit `claude_desktop_config.json` (Settings → Developer → Edit Config) and a
 | `get_official_rate_history` | Date-by-date official series for one pair | Paid, billed ~1 call per month covered |
 | `compare_official_rates` | One pair across every bank, with spread stats | Free (key required) |
 | `get_publication_calendar` | Dates a bank actually published (no values) | Free (key required) |
+| `request_trial_key` | Self-issue a 100-call, 7-day trial key (no account) and use it for the rest of the session | Keyless, 3 per IP per day |
 
 ## 🔒 Privacy
 

package/dist/client.d.ts

@@ -23,12 +23,23 @@ export interface CbRate {
     value: number;
 }
 export declare class CentralBankClient {
-    private readonly apiKey?;
+    private apiKey?;
     private readonly baseUrl;
     private readonly fetchImpl;
     constructor(options?: ClientOptions);
     /** True when no API key is configured: only the open endpoints are reachable. */
     get keyless(): boolean;
+    /** Adopt a key at runtime (used after request_trial_key) so the rest of the session is keyed. */
+    setApiKey(key: string | undefined): void;
+    /**
+     * Self-issue a trial key (100 calls, 7 days, no account) and adopt it for the
+     * rest of this process. POST with a JSON body: the site rejects bodiless
+     * POSTs as cross-site form submissions.
+     */
+    requestTrialKey(params?: {
+        agent?: string;
+        purpose?: string;
+    }): Promise<any>;
     private request;
     /**
      * GET against the keyless, CORS-open, edge-cached /api/open/* surface.

package/dist/client.js

@@ -56,6 +56,48 @@ export class CentralBankClient {
     get keyless() {
         return !this.apiKey;
     }
+    /** Adopt a key at runtime (used after request_trial_key) so the rest of the session is keyed. */
+    setApiKey(key) {
+        this.apiKey = key || undefined;
+    }
+    /**
+     * Self-issue a trial key (100 calls, 7 days, no account) and adopt it for the
+     * rest of this process. POST with a JSON body: the site rejects bodiless
+     * POSTs as cross-site form submissions.
+     */
+    async requestTrialKey(params = {}) {
+        const res = await this.fetchImpl(`${this.baseUrl}/agent/keys`, {
+            method: 'POST',
+            headers: {
+                'Accept': 'application/json',
+                'Content-Type': 'application/json',
+                'User-Agent': `central-bank-mcp/${VERSION}`,
+            },
+            body: JSON.stringify({ agent: params.agent, purpose: params.purpose }),
+        });
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : null;
+        }
+        catch {
+            body = text;
+        }
+        if (!res.ok) {
+            const upstream = body && typeof body === 'object' && typeof body.error === 'string' ? body.error : undefined;
+            throw new CentralBankApiError(upstream ?? `HTTP ${res.status}`, res.status, body);
+        }
+        const key = body && typeof body === 'object' && typeof body.key === 'string' ? body.key : undefined;
+        if (key)
+            this.setApiKey(key);
+        return {
+            ...(body ?? {}),
+            adopted: Boolean(key),
+            note: 'This server now uses the trial key for the rest of this session. To keep it after a restart, ' +
+                'put it in the MCP config: "env": { "ALLRATES_API_KEY": "<key>" }. For a lasting key register free ' +
+                'at https://allratestoday.com/register (300 calls) or see https://allratestoday.com/pricing.',
+        };
+    }
     async request(path, query = {}) {
         const url = new URL(this.baseUrl + path);
         for (const [key, value] of Object.entries(query)) {

package/dist/index.js

@@ -47,6 +47,7 @@ async function main() {
             '  Available now, no key needed:',
             '    • list_central_banks       — every covered source',
             '    • get_official_rates       — the latest published table (any source)',
+            '    • request_trial_key        — self-issue a 100-call, 7-day key without an account',
             '',
             '  Needs a free API key (historical dates, time series, cross-bank compare,',
             '  publication calendars):',
@@ -166,6 +167,29 @@ async function main() {
             return fail(err);
         }
     });
+    server.registerTool('request_trial_key', {
+        title: 'Request a trial API key',
+        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 a dated central-bank table, a history series, a cross-bank comparison or a publication calendar 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.',
+        inputSchema: {
+            agent: z.string().max(80).optional().describe('Optional: the agent or product requesting the key.'),
+            purpose: z.string().max(200).optional().describe('Optional: one line on what the rates are for.'),
+        },
+        outputSchema: {
+            key: z.string().optional(),
+            calls: z.number().optional(),
+            expires_at: z.string().optional(),
+            adopted: z.boolean().describe('True when this server switched to the new key'),
+            note: z.string(),
+        },
+        annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true },
+    }, async ({ agent, purpose }) => {
+        try {
+            return ok(await client.requestTrialKey({ agent, purpose }));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@allratestoday/central-bank-mcp",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "mcpName": "com.allratestoday/central-bank-mcp",
-  "description": "MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 60+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.",
+  "description": "MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 120+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.",
   "keywords": [
     "mcp",
     "model-context-protocol",
@@ -43,7 +43,7 @@
     "dev": "tsc --watch"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {