Rate-API MCP server
Commit Sep 23, 2026Provides exchange rates for over 160 currencies, cryptocurrency prices, precious metals, and stock data to AI clients.
Also known as Vilgar/rate-api-mcp, @rate-api/mcp
- Stars
- 0
- Tools
- 17
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Sep 23, 2026
- License
- MIT
What is Rate-API MCP?
Rate-API provides exchange rates for over 160 currencies, cryptocurrency prices, precious metals, and stock data to AI clients. It exposes 17 tools, such as get_latest_rates, get_pair_rate, list_currencies.
Summary generated from the project's README
About Rate-API MCP server
Fetching real-time exchange rates and financial data from within an AI assistant is what this server enables. It provides access to over 160 currencies, cryptocurrency prices, precious metals like gold and silver, and end-of-day stock prices. Developers can use it through Claude Desktop, Claude Code, or via Docker by configuring an environment variable with a required API key from Rate-API.
The server offers a tiered toolset based on your subscription plan. Free users can access tools like get_latest_rates, get_pair_rate, and list_currencies, while Pro+ users gain access to convert_currency, get_crypto_rates, and get_metal_prices. Higher-tier Business+ plans include advanced features such as get_timeseries_rates, get_rate_fluctuation, and the ability to create or delete rate alerts via create_rate_alert and delete_rate_alert.
Integration is handled via stdio and requires Node.js 18 or higher. The server includes built-in resources for currency lists and pre-made prompts for common workflows like currency movement analysis. It also allows for monitoring your own usage and quota through get_usage and get_quota tools.
What you can do with it
- 1Convert currency amountsAsk the assistant to calculate the value of a specific amount between two different currencies.
- 2Track precious metals and stocksRetrieve the current prices for gold, silver, or specific equity closing prices in USD.
- 3Set up automated price alertsInstruct the AI to create an email or webhook notification when a currency pair hits a certain threshold.
Written from the project's README. Every use case is checked against a quote from it.
How to install Rate-API MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Rate-API MCP in Claude Code
$ claude mcp add rate-api-mcp -- npx -y @rate-api/mcpInstall Rate-API MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"rate-api-mcp": {
"command": "npx",
"args": [
"-y",
"@rate-api/mcp"
]
}
}
}Install Rate-API MCP in VS Code
.vscode/mcp.json
{
"servers": {
"rate-api-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@rate-api/mcp"
]
}
}
}Install Rate-API MCP in VS Code CLI
$ code --add-mcp '{"name":"rate-api-mcp","type":"stdio","command":"npx","args":["-y","@rate-api/mcp"]}'Install Rate-API MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"rate-api-mcp": {
"command": "npx",
"args": [
"-y",
"@rate-api/mcp"
]
}
}
}Install Rate-API MCP in Codex
$ codex mcp add rate-api-mcp -- npx -y @rate-api/mcpInstall Rate-API MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.rate-api-mcp] command = "npx" args = ["-y", "@rate-api/mcp"]
Install Rate-API MCP in Gemini CLI
$ gemini mcp add -s user rate-api-mcp npx -- -y @rate-api/mcpInstall Rate-API MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"rate-api-mcp": {
"command": "npx",
"args": [
"-y",
"@rate-api/mcp"
]
}
}
}Rate-API MCP tools 17
Detected from the READMEget_latest_ratesget_pair_ratelist_currenciesget_usageget_quotaget_key_statusget_api_statusconvert_currencyget_historical_ratesget_crypto_ratesget_metal_pricesget_stock_prices
Show all 17 toolsShow fewer tools
get_timeseries_ratesget_rate_fluctuationlist_rate_alertscreate_rate_alertdelete_rate_alert
Configuration
RATE_API_KEY
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablevilgar/rate-api-mcp is public and reachablegithub.com/vilgar/rate-api-mcp ↗Pass
- Package names this repository as its source@rate-api/mcp names vilgar/rate-api-mcp as sourcenpmjs.com/package/@rate-api/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-09-23github.com/vilgar/rate-api-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @rate-api/mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model17 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubRate-API MCP Server
The official Model Context Protocol server for Rate-API.com. It gives Claude and other MCP clients exchange rates for 160+ currencies (updated hourly), currency conversion, historical rates, daily time series and fluctuation, crypto, precious-metal and end-of-day stock prices, usage and quota checks, and rate alerts.
Once connected, you can just ask: "What's 250 EUR in Japanese yen?" or "How has USD/TRY moved over the last 30 days?" and the assistant calls the API for you.
Tools
| Tool | Description | Plan |
|---|---|---|
get_latest_rates |
Latest rates for a base currency (optionally filtered) | Free |
get_pair_rate |
Single currency-pair rate with optional precision (converted amount on Pro+) | Free |
list_currencies |
All supported currency codes and names | Free |
get_usage |
This key's plan and current-month usage against its quota | Free |
get_quota |
Plan quota and remaining requests for this key | Free |
get_key_status |
Confirm the key works (API status and version) | Free |
get_api_status |
Service status and data freshness | No key needed |
convert_currency |
Convert an amount between two currencies | Pro+ |
get_historical_rates |
Rates for a specific past date | Pro+ |
get_crypto_rates |
Cryptocurrency prices in USD | Pro+ |
get_metal_prices |
Gold, silver, platinum and palladium per troy ounce in USD | Pro+ |
get_stock_prices |
End-of-day closing prices for tracked equities in USD (indicative, not for trading) | Pro+ |
get_timeseries_rates |
Daily rates for every day between two dates (up to 366 days) | Business+ |
get_rate_fluctuation |
Start rate, end rate, change and % change between two dates (up to 366 days) | Business+ |
list_rate_alerts |
List the rate alerts on this key | Business+ |
create_rate_alert |
Alert (email and optional signed webhook) when a pair crosses a threshold | Business+ |
delete_rate_alert |
Delete a rate alert by id | Business+ |
"Pro+" means Pro, Business and Enterprise; "Business+" means Business and
Enterprise. Calling a tool your plan doesn't include returns the API's
feature_not_available error, so the assistant can tell you which plan it needs.
See pricing.
Setup
You need an API key. The free plan (2,500 requests/month, no card) is at https://rate-api.com/register; your keys are listed at https://rate-api.com/api-keys.
Claude Code
claude mcp add rate-api -e RATE_API_KEY=YOUR_KEY -- npx -y @rate-api/mcp
Claude Desktop / other MCP clients
Add to your MCP config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"rate-api": {
"command": "npx",
"args": ["-y", "@rate-api/mcp"],
"env": { "RATE_API_KEY": "YOUR_KEY" }
}
}
}
Run directly
RATE_API_KEY=YOUR_KEY npx -y @rate-api/mcp
Docker
docker build -t rate-api-mcp .
docker run -i --rm -e RATE_API_KEY=YOUR_KEY rate-api-mcp
Configuration
| Env var | Required | Default | Description |
|---|---|---|---|
RATE_API_KEY |
for keyed tools | — | Your Rate-API key |
RATE_API_BASE_URL |
no | https://rate-api.com |
Override the API base URL |
RATE_API_TIMEOUT_MS |
no | 15000 |
Per-request timeout (ms) |
The server starts without a key; every tool except get_api_status then asks you
to set RATE_API_KEY.
Resources & prompts
Besides the tools, the server exposes:
- Resource
rate-api://currencies: the supported currency list (code, name, symbol, decimals). - Prompts
convert_amountandcurrency_movement: ready-made FX workflow templates.
Local development
git clone https://github.com/Vilgar/rate-api-mcp.git
cd rate-api-mcp
npm install
RATE_API_KEY=YOUR_KEY npm start
# or inspect interactively:
RATE_API_KEY=YOUR_KEY npm run inspect
Transport is stdio; requires Node.js 18+. The only dependency is the official
@modelcontextprotocol/sdk.
Links
- API docs: https://rate-api.com/docs/api
- OpenAPI 3.0: https://rate-api.com/openapi.json
- Issues: https://github.com/Vilgar/rate-api-mcp/issues
License
MIT, see LICENSE.
Rate-API MCP questions
How do I add Rate-API MCP to Claude Code?
Run claude mcp add rate-api-mcp -- npx -y @rate-api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Rate-API MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Rate-API MCP provide?
It exposes 17 tools, including get_latest_rates, get_pair_rate, list_currencies, get_usage, get_quota.
What currencies are supported?
The server provides exchange rates for over 160 currencies.
Do I need an API key to check the service status?
No, the get_api_status tool does not require an API key.
What happens if I try to use a tool that is not in my plan?
The tool will return a feature_not_available error, allowing the assistant to inform you which plan is required.