Exchange Rate API
Real-time & historical exchange rates for 160+ currencies, mid-market (Reuters/Refinitiv).
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@exchangerateapi/mcp-serverclaude mcp add exchange-rate-api -e 'EXCHANGE_RATE_API_KEY=<your exchange_rate_api_key>' -- npx -y @exchangerateapi/mcp-server@1.0.2
{
"mcpServers": {
"exchange-rate-api": {
"command": "npx",
"args": [
"-y",
"@exchangerateapi/mcp-server@1.0.2"
],
"env": {
"EXCHANGE_RATE_API_KEY": "<your exchange_rate_api_key>"
}
}
}
}
متغيرات البيئة
EXCHANGE_RATE_API_KEYإلزامي سري API key from exchange-rateapi.com (free tier available, no credit card required)
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
@exchangerateapi/mcp-server
Exchange Rate API is now **AllRatesToday.** This package keeps working against
exchange-rateapi.com, but it is no longer updated. For new projects use@allratestoday/mcp-server(or the hosted endpointhttps://allratestoday.com/api/mcp) — the same real-time API plus official rates from 121 central banks. Docs: allratestoday.com/docs.
MCP server that gives AI coding tools (Claude Code, Cursor, Claude Desktop, Windsurf) access to real-time and historical currency exchange rates from Exchange Rate API.
160+ currencies. Mid-market rates updated every 60 seconds, no retail spread.
Quick Setup
1. Get a Free API Key
Sign up at exchange-rateapi.com/register — free tier, no credit card.
2. Add to Your MCP Client
Claude Code (~/.claude/settings.json):
{
"mcpServers": {
"exchange-rateapi": {
"command": "npx",
"args": ["-y", "@exchangerateapi/mcp-server"],
"env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
}
}
}
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"exchange-rateapi": {
"command": "npx",
"args": ["-y", "@exchangerateapi/mcp-server"],
"env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
}
}
}
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"exchange-rateapi": {
"command": "npx",
"args": ["-y", "@exchangerateapi/mcp-server"],
"env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
}
}
}
Windsurf (~/.windsurf/mcp.json):
{
"mcpServers": {
"exchange-rateapi": {
"command": "npx",
"args": ["-y", "@exchangerateapi/mcp-server"],
"env": { "EXCHANGE_RATE_API_KEY": "era_live_..." }
}
}
}
Tools
| Tool | Description |
|---|---|
get_exchange_rate | Get the current mid-market rate between two currencies |
get_historical_rates | Get historical data for a pair over 1d, 7d, 30d, or 1y |
get_rates | Multi-target rates with date ranges and grouping (day/week/month) |
list_currencies | List all 160+ supported currencies |
Example Prompts
Once configured, ask your AI assistant:
- "What's the current USD to EUR exchange rate?"
- "Show me GBP/JPY rates for the last 30 days"
- "Convert 5000 USD to EUR, GBP, and JPY"
- "List all supported currencies"
- "What's the monthly average EUR/USD rate for 2026?"
Environment Variables
| Variable | Required | Description |
|---|---|---|
EXCHANGE_RATE_API_KEY | Yes | Your API key from exchange-rateapi.com |
EXCHANGE_RATE_BASE_URL | No | Override API base URL (default: https://exchange-rateapi.com/api) |
Links
License
MIT
الأسئلة الشائعة
ما هو Exchange Rate API؟
Real-time & historical exchange rates for 160+ currencies, mid-market (Reuters/Refinitiv).
كيف أثبّت Exchange Rate API؟
يعمل على جهازك. في Claude Code: claude mcp add exchange-rate-api -e 'EXCHANGE_RATE_API_KEY=<your exchange_rate_api_key>' -- npx -y @exchangerateapi/mcp-server@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Exchange Rate API إلى مفتاح API؟
نعم. يتطلب EXCHANGE_RATE_API_KEY، وتضبطها في إعداداته.
هل Exchange Rate API مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Exchange Rate API؟
ينشره Exchange-RateAPI. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.