@allratestoday/mcp-server 0.3.3 → 0.4.0

package/README.md

@@ -1,4 +1,6 @@
-# Realtime Exchange Rate MCP Server
+# AllRatesToday MCP Server
+
+[![Powered by AllRatesToday](https://img.shields.io/badge/Powered%20by-AllRatesToday-orange.svg)](https://allratestoday.com)
 
 [![npm version](https://img.shields.io/npm/v/@allratestoday/mcp-server.svg?style=flat-square)](https://www.npmjs.com/package/@allratestoday/mcp-server)
 [![npm downloads](https://img.shields.io/npm/dm/@allratestoday/mcp-server.svg?style=flat-square)](https://www.npmjs.com/package/@allratestoday/mcp-server)
@@ -9,7 +11,7 @@ English | [简体中文](./README-zh-CN.md)
 
 > Give your AI coding assistant a live window into the foreign-exchange market.
 
-A Model Context Protocol server that lets **Claude Code**, **Cursor**, **Claude Desktop**, **Windsurf**, and any other MCP-compatible client fetch real-time currency rates, historical data, and multi-currency lookups.
+A Model Context Protocol server that lets **Claude Code**, **Cursor**, **Claude Desktop**, **Windsurf**, and any other MCP-compatible client fetch real-time currency rates, historical data, and multi-currency lookups from the [AllRatesToday API](https://allratestoday.com).
 
 After installation, your assistant can answer questions like:
 
@@ -35,6 +37,7 @@ After installation, your assistant can answer questions like:
 - [Verify it works](#verify-it-works)
 - [Tools reference](#tools-reference)
 - [Environment variables](#environment-variables)
+- [Plans and limits](#plans-and-limits)
 - [Troubleshooting](#troubleshooting)
 - [Error reference](#error-reference)
 - [FAQ](#faq)
@@ -51,6 +54,7 @@ After installation, your assistant can answer questions like:
 |---|---|
 | **Currencies** | 150+ ISO 4217 codes, all major and most exotics |
 | **Update frequency** | Mid-market rates refresh every ~60 seconds |
+| **Data source** | Tier-1 financial data providers (Reuters / Refinitiv-class) |
 | **Historical depth** | Up to 1 year via `1d` / `7d` / `30d` / `1y` granularity |
 | **Tools exposed** | 4 — `get_exchange_rate`, `get_historical_rates`, `get_rates_authenticated`, `list_currencies` |
 | **Transport** | stdio (subprocess), MCP 1.x compatible |
@@ -60,14 +64,14 @@ After installation, your assistant can answer questions like:
 
 ## Get an API key (required)
 
-The server **will not start** without a valid `ALLRATES_API_KEY`. Rates are served by [AllRatesToday](https://allratestoday.com); a free key is enough for development and personal use.
+The server **will not start** without a valid `ALLRATES_API_KEY`. A free key is enough for development and personal use — **no credit card required**.
 
-1. Register at [allratestoday.com/register](https://allratestoday.com/register)
+1. Register at [allratestoday.com/register](https://allratestoday.com/register) — 30 seconds
 2. Verify your email
 3. Copy your key from the dashboard (format: `art_live_xxxxx`)
 4. Use it as `ALLRATES_API_KEY` in the configs below
 
-If the key is missing, the server prints clear registration instructions on stderr and exits with code 1.
+If you forget, the server prints clear registration instructions on stderr and exits with code 1.
 
 ---
 
@@ -203,7 +207,7 @@ After configuring your client, test in this order:
 
 ## Tools reference
 
-All four tools require an API key.
+All four tools require `ALLRATES_API_KEY`.
 
 ### `get_exchange_rate`
 
@@ -332,13 +336,19 @@ You set these in your MCP client's config (in the `env` block) — not in your s
 
 ---
 
+## Plans
+
+A free tier and paid plans are available. See [allratestoday.com/pricing](https://allratestoday.com/pricing) for current quotas. All plans include the same currency coverage and historical depth — only the request quotas differ.
+
+---
+
 ## Troubleshooting
 
 | Symptom | Likely cause | Fix |
 |---|---|---|
 | Client shows "MCP server failed to start" or red dot | `ALLRATES_API_KEY` not set or invalid | Verify the key in your client config; check it matches the dashboard |
-| Tools show but every call returns "Invalid API key" | Key is malformed (missing prefix, truncated, or revoked) | Copy a fresh key from the dashboard |
-| Tools return "API quota exceeded" | Plan request limit hit | Wait until next month or upgrade plan |
+| Tools show but every call returns "Invalid AllRatesToday API key" | Key is malformed (missing prefix, truncated, or revoked) | Copy a fresh key from the dashboard |
+| Tools return "AllRatesToday API quota exceeded" | Free-tier monthly limit hit | Wait until next month or upgrade plan |
 | Historical tool returns "Bad request" | Invalid period or unknown currency code | Period must be `1d`/`7d`/`30d`/`1y`; codes must be 3 letters |
 | Server starts but tools never appear in client | Client didn't reload after config change | Fully quit (not just close) and reopen the client |
 | `npx` runs but hangs forever | The server is waiting for an MCP client to connect — this is normal when run from a shell | Don't run from a shell; let your MCP client launch it |
@@ -363,9 +373,9 @@ The server maps API errors to clear, actionable messages.
 |---|---|---|
 | 200 | Success | (rate returned) |
 | 400 | Bad request — usually unknown currency code | `Bad request — possibly an unknown currency code` |
-| 401 | Invalid or missing API key | `Invalid API key` |
-| 429 | Quota exceeded | `API quota exceeded` |
-| 5xx | Upstream server-side issue | `HTTP 5xx — <upstream message>` |
+| 401 | Invalid or missing API key | `Invalid AllRatesToday API key` |
+| 429 | Quota exceeded | `AllRatesToday API quota exceeded` |
+| 5xx | Server-side issue at allratestoday.com | `HTTP 5xx — <upstream message>` |
 
 The LLM will surface these messages in its response, so a user prompt that hits a 429 results in the assistant saying *"the API quota has been exceeded — please try again next month or upgrade your plan."*
 
@@ -373,20 +383,23 @@ The LLM will surface these messages in its response, so a user prompt that hits
 
 ## FAQ
 
+**Is the free plan really enough for normal use?**
+Yes for personal/dev use. The free tier covers a few daily questions. Heavy interactive use, multiple chat sessions per day, or running the server in production should consider the paid tiers.
+
 **Do you store my conversation or query data?**
-No. Only your API key and the request parameters (source, target, period, time) are sent to the upstream API — never the LLM's conversation context, sheet contents, or anything else.
+No. Only your API key and the request parameters (source, target, period, time) are sent to allratestoday.com — never the LLM's conversation context, sheet contents, or anything else.
 
 **What happens to my API key?**
-It's only sent as a `Bearer` token in the `Authorization` header on requests to the upstream API. It's never logged or transmitted elsewhere.
+It's only sent as a `Bearer` token in the `Authorization` header on requests to the AllRatesToday API. It's never logged or transmitted elsewhere.
 
 **Why is my historical request slow on first call?**
-Cold-start of `npx` (first run downloads the package) plus an initial upstream cache miss. Subsequent calls are fast (<200ms typically).
+Cold-start of `npx` (first run downloads the package) plus the initial AllRatesToday cache miss. Subsequent calls are fast (<200ms typically).
 
 **Can I run this without npm/Node?**
 Not currently — Node ≥18 is required. We've considered a standalone binary; if that matters to you, open an issue.
 
 **Is there a self-hosted option?**
-Yes, set `ALLRATES_BASE_URL` to point to your own instance.
+Yes, set `ALLRATES_BASE_URL` to your own AllRatesToday instance. Contact support@allratestoday.com for self-hosted licensing.
 
 **Does this work with ChatGPT?**
 The Anthropic MCP standard works with any MCP-compatible client. ChatGPT Desktop has experimental MCP support; check OpenAI's docs for current status.
@@ -396,8 +409,8 @@ The Anthropic MCP standard works with any MCP-compatible client. ChatGPT Desktop
 ## Development
 
 ```bash
-git clone https://github.com/cahthuranag/realtime-exchange-rate-mcp.git
-cd realtime-exchange-rate-mcp
+git clone https://github.com/cahthuranag/mcp-server.git
+cd mcp-server
 npm install
 npm run build
 ALLRATES_API_KEY=art_live_xxxxx node dist/index.js
@@ -411,7 +424,7 @@ To watch and rebuild on changes during development:
 npm run dev
 ```
 
-To test against a local instance:
+To test against a local AllRatesToday instance:
 
 ```bash
 ALLRATES_BASE_URL=http://localhost:8080/api ALLRATES_API_KEY=test_key node dist/index.js
@@ -422,7 +435,7 @@ ALLRATES_BASE_URL=http://localhost:8080/api ALLRATES_API_KEY=test_key node dist/
 ```
 src/
 ├── index.ts      # MCP server, tool registration, request handlers
-└── client.ts     # HTTP client + error mapping
+└── client.ts     # HTTP client for AllRatesToday API + error mapping
 dist/             # Compiled JS (gitignored)
 server.json       # MCP registry manifest
 package.json      # npm metadata, dependencies, scripts
@@ -430,10 +443,10 @@ package.json      # npm metadata, dependencies, scripts
 
 ### Contributing
 
-Issues and PRs welcome at [github.com/cahthuranag/realtime-exchange-rate-mcp](https://github.com/cahthuranag/realtime-exchange-rate-mcp). Before opening a PR:
+Issues and PRs welcome at [github.com/cahthuranag/mcp-server](https://github.com/cahthuranag/mcp-server). Before opening a PR:
 
 1. `npm run build` should succeed with no errors
-2. Test against a real API key (set in `ALLRATES_API_KEY`)
+2. Test against a real AllRatesToday API key (set in `ALLRATES_API_KEY`)
 3. Update tool descriptions in `src/index.ts` if you change tool behavior
 4. Update this README's "Tools reference" section if you add or rename a tool
 
@@ -441,7 +454,7 @@ Issues and PRs welcome at [github.com/cahthuranag/realtime-exchange-rate-mcp](ht
 
 ## Changelog
 
-See [GitHub Releases](https://github.com/cahthuranag/realtime-exchange-rate-mcp/releases) for the full list. Recent highlights:
+See [GitHub Releases](https://github.com/cahthuranag/mcp-server/releases) for the full list. Recent highlights:
 
 - **0.3.x** — API key required for all tools; fail-fast at startup with clear error
 - **0.2.x** — Removed news tool, required auth on `get_historical_rates`
@@ -451,8 +464,10 @@ See [GitHub Releases](https://github.com/cahthuranag/realtime-exchange-rate-mcp/
 
 ## Support
 
-- **Bug reports**: [github.com/cahthuranag/realtime-exchange-rate-mcp/issues](https://github.com/cahthuranag/realtime-exchange-rate-mcp/issues)
+- **API issues**: [support@allratestoday.com](mailto:support@allratestoday.com)
+- **Bug reports**: [github.com/cahthuranag/mcp-server/issues](https://github.com/cahthuranag/mcp-server/issues)
 - **MCP questions**: [modelcontextprotocol.io](https://modelcontextprotocol.io) — protocol docs
+- **Status / uptime**: [allratestoday.com](https://allratestoday.com) (status page in development)
 
 ---
 

package/dist/client.js

@@ -1,5 +1,5 @@
+import { VERSION } from './version.js';
 const DEFAULT_BASE_URL = 'https://allratestoday.com/api';
-const USER_AGENT = `allratestoday-mcp/0.3.1`;
 export class AllRatesTodayError extends Error {
     status;
     body;
@@ -10,6 +10,18 @@ export class AllRatesTodayError extends Error {
         this.name = 'AllRatesTodayError';
     }
 }
+function errorMessage(status, upstream) {
+    switch (status) {
+        case 400:
+            return upstream ?? 'Bad request — possibly an unknown currency code';
+        case 401:
+            return 'Invalid AllRatesToday API key';
+        case 429:
+            return 'AllRatesToday API quota exceeded';
+        default:
+            return upstream ? `HTTP ${status} — ${upstream}` : `HTTP ${status}`;
+    }
+}
 export class AllRatesTodayClient {
     apiKey;
     baseUrl;
@@ -25,14 +37,14 @@ export class AllRatesTodayClient {
             if (value !== undefined && value !== '')
                 url.searchParams.set(key, value);
         }
+        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.');
+        }
         const headers = {
             'Accept': 'application/json',
-            'User-Agent': USER_AGENT,
+            'User-Agent': `allratestoday-mcp/${VERSION}`,
+            'Authorization': `Bearer ${this.apiKey}`,
         };
-        if (!this.apiKey) {
-            throw new AllRatesTodayError('API key is required. Get one at https://allratestoday.com/register, 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;
@@ -43,10 +55,10 @@ export class AllRatesTodayClient {
             body = text;
         }
         if (!res.ok) {
-            const msg = (body && typeof body === 'object' && 'error' in body && typeof body.error === 'string'
+            const upstream = body && typeof body === 'object' && 'error' in body && typeof body.error === 'string'
                 ? body.error
-                : `HTTP ${res.status}`);
-            throw new AllRatesTodayError(msg, res.status, body);
+                : undefined;
+            throw new AllRatesTodayError(errorMessage(res.status, upstream), res.status, body);
         }
         return body;
     }

package/dist/index.js

@@ -1,91 +1,41 @@
 #!/usr/bin/env node
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
 import { AllRatesTodayClient, AllRatesTodayError } from './client.js';
-const CCY = {
-    type: 'string',
-    description: 'ISO 4217 currency code (e.g. USD, EUR, GBP).',
-    minLength: 3,
-    maxLength: 3,
-};
-const tools = [
-    {
-        name: 'get_exchange_rate',
-        description: 'Get the current mid-market exchange rate between two currencies. Returns a single rate number. Requires API key (ALLRATES_API_KEY).',
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                source: CCY,
-                target: CCY,
-            },
-            required: ['source', 'target'],
-        },
-    },
-    {
-        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). Requires API key (ALLRATES_API_KEY).',
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                source: CCY,
-                target: CCY,
-                period: {
-                    type: 'string',
-                    enum: ['1d', '7d', '30d', '1y'],
-                    default: '7d',
-                    description: 'Time period to fetch history for.',
-                },
-            },
-            required: ['source', 'target'],
-        },
-    },
-    {
-        name: 'get_rates_authenticated',
-        description: 'Get rates with higher limits and multi-target support. Requires API key (ALLRATES_API_KEY). Supports comma-separated targets like "EUR,GBP,JPY".',
-        inputSchema: {
-            type: 'object',
-            additionalProperties: false,
-            properties: {
-                source: CCY,
-                target: {
-                    type: 'string',
-                    description: 'One or more target codes, comma-separated.',
-                },
-                time: {
-                    type: 'string',
-                    format: 'date-time',
-                    description: 'Optional historical ISO 8601 timestamp.',
-                },
-                group: {
-                    type: 'string',
-                    enum: ['hour', 'day', 'week', 'month'],
-                    description: 'Optional grouping window.',
-                },
-            },
-            required: ['source', 'target'],
-        },
-    },
-    {
-        name: 'list_currencies',
-        description: 'List all supported currencies with code, name, and symbol. Requires API key (ALLRATES_API_KEY). Cached 24h upstream.',
-        inputSchema: { type: 'object', additionalProperties: false, properties: {} },
-    },
-];
-function text(s) {
-    const out = typeof s === 'string' ? s : JSON.stringify(s, null, 2);
-    return { content: [{ type: 'text', text: out }] };
+import { VERSION } from './version.js';
+const CCY_DESC = "ISO 4217 currency code, 3 letters, case-insensitive (e.g. 'USD', 'EUR', 'GBP', 'JPY'). For a source/target pair, the returned rate is how much 1 unit of source is worth in target. Fiat only — no crypto, no commodities. Call list_currencies if unsure whether a code is supported.";
+const ccy = z
+    .string()
+    .regex(/^[A-Za-z]{3}$/, 'must be a 3-letter ISO 4217 currency code')
+    .describe(CCY_DESC);
+const ccyList = z
+    .string()
+    .regex(/^[A-Za-z]{3}(,[A-Za-z]{3})*$/, 'must be one or more 3-letter ISO 4217 codes, comma-separated, no spaces')
+    .describe("One or more ISO 4217 codes, comma-separated, no spaces, case-insensitive. Examples: 'EUR' (single) or 'EUR,GBP,JPY' (multi). Each target becomes a separate row in the response.");
+const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
+function ok(structured) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(structured, null, 2) }],
+        structuredContent: structured,
+    };
+}
+function fail(err) {
+    const message = err instanceof AllRatesTodayError
+        ? `AllRatesToday error${err.status ? ` (${err.status})` : ''}: ${err.message}`
+        : err instanceof Error
+            ? err.message
+            : String(err);
+    return { content: [{ type: 'text', text: message }], isError: true };
 }
 async function main() {
     const apiKey = process.env.ALLRATES_API_KEY;
     if (!apiKey) {
         console.error([
             '',
-            '  This MCP server requires an API key.',
+            '  AllRatesToday MCP server requires an API key.',
             '',
-            '  1. Get a free key at https://allratestoday.com/register',
+            '  1. Sign up free at https://allratestoday.com/register (free tier — no card required)',
             '  2. Copy your API key from the dashboard',
             '  3. Set ALLRATES_API_KEY in your MCP client config:',
             '',
@@ -102,45 +52,119 @@ async function main() {
         apiKey,
         baseUrl: process.env.ALLRATES_BASE_URL,
     });
-    const server = new Server({ name: 'realtime-exchange-rate-mcp', version: '0.3.2' }, { capabilities: { tools: {} } });
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
-    server.setRequestHandler(CallToolRequestSchema, async (req) => {
-        const { name, arguments: args = {} } = req.params;
+    const server = new McpServer({ name: 'allratestoday-mcp', version: VERSION });
+    server.registerTool('get_exchange_rate', {
+        title: 'Get live exchange rate',
+        description: "Use this when the user asks 'what is X in Y?', 'convert X to Y', 'current rate of EUR/USD', or any single fiat-to-fiat live exchange rate question. Returns the latest mid-market rate as a JSON object like { rate: 0.9234, source } meaning 1 source = 0.9234 target. Does NOT support cryptocurrencies, commodities, or arithmetic on amounts. For multiple targets in one call use get_rates_authenticated; for a past date or fixed lookback (7d/30d/1y) use get_historical_rates.",
+        inputSchema: { source: ccy, target: ccy },
+        outputSchema: {
+            rate: z.number().describe('How much 1 unit of source is worth in target'),
+            source: z.string().describe('Upstream data provider the rate came from'),
+        },
+        annotations: READ_ONLY,
+    }, async ({ source, target }) => {
+        try {
+            return ok(await client.getRate(source.toUpperCase(), target.toUpperCase()));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool('get_historical_rates', {
+        title: 'Get historical rate time-series',
+        description: "Use this for fixed-window time-series questions like 'how has EUR/USD moved this week', 'show me the last month of GBP/JPY', or 'chart 1-year history of AUD/USD'. Returns { source, target, period, data: [{ date, rate, timestamp }, ...] } — sampling is fixed per period (1d=hourly, 7d/30d=daily, 1y=weekly) and the window always ends NOW. For a specific past datetime use get_rates_authenticated with `time`. For a single live rate use get_exchange_rate.",
+        inputSchema: {
+            source: ccy,
+            target: ccy,
+            period: z
+                .enum(['1d', '7d', '30d', '1y'])
+                .default('7d')
+                .describe("Lookback window ending NOW. '1d' returns ~24 hourly points, '7d' returns 7 daily points, '30d' returns 30 daily points, '1y' returns ~52 weekly points. Defaults to '7d' if omitted."),
+        },
+        outputSchema: {
+            source: z.string(),
+            target: z.string(),
+            period: z.string(),
+            source_api: z.string().optional().describe('Upstream data provider'),
+            data: z.array(z.object({
+                date: z.string(),
+                rate: z.number(),
+                timestamp: z.number(),
+            })),
+        },
+        annotations: READ_ONLY,
+    }, async ({ source, target, period }) => {
+        try {
+            return ok(await client.getHistoricalRates(source.toUpperCase(), target.toUpperCase(), period));
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool('get_rates_authenticated', {
+        title: 'Get multi-target or point-in-time rates',
+        description: "Use this for (a) one source against multiple targets in a single call ('USD vs EUR, GBP, JPY'), or (b) the rate at a specific past datetime ('EUR/USD at 2025-03-14T12:00Z'), optionally bucketed by hour/day/week/month. Returns { rates: [{ rate, source, target, time }, ...] } — one row per target × time bucket. For a single live pair use get_exchange_rate. For fixed lookback windows (1d/7d/30d/1y ending now) use get_historical_rates.",
+        inputSchema: {
+            source: ccy,
+            target: ccyList,
+            time: z
+                .string()
+                .datetime({ offset: true })
+                .optional()
+                .describe("Single point-in-time ISO 8601 UTC timestamp (e.g. '2025-03-14T12:00:00Z'). Omit for the latest rate."),
+            group: z
+                .enum(['hour', 'day', 'week', 'month'])
+                .optional()
+                .describe("Aggregation bucket: 'hour', 'day', 'week', or 'month'. Useful when time is omitted to return rolling averages. Omit for raw single-point output."),
+        },
+        outputSchema: {
+            rates: z.array(z.object({
+                rate: z.number(),
+                source: z.string(),
+                target: z.string(),
+                time: z.string(),
+            })),
+        },
+        annotations: READ_ONLY,
+    }, async ({ source, target, time, group }) => {
+        try {
+            const rates = await client.getAuthenticatedRates({
+                source: source.toUpperCase(),
+                target: target.toUpperCase(),
+                time,
+                group,
+            });
+            return ok({ rates });
+        }
+        catch (err) {
+            return fail(err);
+        }
+    });
+    server.registerTool('list_currencies', {
+        title: 'List supported currencies',
+        description: "Call this BEFORE other tools when you are unsure whether a currency code is supported, or when the user asks 'what currencies do you support?', 'is X a valid currency?', or 'what is the symbol for X?'. Returns { currencies: [{ code: 'USD', name: 'US Dollar', symbol: '$' }, ...], count } covering 150+ ISO 4217 fiat currencies. Does NOT include cryptocurrencies. Cheap to call (cached 24h upstream) — use it to validate user input and prevent downstream errors in get_exchange_rate / get_rates_authenticated / get_historical_rates.",
+        inputSchema: {},
+        outputSchema: {
+            currencies: z.array(z.object({
+                code: z.string(),
+                name: z.string(),
+                symbol: z.string(),
+            })),
+            count: z.number(),
+        },
+        annotations: READ_ONLY,
+    }, async () => {
         try {
-            switch (name) {
-                case 'get_exchange_rate': {
-                    const { source, target } = args;
-                    return text(await client.getRate(source, target));
-                }
-                case 'get_historical_rates': {
-                    const { source, target, period = '7d' } = args;
-                    return text(await client.getHistoricalRates(source, target, period));
-                }
-                case 'get_rates_authenticated': {
-                    return text(await client.getAuthenticatedRates(args));
-                }
-                case 'list_currencies': {
-                    return text(await client.listSymbols());
-                }
-                default:
-                    return { content: [{ type: 'text', text: `Unknown tool: ${name}` }], isError: true };
-            }
+            return ok(await client.listSymbols());
         }
         catch (err) {
-            const message = err instanceof AllRatesTodayError
-                ? `AllRatesToday error${err.status ? ` (${err.status})` : ''}: ${err.message}`
-                : err instanceof Error
-                    ? err.message
-                    : String(err);
-            return { content: [{ type: 'text', text: message }], isError: true };
+            return fail(err);
         }
     });
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    // Keep process alive; stdio transport handles shutdown.
 }
 main().catch((err) => {
-    // eslint-disable-next-line no-console
     console.error('Fatal:', err);
     process.exit(1);
 });

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,3 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export const VERSION = require('../package.json').version;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@allratestoday/mcp-server",
-  "version": "0.3.3",
-  "mcpName": "io.github.cahthuranag/realtime-exchange-rate-mcp",
-  "description": "MCP server that lets AI coding tools (Claude Code, Cursor, Claude Desktop) fetch real-time and historical currency exchange rates.",
+  "version": "0.4.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": [
     "mcp",
     "model-context-protocol",
@@ -10,15 +10,16 @@
     "cursor",
     "currency",
     "exchange-rate",
-    "forex"
+    "forex",
+    "allratestoday"
   ],
   "license": "MIT",
-  "homepage": "https://github.com/cahthuranag/realtime-exchange-rate-mcp",
+  "homepage": "https://allratestoday.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/cahthuranag/realtime-exchange-rate-mcp.git"
+    "url": "git+https://github.com/cahthuranag/mcp-server.git"
   },
-  "bugs": "https://github.com/cahthuranag/realtime-exchange-rate-mcp/issues",
+  "bugs": "https://github.com/cahthuranag/mcp-server/issues",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -34,12 +35,13 @@
   },
   "scripts": {
     "build": "tsc",
+    "test": "node --test test/*.test.mjs",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "dev": "tsc --watch"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.4",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.23.8"
   },
   "devDependencies": {