RAVN
Server Details
Cross-chain swap API for native Bitcoin, Solana and EVM chains. No API key, no custody.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- ravndex/ravn-examples
- GitHub Stars
- 0
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 10 tools
Most tools are clearly differentiated by resource+action: quote vs execute vs status vs submit_signature form a distinct lifecycle, and ravn_chains/ravn_health have unique purposes. The only mild overlap is among ravn_tokens, ravn_tokens_resolve, and ravn_btc_coverage, but the descriptions explicitly delineate them (registry vs paste-any-address resolution vs BTC venue ranking hint).
All ten tools share a uniform `ravn_` prefix and snake_case, which makes the set predictable. There is a minor style deviation: some names are pure nouns (ravn_chains, ravn_tokens, ravn_quote) while others are verb_noun (ravn_btc_prepare_send, ravn_submit_signature, ravn_tokens_resolve).
Ten tools is a well-scoped count for a swap-aggregation server spanning quote, execute, submit, status, registry, health, and BTC-specific helpers. Each tool maps to a distinct step or auxiliary concern rather than padding the surface.
The core swap lifecycle is fully covered: ravn_quote → ravn_execute → ravn_submit_signature → ravn_status, plus token/chain discovery and a BTC PSBT helper. Minor gaps exist around cancel/refund or historical swap listing, but agents can work around them with status polling.
Available Tools
10 toolsravn_btc_coverageHow many BTC venues list each tokenARead-onlyInspect
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.
Inputs: chainId (required), apiKey. Returns: object
ravn_btc_prepare_sendPrepare a signable Bitcoin transaction for a RAVN DEPOSITARead-onlyInspect
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).
Inputs: toAddress (required), amountSats (required), fromAddress (required), network, +3 more. Returns: object
ravn_chainsList every chain RAVN supportsARead-onlyInspect
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.
Inputs: apiKey. Returns: object
ravn_executeExecute a RAVN swap quoteAInspect
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.
Inputs: quoteToken (required), apiKey, refundAddress, destinationAddress. Returns: object
ravn_healthCheck RAVN venue healthARead-onlyInspect
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.
Inputs: no named parameters. Returns: object
ravn_quoteGet a RAVN swap quoteARead-onlyInspect
Get a swap quote from RAVN — same-chain or cross-chain, across 20 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.
Inputs: inputToken (required), inputAmount (required), outputToken (required), userAddress (required), +12 more. Returns: object
ravn_statusCheck RAVN swap statusARead-onlyInspect
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.
Inputs: ref (required), quoteToken (required), apiKey, txHash. Returns: object
ravn_submit_signatureSubmit a signed RAVN orderAInspect
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.
Inputs: signature (required), quoteToken (required), apiKey, approvalSignature. Returns: object
ravn_tokensList RAVN's token registry for a chainARead-onlyInspect
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.
Inputs: chainId (required), apiKey. Returns: object
ravn_tokens_resolveResolve a token address to its metadataARead-onlyInspect
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.
Inputs: address (required), chainId (required), apiKey. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Quote, create and track crypto swaps across hundreds of coins and networks. No account needed.
Token swaps at the best net price on 9 EVM chains and Solana. No API key, non-custodial.
No-account cross-chain crypto swaps (BTC, ETH, SOL, USDT, ZEC…) for AI agents. Flat 0.5% fee.
Quote, create and track cross-chain crypto swaps. Non-custodial exchange, no account, no KYC.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables cross-chain swap execution across 12 venues and 17 chains, including native Bitcoin as source or destination, with tools for quoting, execution, status, and health checks. No signup, API key, or protocol fee required.5MIT
- AlicenseAqualityBmaintenanceReal-time non-custodial crypto swap rates, fees, and on-chain routing across 240+ multi-chain pairs.2MIT
- AlicenseNot gradedqualityCmaintenanceCross-chain cryptocurrency swaps via Chainflip. Get quotes, execute swaps, and track progress. No API key required to get started.10MIT
- AlicenseNot gradedqualityDmaintenanceFree DEX aggregator API that returns executable swap calldata across 46 EVM chains. No API key required. Single GET request returns ready-to-sign transactions for any token pair.22MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.