@allratestoday/mcp-server 0.5.0 → 0.5.2
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 +16 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@ After installation, your assistant can answer questions like:
|
|
|
19
19
|
|
|
20
20
|
## 🚀 Why this server?
|
|
21
21
|
|
|
22
|
-
- 📡 **Live mid-market rates** — 150+ ISO 4217 currencies, refreshed every ~60 seconds
|
|
22
|
+
- 📡 **Live mid-market rates** — 150+ ISO 4217 currencies, refreshed every ~60 seconds
|
|
23
23
|
- 📈 **Historical series built in** — `1d` / `7d` / `30d` / `1y` windows with sensible granularity per period
|
|
24
24
|
- 🧰 **Four focused tools** — `get_exchange_rate`, `get_historical_rates`, `get_rates_authenticated`, `list_currencies`; small surface, easy for the model to use correctly
|
|
25
25
|
- 🔌 **Works everywhere MCP does** — stdio transport, MCP 1.x; Claude Code, Cursor, Claude Desktop, Windsurf, or any generic host
|
|
@@ -29,7 +29,7 @@ After installation, your assistant can answer questions like:
|
|
|
29
29
|
|
|
30
30
|
## ⚖️ Mid-market vs official central-bank rates
|
|
31
31
|
|
|
32
|
-
Everything this server returns is a **mid-market rate
|
|
32
|
+
Everything this server returns is a **mid-market rate**, refreshed every ~60 seconds — the right number for price display, conversion, and anything that should track the market. It is *not* the official rate a tax authority or auditor may require. For those, AllRatesToday also serves **published central-bank and tax-authority rates** (100+ sources — ECB, Fed, HMRC, US Treasury, …) that are fixed once published and carry the institution's own publication date — via the [central bank REST API](https://allratestoday.com/docs/#central-bank) and [per-bank npm SDKs](https://allratestoday.com/central-bank-rates-api/). The two can diverge by several percent, so pick by use case, not convenience.
|
|
33
33
|
|
|
34
34
|
## 🔓 Keyless mode — what works with no setup
|
|
35
35
|
|
|
@@ -74,6 +74,20 @@ commands (`/rate`, `/convert`, `/official-rate`, `/fx-history`,
|
|
|
74
74
|
|
|
75
75
|
Everything below still applies for other MCP clients.
|
|
76
76
|
|
|
77
|
+
## ☁️ Hosted endpoint — nothing to install
|
|
78
|
+
|
|
79
|
+
The same tools also run as a hosted **Streamable HTTP** MCP server (together with the tools of the sibling AllRatesToday server, nine in total). Paste the URL into any client that supports remote MCP — Claude.ai and Claude Desktop connectors, ChatGPT, Cursor, VS Code, Codex, Gemini CLI:
|
|
80
|
+
|
|
81
|
+
```
|
|
82
|
+
https://allratestoday.com/api/mcp
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
```bash
|
|
86
|
+
claude mcp add --transport http allratestoday https://allratestoday.com/api/mcp
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
Works keyless. With a key, send `Authorization: Bearer art_live_…` or, where the client only takes a URL, connect to `https://allratestoday.com/api/mcp?api_key=art_live_…`. Registry name: `com.allratestoday/mcp`. One-click Cursor / VS Code buttons: https://allratestoday.com/mcp/#hosted
|
|
90
|
+
|
|
77
91
|
## 📦 Installation
|
|
78
92
|
|
|
79
93
|
The simplest install is **zero-install via `npx`**, which is what every config below uses:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@allratestoday/mcp-server",
|
|
3
|
-
"version": "0.5.
|
|
3
|
+
"version": "0.5.2",
|
|
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": [
|