MCP.so
Sign In

RAVN MCP ServerVerifiedFeatured

@RAVN

Basic information

Transport

Streamable HTTP

Authentication

None

Last updated

Category

Finance & Commerce

Author

RAVN

Submitted by

RAVN

About RAVN MCP Server

Cross-chain swap execution across 13 venues and 16 chains, including native (non-wrapped) Bitcoin as either source or destination. No signup, no API key, 0% protocol fee, same routing engine the RAVN app itself uses. Exposes ravn_quote, ravn_execute, ravn_submit_signature, ravn_status, ravn_health, ravn_tokens, ravn_tokens_resolve, ravn_btc_coverage, ravn_chains, and ravn_btc_prepare_send as MCP tools.

Connection details

https://app.ravn.exchange/api/mcp

Setup

claude mcp add ravn --transport http https://app.ravn.exchange/api/mcp

RAVN MCP Server tools

10

Get a swap quote from RAVN — same-chain or cross-chain, across 18 chains including native (non-wrapped) Bitcoin and Solana as source or destination. Free, no API key or payment required. Returns a quoteToken; pass it to ravn_execute to get a signable/broadcastable execution payload.

Turn a quoteToken from ravn_quote into an execution payload. Returns one of three shapes (executionType): TRANSACTION (sign and broadcast yourself), SIGNATURE (sign, RAVN submits), or DEPOSIT (send the input asset to a given address). RAVN never takes custody of funds — you always sign or send from your own wallet. TRANSACTION and SIGNATURE may also include an `approval` — an ERC-20 approve() you must broadcast and wait to be MINED before the transaction/signature, or it fails (reverts on TRANSACTION; on SIGNATURE the order is accepted and silently never fills). Only present when the sold token needs it — omitted for native-coin sells and already-approved tokens. An `approval.reset` (Ethereum USDT holding a partial allowance) goes first, mined, then the approval. A result with `sandbox: true` is a test: send nothing from it.

For a SIGNATURE-type ravn_execute result only: submit the signature(s) you collected (over typedData, and approvalData if present) to actually place the order. RAVN decodes the venue from quoteToken and routes to the right venue-specific submit path — you never touch a per-venue endpoint. Returns a statusRef — pass it to ravn_status as `ref` to poll this swap.

Poll the status of a swap by its quoteToken and ref from ravn_execute (statusRef, deposit address, or origin tx hash). Use the quoteToken execute returned — compose rebinds hop 1 onto hop 2's deposit. Status is authoritative where the venue exposes it; a swap the venue can't track reports 'unknown' rather than a guess.

Liveness check across every venue RAVN routes through — call before a swap if you want to know whether a route is degraded ahead of time.

RAVN's own listed token registry for one chain — populate a token picker without hardcoding one. This is "what RAVN knows about and might route", not a per-pair routability guarantee for any specific pair; call ravn_quote to check that.

Resolve an arbitrary token address to its metadata (symbol, name, decimals) via an on-chain read — for a paste-any-address flow, when the token isn't necessarily on ravn_tokens's list.

For a swap where native BTC is the source: how many BTC venues list each of ravn_tokens's tokens on `chainId`. A ranking hint (a token more venues list is more likely to keep routing through one venue's outage), not a gate: ravn_quote decides, and tokens off RAVN's list route from BTC too. BTC-as-source only.

Every chain RAVN lists a token registry for (see ravn_tokens). Static, doesn't change per request, safe to cache instead of hardcoding a chain table.

Turns a DEPOSIT-type ravn_execute result (deposit.address + deposit.amount) into a ready-to-sign PSBT, so you don't have to write your own UTXO selection and fee-estimation code. If that result also has a `fee` (an integrator fee RAVN collects beside the deposit), pass its fee.address as feeAddress and fee.amount as feeAmountSats: the PSBT then pays it as a second output of the same transaction, which is the only place RAVN looks for it. Fetches your UTXOs and the current network fee rate from mempool.space (public, no auth). RAVN never sees or touches a private key — sign the returned PSBT with your own wallet and broadcast it yourself. Only one signer is ever needed (unlike PSBT flows that require coordinating signatures across multiple UTXO-holding wallets), because every RAVN BTC-source venue resolves to a plain payment to the deposit address (plus RAVN's fee output, when there is one).

Overview

What is RAVN

RAVN is a cross-chain swap execution engine, exposed here as a hosted MCP server. Point any MCP client at it and get native swap tools, no SDK, no signup, no API key.

The thing most swap APIs can't do: RAVN routes native Bitcoin, real BTC, not a wrapped token, as either the source or destination of a swap, alongside standard EVM and Solana routes. Every quote races 13 execution venues in parallel across 16 chains, and the best net output wins. 0% protocol fee on every route.

Tools

  • ravn_quote: best priced route across all 13 venues for a given pair and amount
  • ravn_execute: turn a quote into a signable transaction, typed data, or a deposit address
  • ravn_submit_signature: submit a collected signature to actually place a SIGNATURE type order
  • ravn_status: normalized swap status (pending, processing, success)
  • ravn_health: which venues are live right now
  • ravn_tokens: RAVN's own listed token registry for a chain
  • ravn_tokens_resolve: resolve an arbitrary token address to its metadata
  • ravn_btc_coverage: which tokens on a chain actually route from native Bitcoin
  • ravn_chains: every chain RAVN lists a token registry for
  • ravn_btc_prepare_send: prep a native BTC send

Try it

what would 25 USDC on Base get me in native bitcoin right now?

which RAVN venues are up?

Custody

RAVN never holds funds and the MCP server never asks for a private key. ravn_execute returns a payload for you to sign, a transaction to broadcast, typed data to sign, or a deposit address to send to.

Links

Frequently asked questions

1

What is the RAVN remote MCP server?

The RAVN remote MCP server is a hosted Model Context Protocol endpoint at https://app.ravn.exchange/api/mcp, so AI assistants can connect to it without installing or running anything locally.

2

How do I connect to the RAVN MCP server?

Add the endpoint https://app.ravn.exchange/api/mcp to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

3

Does the RAVN MCP server require authentication?

No. RAVN's MCP server does not require authentication — you can connect directly with the endpoint URL.

4

Which transport does the RAVN MCP server use?

RAVN exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments