About Ratevert MCP
Ratevert MCP is a public, read-only server for AI agents that need to find assets and retrieve currency, stock, crypto, ETF, or fund rates and conversions. Results provide canonical asset and pair URLs, with freshness information when available.
Key features
- 01Search canonical assets
- 02Retrieve current pair rates
- 03Convert stated amounts
- 04Compare up to four assets
- 05Return source and freshness details
Use cases
- 01Find an asset’s canonical identity
- 02Convert between supported assets
- 03Compare one asset with several targets
MCP support
Exposes read-only asset search, rate, conversion, and comparison tools to MCP clients through a hosted Streamable HTTP endpoint. No API key is required.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://ratevert.com/api/mcpclaude mcp add --transport http com-ratevert https://ratevert.com/api/mcp{"mcpServers":{"com-ratevert":{"type":"http","url":"https://ratevert.com/api/mcp"}}}Open in Cursor{"servers":{"com-ratevert":{"type":"http","url":"https://ratevert.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-ratevert":{"type":"http","url":"https://ratevert.com/api/mcp"}}}{"mcpServers":{"com-ratevert":{"serverUrl":"https://ratevert.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Maximum matches to return. |
| query | string | Yes | Asset name or code, for example "btc", "nvda", or "euro". |
| market | enum | No | Optional market filter: all, fiat, stocks, etfs, funds, or crypto.all | fiat | stocks | etfs | funds | crypto |
Details
From the project READMERatevert 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.
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.