# Ratevert MCP [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/ratevert/mcp  
**GitHub Stars:** 4  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ratevert-mcp

## Description
Read-only Ratevert MCP for asset search, pair rates, and conversions.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "ratevert-mcp": {
    "url": "https://modelcontextprotocol.io/"
  }
}
```

## Documentation & README

# Ratevert MCP

Ratevert MCP is a public, read-only [Model Context Protocol](https://modelcontextprotocol.io/)
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:

```text
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

```bash
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`](https://registry.modelcontextprotocol.io/v0.1/servers?search=com.ratevert%2Fmcp). 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](https://ratevert.com/mcp).

## Run locally

Requirements:

- Node.js 20 or newer
- npm 10 or newer

```bash
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

```bash
npm test
npm run verify:release
npm pack --dry-run
```

For a deployed endpoint:

```bash
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](https://github.com/ratevert/mcp/blob/HEAD/SECURITY.md) for private vulnerability reporting guidance.