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).
| 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.
The official MCP Registry listing is com.ratevert/mcp. Use that as the public distribution channel; the hosted Streamable HTTP URL remains https://ratevert.com/api/mcp.
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.