RAVN — Claude Code MCP server: what it does, how to install
Connects your assistant to cross-chain swaps across EVM networks, Solana, and native Bitcoin without requiring API keys or custodial accounts.
claude mcp add --transport http ravn https://app.ravn.exchange/api/mcpWhat RAVN does
RAVN exposes cross-chain swap routing to LLMs over a hosted HTTP endpoint. When requested, it queries available liquidity venues in parallel and selects the highest net output. The service handles EVM chains, Solana, and native Bitcoin directly, bypassing wrapped assets.
Architecture remains strictly non-custodial. RAVN never holds user assets and writes no smart contracts of its own. The protocol follows a fixed sequence: request a quote, fetch execution data based on the execution type, and poll settlement status. Token amounts must always be formatted as integer strings in their smallest denomination, such as satoshis or lamports.
Cross-ecosystem swaps will fail if you omit destinationAddress on the destination network. Anonymous usage without credentials permits 30 requests and 120 status checks each minute per IP address.
What it helps with
- quote cross-chain trades across EVM, Solana, and Bitcoin
- swap tokens into native BTC without wrapped assets
- monitor transaction confirmation states and execution steps
- find route pricing across competing decentralized venues
Example prompts for the agent
- Find a swap route from 250 USDC on Base to native Bitcoin
- Get quote estimates for converting SOL to ETH with fee breakdowns
- Check the final settlement status for this quote token
How to install RAVN
Platform CLI: remote server
claude mcp add --transport http ravn https://app.ravn.exchange/api/mcpPlatform CLI: remote server
codex mcp add ravn --url https://app.ravn.exchange/api/mcpConfig file
{
"mcpServers": {
"ravn": {
"url": "https://app.ravn.exchange/api/mcp"
}
}
}Config file
{
"servers": {
"ravn": {
"type": "http",
"url": "https://app.ravn.exchange/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http ravn https://app.ravn.exchange/api/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about RAVN
How to install RAVN in Claude Code?
Run claude mcp add --transport http ravn https://app.ravn.exchange/api/mcp in your terminal.
Does RAVN require an account or an API key?
You can start anonymously with an IP rate limit of 30 requests per minute. A free API key increases that threshold to 120 requests per minute without review.
Does the server support native Bitcoin or wrapped tokens?
It routes directly to native Bitcoin rather than wrapped representations. Trading from EVM chains to Bitcoin requires specifying the payout recipient via destinationAddress.
