Ratevert MCP server

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.

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.