@allratestoday/mcp-server 0.1.1 → 0.3.0

package/README.md

@@ -1,5 +1,7 @@
 # AllRatesToday MCP Server
 
+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 financial news 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,31 +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` | no | 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. |
-| `get_financial_news` | no | Latest financial news from major sources. |
+All four tools require an `ALLRATES_API_KEY`.
 
-Public endpoints work without a key — set `ALLRATES_API_KEY` only if you want higher limits or to use the authenticated endpoint.
+| 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.d.ts

@@ -48,16 +48,4 @@ export declare class AllRatesTodayClient {
         }[];
         count: number;
     }>;
-    getNews(): Promise<{
-        status: string;
-        totalResults: number;
-        articles: {
-            title: string;
-            description?: string;
-            url: string;
-            image?: string;
-            publishedAt?: string;
-            source?: string;
-        }[];
-    }>;
 }

package/dist/client.js

@@ -1,5 +1,5 @@
 const DEFAULT_BASE_URL = 'https://allratestoday.com/api';
-const USER_AGENT = `allratestoday-mcp/0.1.0`;
+const USER_AGENT = `allratestoday-mcp/0.3.0`;
 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;
@@ -62,12 +57,9 @@ export class AllRatesTodayClient {
         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', {});
     }
-    getNews() {
-        return this.request('/news', {});
-    }
 }

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,
@@ -25,7 +25,7 @@ const tools = [
     },
     {
         name: 'get_historical_rates',
-        description: 'Get historical exchange-rate data points for a currency pair over a period. Periods: 1d (hourly), 7d (daily), 30d (daily), 1y (weekly). No API key required.',
+        description: 'Get historical exchange-rate data points for a currency pair over a period. Periods: 1d (hourly), 7d (daily), 30d (daily), 1y (weekly). Requires an AllRatesToday API key (ALLRATES_API_KEY).',
         inputSchema: {
             type: 'object',
             additionalProperties: false,
@@ -70,12 +70,7 @@ const tools = [
     },
     {
         name: 'list_currencies',
-        description: 'List all supported currencies with code, name, and symbol. No API key required. Cached 24h upstream.',
-        inputSchema: { type: 'object', additionalProperties: false, properties: {} },
-    },
-    {
-        name: 'get_financial_news',
-        description: 'Get the latest financial and currency-market news from Bloomberg, Investing.com, and Google News. No API key required.',
+        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: {} },
     },
 ];
@@ -84,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.1.0' }, { capabilities: { tools: {} } });
+    const server = new Server({ name: 'allratestoday-mcp', version: '0.3.0' }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const { name, arguments: args = {} } = req.params;
@@ -108,9 +122,6 @@ async function main() {
                 case 'list_currencies': {
                     return text(await client.listSymbols());
                 }
-                case 'get_financial_news': {
-                    return text(await client.getNews());
-                }
                 default:
                     return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
             }

package/package.json

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