{"name":"exchange.ravn/ravn","slug":"ravn","title":"RAVN","description":"Cross-chain swap API for native Bitcoin, Solana and EVM chains. No API key, no custody.","url":"https://mcp.market/server/ravn","rating":null,"grade":"B","score":81,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":20,"stars":0,"forks":0,"downloads_week":null,"last_push_at":"2026-09-25T05:08:20.000Z","license":"MIT"},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-11-05T16:30:39.365Z","last_ok_at":"2026-11-05T16:30:39.365Z","latency_ms":556},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/ravndex/ravn-examples","website":null,"version":"1.0.3","remotes":[{"type":"streamable-http","url":"https://app.ravn.exchange/api/mcp"}],"packages":[],"tools":[{"name":"ravn_btc_coverage","description":"For a swap where native BTC is the source, not every token on the destination chain is reachable. Returns which of ravn_tokens's list on `chainId` a BTC venue can actually route to, and how many venues serve each, so you can build a token list that matches what will really quote instead of discovering it one NO_LIQUIDITY at a time. BTC-as-source only — selling a token INTO BTC isn't restricted the same way (nearly any token can be sold into BTC), so this has nothing useful to say about that direction.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"chainId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The destination chain to check BTC-source coverage on"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["chainId"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_btc_prepare_send","description":"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).","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"fromAddress":{"type":"string","description":"Your Bitcoin address holding the UTXOs to spend — native SegWit (bc1q…) or Taproot (bc1p…) only"},"toAddress":{"type":"string","description":"deposit.address from the ravn_execute DEPOSIT result"},"amountSats":{"type":"string","description":"deposit.amount from the ravn_execute DEPOSIT result, in satoshis"},"feeAddress":{"description":"fee.address from the ravn_execute DEPOSIT result — REQUIRED whenever that result has a `fee`. RAVN's fee is paid as an extra output of this same transaction; leave it out and the fee is never paid","type":"string"},"feeAmountSats":{"description":"fee.amount from the ravn_execute DEPOSIT result, in satoshis — pass together with feeAddress","type":"string"},"feeRateSatsPerVb":{"description":"Omit to use mempool.space's current halfHourFee estimate","type":"number","exclusiveMinimum":0},"network":{"description":"Defaults to mainnet","type":"string","enum":["mainnet","testnet"]}},"required":["fromAddress","toAddress","amountSats"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_chains","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_execute","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"quoteToken":{"type":"string","description":"The quoteToken returned by ravn_quote"},"destinationAddress":{"description":"Late-bound output recipient, honoured by venues that bind at execution time (Chainflip, Garden, Layerswap, Mayan, NEAR Intents, Rift, RAVN two-hop routes). Every other venue fixes the recipient when it prices: a DIFFERENT address here is rejected rather than silently ignored. Supply destinationAddress on ravn_quote instead, which every venue honours","type":"string"},"refundAddress":{"description":"Late-bound refund recipient if the swap fails, honoured by venues that read one at execution time (Chainflip, Garden, NEAR Intents, Rift). Every other venue, Mayan, Layerswap and RAVN two-hop routes included, fixes the refund address when it prices: one that differs from the refund the quote was priced with is rejected rather than silently ignored. A quote priced without one refunds where it was priced (normally userAddress) at these venues, so a refundAddress here other than userAddress is rejected too, when userAddress is a valid address on the input chain (selling native Bitcoin with no quoted refund, a venue that can execute uses this one). Supply refundAddress on ravn_quote instead","type":"string"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["quoteToken"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_health","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_quote","description":"Get a swap quote from RAVN — same-chain or cross-chain, across 17 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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"inputChainId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"},"outputChainId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"},"inputToken":{"type":"string","description":"Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin"},"outputToken":{"type":"string","description":"Token contract address, or 0xEeeeeEeeeEeEeeEeEeEeeeEEeeeeEeeeeeeeEEeE for the chain's native coin"},"inputAmount":{"type":"string","description":"Positive integer string, in the input token's smallest unit (no decimals)"},"userAddress":{"type":"string","description":"Address the input asset will be sent from"},"destinationAddress":{"description":"Where output should land, if different from userAddress. Required here, at quote time, to get an executable quote from Relay (Bitcoin as the source), THORChain (Bitcoin either direction), Across (a Solana-touching route), or Eco (a cross-ecosystem route) — omit it there and you get back a priced-but-unexecutable preview instead (see ravn_quote's executable), not an error. A malformed address, one from the wrong ecosystem, or a known non-wallet address (a RAVN-listed token's mint/contract, this swap's own tokens, the native-coin sentinel, burn addresses, Solana core programs, and via an on-chain lookup a Solana token account or program — the token-account error names the owning wallet, which is the address to use) IS an error here — funds sent there are unrecoverable. Omit the field rather than passing an empty string; an empty string is treated as omitted","type":"string"},"refundAddress":{"description":"Where to refund the input asset if the swap fails. Selling native Bitcoin with userAddress set to a Bitcoin address and no refundAddress refunds to userAddress. Well-known sample addresses (e.g. bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh) count as no address: supply the real refund. Otherwise it is required here, at quote time, for a Bitcoin-source Relay or THORChain quote — neither has an execute-time re-bind, so omitting it returns a priced-but-unexecutable preview and supplying it later on ravn_execute is refused. Other BTC-source venues (Garden, Chainflip, Rift, NEAR Intents) support binding this at execute time instead. Validated against the INPUT chain (refunds are paid back on the origin), with the same non-wallet-address check as destinationAddress","type":"string"},"slippageBps":{"description":"Max acceptable slippage in basis points. Setting it drops venues that enforce no minimum (today Rift) from the race unless allowNoMinimum is true","type":"integer","minimum":1,"maximum":5000},"allowNoMinimum":{"description":"Let venues that enforce no minimum (today Rift) race even though slippageBps is set. Their quotes carry slippage.noMinimum true and fill at the venue's own rate: slippageBps does not protect them","type":"boolean"},"rankingMode":{"description":"best_output (default) picks the highest net output; fastest picks the quickest-settling quote within slippageBps","type":"string","enum":["best_output","fastest"]},"excludeVenues":{"description":"Drop specific venues from this race, e.g. a risk objection to one of them or ravn_health showing it degraded. Naming a venue that was never eligible for this pair is a no-op, not an error","type":"array","items":{"type":"string"}},"onlyVenues":{"description":"Race only these venues, e.g. [\"bebop\"] for an RFQ-only race. Every other venue is left out (including ones RAVN adds later); excludeVenues still applies on top. Matched against the quote's venue id, so it picks which venue you deal with, not every venue your funds pass through: RAVN's multi-step routes (compose, and relay quotes that carry hops) run legs through the venues in hops, and venues such as Rift, Across (when it swaps before or after bridging) and Mayan (a Solana order swaps through Jupiter first) route through other venues without listing them. Same-chain venues only quote same-chain pairs; if none of the named venues can quote you get NO_LIQUIDITY","minItems":1,"type":"array","items":{"type":"string"}},"confidential":{"description":"Settle privately via NEAR Intents' Confidential Intents so the deposit and payout can't be linked on-chain. Through this MCP server only NEAR quotes it (NO_LIQUIDITY if it can't, never a public fallback): RAVN's second private venue, Houdini Swap, needs the end user's IP, user-agent and country for its compliance rules, which an MCP call doesn't carry — use POST /api/v1/quote for it. ~0.3 bps extra on EVM-to-EVM, ~5-8 bps extra when Bitcoin or Solana is a leg, and it can settle slower than a public swap (Bitcoin-source: 13 min public vs 43 min confidential) — read estimatedTimeSeconds before executing","type":"boolean"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["inputChainId","outputChainId","inputToken","outputToken","inputAmount","userAddress"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_status","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"quoteToken":{"type":"string","description":"The quoteToken from ravn_quote — the venue is decoded from it"},"ref":{"type":"string","description":"statusRef from ravn_execute when it returned one (always for DEPOSIT and SIGNATURE venues — it is the venue's own tracking key, which is not always the deposit address); otherwise the origin tx hash"},"txHash":{"description":"The transaction that paid a fee the swap carries, where RAVN can't find it otherwise: a two-hop route's hop-1 tx, or the on-chain transaction that carried an execution's fee.transaction (Rift and private swaps on DEPOSIT; Eco, Layerswap and Mayan routes paying no referrer on TRANSACTION) — on its own, or the batch or relay that included it (not an EIP-5792 batch id or a 4337 userOpHash). Not needed on an Eco or Mayan TRANSACTION with no statusRef when the fee rode in the swap's own transaction and you poll with that hash. Send it on every poll once confirmed; until RAVN can read it, a delivered swap reports 'processing' (up to 15 minutes after execute). Without it nothing is owed on that swap","type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["quoteToken","ref"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_submit_signature","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"quoteToken":{"type":"string","description":"The quoteToken from ravn_quote"},"signature":{"type":"string","pattern":"^0x[0-9a-fA-F]+$","description":"Signature over the typedData from ravn_execute"},"approvalSignature":{"description":"0x Gasless only: signature over approvalData, when ravn_execute returned one","type":"string","pattern":"^0x[0-9a-fA-F]+$"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["quoteToken","signature"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_tokens","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"chainId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["chainId"],"$schema":"https://json-schema.org/draft/2020-12/schema"}},{"name":"ravn_tokens_resolve","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"chainId":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Numeric chain id, e.g. 1=Ethereum, 8453=Base, -1=Bitcoin, -2=Solana — see ravn_chains for the full list, or ravn_health for live venue status"},"address":{"type":"string","description":"Token contract address / mint to resolve"},"apiKey":{"description":"Your RAVN API key, if you have one — raises your rate limit","type":"string"}},"required":["chainId","address"],"$schema":"https://json-schema.org/draft/2020-12/schema"}}],"scan":{"score":81,"grade":"B","scanned_at":"2026-10-16T21:41:13.945Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-16T21:41:13.897Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 993ms"]},"poisoning":{"score":15,"max":15,"notes":["10 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 3 write-action tools with no auth"]},"maintenance":{"score":15,"max":15,"notes":["last push 22 days ago"]},"identity":{"score":8,"max":10,"notes":["endpoint served from the registry-verified namespace domain"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"}],"inputs":{"probes":[{"url":"https://app.ravn.exchange/api/mcp","reachable":true,"authRequired":false,"latencyMs":993,"serverInfo":{"name":"ravn","version":"1.0.2"}}],"packages":[],"repo":{"found":true,"owner":"ravndex","repo":"ravn-examples","archived":false,"pushedAt":"2026-09-25T05:08:20Z","stars":0,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/295170005?v=4","ownerCreatedAt":"2026-06-19T15:55:28Z","license":"MIT"},"icon":{"url":"https://app.ravn.exchange/icon.png?icon.3nwwle_65rf5y.png","source":"registry","width":512,"height":512},"presence":{"stars":0,"forks":0,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-09-25T05:08:20.000Z","score":20}}}},"grade_history":[],"reviews":[]}