Ratevert MCP server
Commit Oct 7, 2026Enables AI agents to search for assets and perform currency, stock, crypto, ETF, and fund conversions.
Also known as ratevert/mcp, mcp
- Stars
- 3
- Tools
- 4
- Downloads, 30 days
- —
- Latest version
- 0.3.1
- Last commit
- Oct 7, 2026
- License
- MIT
What is Ratevert MCP?
Ratevert enables AI agents to search for assets and perform currency, stock, crypto, ETF, and fund conversions. It exposes 4 tools, such as search_assets, get_rate, convert_amount.
Summary generated from the project's README
About Ratevert MCP server
Finding canonical asset identities and performing financial conversions from inside an AI agent is what Ratevert MCP enables. Developers can use this read-only server to search for and convert currencies, stocks, crypto, ETFs, and funds. It provides exact conversion rates, source freshness, and specific URLs to cite for every transaction.
Users can connect to the hosted endpoint via a remote Streamable HTTP transport in compatible clients like Claude Code or ChatGPT. The service requires no API key for public usage, though it is subject to rate limits. When performing comparisons, a single request can include one source asset and up to three target assets.
For local development, the server requires Node.js 20 or newer and npm 10 or newer. It binds to 127.0.0.1:3010 by default and communicates with the Ratevert API to fetch market data. The available tools include search_assets, get_rate, convert_amount, and compare_assets to handle various financial queries.
What you can do with it
- 1Identify specific financial assetsAn AI agent can find the official identity for a specific currency, stock, or crypto asset.
- 2Calculate precise currency conversionsA developer can ask an agent to convert a specific amount between two different assets.
- 3Compare multiple assets simultaneouslyAn agent can evaluate one source asset against up to three different targets in a single step.
- 4Retrieve current exchange ratesAn AI can fetch the current one-unit rate for a specific asset pair.
Written from the project's README. Every use case is checked against a quote from it.
How to install Ratevert MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Ratevert MCP in Claude Code
$ claude mcp add --transport http mcp https://ratevert.com/api/mcpInstall Ratevert MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://ratevert.com/api/mcp"
}
}
}Install Ratevert MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://ratevert.com/api/mcp"
}
}
}Install Ratevert MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://ratevert.com/api/mcp"}'Install Ratevert MCP in Codex
$ codex mcp add mcp --url https://ratevert.com/api/mcpInstall Ratevert MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://ratevert.com/api/mcp"
Install Ratevert MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://ratevert.com/api/mcpInstall Ratevert MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://ratevert.com/api/mcp",
"type": "http"
}
}
}Ratevert MCP tools 4
Detected from the READMEsearch_assetsget_rateconvert_amountcompare_assets
| search_assets | — | |
| get_rate | — | |
| convert_amount | — | |
| compare_assets | — |
Configuration
RATEVERT_MCP_TEST_URL
| Name | Description | |
|---|---|---|
| RATEVERT_MCP_TEST_URL | — |
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 reachableratevert/mcp is public and reachablegithub.com/ratevert/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-07github.com/ratevert/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model4 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 793 msPass
README
View on GitHubRatevert 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.
Ratevert MCP questions
How do I add Ratevert MCP to Claude Code?
Run claude mcp add --transport http mcp https://ratevert.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Ratevert 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 Ratevert MCP provide?
It exposes 4 tools, including search_assets, get_rate, convert_amount, compare_assets.
Does Ratevert MCP require an API key?
No, the server does not require an API key for usage.
What assets can I search for?
You can search for currencies, stocks, ETFs, funds, and crypto assets.
Is the data provided suitable for financial advice?
No, the service is informational and should not be used for investment, trading, tax, or payment advice.
Are there limits on comparison requests?
Yes, a comparison request can include up to four total assets, consisting of one source and up to three targets.