@allratestoday/mcp-server 0.2.0 → 0.3.1

package/README.md

@@ -1,6 +1,8 @@
 # AllRatesToday MCP Server
 
-MCP server that gives AI coding tools — **Claude Code**, **Cursor**, **Claude Desktop**, and any other Model Context Protocol client — real-time currency exchange rates, historical data, and financial news from [AllRatesToday](https://allratestoday.com).
+English | [简体中文](./README-zh-CN.md)
+
+MCP server that gives AI coding tools — **Claude Code**, **Cursor**, **Claude Desktop**, and any other Model Context Protocol client — real-time currency exchange rates, historical data, and multi-currency lookups from [AllRatesToday](https://allratestoday.com).
 
 Ask your assistant things like:
 
@@ -9,6 +11,17 @@ Ask your assistant things like:
 - *"Convert 250 USD into CAD using a real rate."*
 - *"List every supported currency."*
 
+## Get an API key first (required)
+
+The MCP server needs an AllRatesToday API key to start. **The free plan is enough** — 300 requests/month, no card required.
+
+1. Register at [allratestoday.com/register](https://allratestoday.com/register) — takes 30 seconds
+2. Verify your email
+3. Copy your key from the dashboard — it looks like `art_live_xxxxx`
+4. Set it as `ALLRATES_API_KEY` in your MCP client config (examples below)
+
+The server will refuse to start without a key and print registration instructions in the console.
+
 ## Install
 
 ```bash
@@ -69,30 +82,26 @@ Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) o
 
 Restart the app after editing.
 
-## Get an API key
-
-1. Register at [allratestoday.com/register](https://allratestoday.com/register).
-2. Verify your email.
-3. Copy your key from the dashboard — it looks like `art_live_xxxxx`.
+## Plans
 
-The free plan includes 300 requests/month. Paid plans start at €4.99/mo.
+The free plan includes 300 requests/month. Paid plans start at €4.99/mo for higher limits and historical data going back years. See [allratestoday.com/pricing](https://allratestoday.com/pricing).
 
 ## Tools exposed
 
-| Tool | API key | Description |
-|---|---|---|
-| `get_exchange_rate` | no | Current mid-market rate between two currencies. |
-| `get_historical_rates` | yes | Historical data points over `1d`, `7d`, `30d`, or `1y`. |
-| `get_rates_authenticated` | yes | Multi-target rates and higher limits. |
-| `list_currencies` | no | All supported currencies with codes, names, symbols. |
+All four tools require an `ALLRATES_API_KEY`.
 
-Public tools (`get_exchange_rate`, `list_currencies`) work without a key. Set `ALLRATES_API_KEY` for the historical and multi-target endpoints.
+| Tool | Description |
+|---|---|
+| `get_exchange_rate` | Current mid-market rate between two currencies. |
+| `get_historical_rates` | Historical data points over `1d`, `7d`, `30d`, or `1y`. |
+| `get_rates_authenticated` | Multi-target rates and higher limits. |
+| `list_currencies` | All supported currencies with codes, names, symbols. |
 
 ## Environment variables
 
 | Variable | Default | Purpose |
 |---|---|---|
-| `ALLRATES_API_KEY` | *(unset)* | Your AllRatesToday API key. Required for `get_rates_authenticated`. |
+| `ALLRATES_API_KEY` | *(required)* | Your AllRatesToday API key. Server will not start without it. |
 | `ALLRATES_BASE_URL` | `https://allratestoday.com/api` | Override for self-hosted or staging environments. |
 
 ## Development

package/dist/client.js

@@ -1,5 +1,5 @@
 const DEFAULT_BASE_URL = 'https://allratestoday.com/api';
-const USER_AGENT = `allratestoday-mcp/0.2.0`;
+const USER_AGENT = `allratestoday-mcp/0.3.1`;
 export class AllRatesTodayError extends Error {
     status;
     body;
@@ -19,7 +19,7 @@ export class AllRatesTodayClient {
         this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, '');
         this.fetchImpl = options.fetchImpl ?? fetch;
     }
-    async request(path, query, requireAuth = false) {
+    async request(path, query) {
         const url = new URL(this.baseUrl + path);
         for (const [key, value] of Object.entries(query)) {
             if (value !== undefined && value !== '')
@@ -29,15 +29,10 @@ export class AllRatesTodayClient {
             'Accept': 'application/json',
             'User-Agent': USER_AGENT,
         };
-        if (requireAuth) {
-            if (!this.apiKey) {
-                throw new AllRatesTodayError('This endpoint requires an API key. Set ALLRATES_API_KEY or pass apiKey in the MCP config.');
-            }
-            headers['Authorization'] = `Bearer ${this.apiKey}`;
-        }
-        else if (this.apiKey) {
-            headers['Authorization'] = `Bearer ${this.apiKey}`;
+        if (!this.apiKey) {
+            throw new AllRatesTodayError('AllRatesToday API key is required. Sign up free at https://allratestoday.com/register to get a key, then set ALLRATES_API_KEY in your MCP config.');
         }
+        headers['Authorization'] = `Bearer ${this.apiKey}`;
         const res = await this.fetchImpl(url.toString(), { method: 'GET', headers });
         const text = await res.text();
         let body;
@@ -59,10 +54,10 @@ export class AllRatesTodayClient {
         return this.request('/rate', { source, target });
     }
     getHistoricalRates(source, target, period = '7d') {
-        return this.request('/historical-rates', { source, target, period }, true);
+        return this.request('/historical-rates', { source, target, period });
     }
     getAuthenticatedRates(params) {
-        return this.request('/v1/rates', params, true);
+        return this.request('/v1/rates', params);
     }
     listSymbols() {
         return this.request('/v1/symbols', {});

package/dist/index.js

@@ -12,7 +12,7 @@ const CCY = {
 const tools = [
     {
         name: 'get_exchange_rate',
-        description: 'Get the current mid-market exchange rate between two currencies. Returns a single rate number. No API key required.',
+        description: 'Get the current mid-market exchange rate between two currencies. Returns a single rate number. Requires a free AllRatesToday API key (ALLRATES_API_KEY) — sign up at https://allratestoday.com/register.',
         inputSchema: {
             type: 'object',
             additionalProperties: false,
@@ -70,7 +70,7 @@ const tools = [
     },
     {
         name: 'list_currencies',
-        description: 'List all supported currencies with code, name, and symbol. No API key required. Cached 24h upstream.',
+        description: 'List all supported currencies with code, name, and symbol. Requires a free AllRatesToday API key (ALLRATES_API_KEY) — sign up at https://allratestoday.com/register. Cached 24h upstream.',
         inputSchema: { type: 'object', additionalProperties: false, properties: {} },
     },
 ];
@@ -79,11 +79,30 @@ function text(s) {
     return { content: [{ type: 'text', text: out }] };
 }
 async function main() {
+    const apiKey = process.env.ALLRATES_API_KEY;
+    if (!apiKey) {
+        console.error([
+            '',
+            '  AllRatesToday MCP server requires an API key.',
+            '',
+            '  1. Sign up free at https://allratestoday.com/register (300 requests/month, no card required)',
+            '  2. Copy your API key from the dashboard',
+            '  3. Set ALLRATES_API_KEY in your MCP client config:',
+            '',
+            '     "allratestoday": {',
+            '       "command": "npx",',
+            '       "args": ["-y", "@allratestoday/mcp-server"],',
+            '       "env": { "ALLRATES_API_KEY": "art_live_..." }',
+            '     }',
+            '',
+        ].join('\n'));
+        process.exit(1);
+    }
     const client = new AllRatesTodayClient({
-        apiKey: process.env.ALLRATES_API_KEY,
+        apiKey,
         baseUrl: process.env.ALLRATES_BASE_URL,
     });
-    const server = new Server({ name: 'allratestoday-mcp', version: '0.2.0' }, { capabilities: { tools: {} } });
+    const server = new Server({ name: 'allratestoday-mcp', version: '0.3.1' }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const { name, arguments: args = {} } = req.params;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allratestoday/mcp-server",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "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": [