Ratevert MCP is a public, read-only Model Context Protocol server for searching and converting currencies, stocks, crypto, ETFs, and funds.
Overview
Ratevert MCP is a public, read-only Model Context Protocol server for searching and converting currencies, stocks, crypto, ETFs, and funds.
README
Ratevert MCP
Ratevert MCP is a public, read-only Model Context Protocol server for searching and converting currencies, stocks, crypto, ETFs, and funds. It is designed for AI agents that need a canonical asset identity, an exact current conversion, source freshness when available, and a Ratevert URL to cite.
The hosted endpoint is:
https://ratevert.com/api/mcp
It requires no API key. Public usage is rate-limited and a comparison request may include up to four total assets (one source plus three targets).
Tools
| Tool | What it does |
|---|---|
search_assets |
Finds a canonical Ratevert currency, stock, ETF, fund, or crypto asset. |
get_rate |
Returns the current one-unit rate for two assets with a canonical pair URL. |
convert_amount |
Converts one stated amount and returns the exact rate, rounded display value, freshness, and source URL. |
compare_assets |
Compares one source asset with up to three target assets in one request. |
Connect an agent
Use the same remote Streamable HTTP endpoint in any MCP-compatible client.
Claude Code
claude mcp add --transport http ratevert https://ratevert.com/api/mcp
ChatGPT, Codex, OpenClaw, and Hermes
Add a remote HTTP MCP server in the client configuration, name it Ratevert,
and set the URL to https://ratevert.com/api/mcp. ChatGPT availability depends
on the account and Developer Mode features provided by OpenAI; Ratevert is not
published as a ChatGPT store plugin.
Human documentation and connection guidance: ratevert.com/mcp.
Run locally
Requirements:
- Node.js 20 or newer
- npm 10 or newer
npm ci
cp .env.example .env
npm start
The server binds to 127.0.0.1:3010 by default, exposing
http://127.0.0.1:3010/mcp. It calls RATEVERT_MCP_API_BASE_URL for public
Ratevert API data. When you host it behind a reverse proxy, keep
RATEVERT_MCP_TRUST_PROXY limited to that known proxy and overwrite incoming
forwarding headers at the proxy boundary.
Validate
npm test
npm run verify:release
npm pack --dry-run
For a deployed endpoint:
RATEVERT_MCP_TEST_URL=https://ratevert.com/api/mcp npm run smoke
Do not enable the optional rate-limit loop in production without using a separate test address: it intentionally sends repeated requests.
Data and limitations
Ratevert MCP is informational and read-only. Market data may be delayed or unavailable. Results include a retrieval timestamp and source freshness when the upstream asset data exposes it. The service is not investment, trading, tax, or payment advice.
Security
See SECURITY.md for private vulnerability reporting guidance.
Install
This server does not publish a one-line install command.
Open the repository installation guide