# RAVN

Connects your assistant to cross-chain swaps across EVM networks, Solana, and native Bitcoin without requiring API keys or custodial accounts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: ravndex
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ravndex/ravn-examples
- Updated: 2026-10-17
- HTML: https://affpapa.org/en/nevibecode/mcp/ravn

## What it 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.

## Requirements
- Remote server: `https://app.ravn.exchange/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ravn https://app.ravn.exchange/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ravn --url https://app.ravn.exchange/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ravn": {
            "url": "https://app.ravn.exchange/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ravn": {
            "type": "http",
            "url": "https://app.ravn.exchange/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ravn https://app.ravn.exchange/api/mcp
```

## When to use it
- 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
- 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

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md