{"$schema":"https://modelcontextprotocol.io/schemas/server-card/v1.0","authentication":{"required":false},"capabilities":{"tools":{}},"description":"THORChain MCP server: pools, swap quotes, non-custodial swap preparation (deposit address and memo, never moves funds), transaction status, nodes, mimir and network state, served from THORNode and Midgard.","name":"thorchain-mcp","protocolVersion":"2026-07-28","serverInfo":{"description":"THORChain MCP server: pools, swap quotes, non-custodial swap preparation (deposit address and memo, never moves funds), transaction status, nodes, mimir and network state, served from THORNode and Midgard.","name":"thorchain-mcp","version":"1.1.0"},"serverUrl":"https://mcp.thorchain.org/mcp","supportedProtocolVersions":["2026-07-28","2025-11-25","2025-06-18"],"tools":[{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.","inputSchema":{"additionalProperties":false,"properties":{"amount":{"description":"The transaction amount in base units","type":"string"},"asset":{"description":"The asset (e.g. BTC.BTC)","type":"string"}},"required":["asset","amount"],"type":"object"},"name":"check_reference_memo","title":"Check Reference Memo"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns vault addresses for depositing assets into THORChain. Each chain has its own inbound address along with gas rates and halted status.","inputSchema":{"additionalProperties":false,"type":"object"},"name":"get_inbound_addresses","title":"Get Inbound Addresses"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.","inputSchema":{"additionalProperties":false,"type":"object"},"name":"get_lastblock","title":"Get Last Block Heights"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Compact THORChain network status for agents: node counts, bonding/liquidity APY, reserve, pooled RUNE, next churn height, vault migration flag. Prefer this over get_network_info (full toolset only), which returns large per-node bond arrays.","inputSchema":{"additionalProperties":false,"type":"object"},"name":"get_network_summary","title":"Get Network Summary"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier. Use this to estimate transaction costs.","inputSchema":{"additionalProperties":false,"type":"object"},"name":"get_outbound_fees","title":"Get Outbound Fees"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns one liquidity pool by asset (e.g. BTC.BTC): depths, units, status and price. Use list_pools to find asset identifiers and get_pool_stats for volume, fees and APY.","inputSchema":{"additionalProperties":false,"properties":{"asset":{"description":"The asset identifier (e.g. BTC.BTC or ETH.ETH)","type":"string"}},"required":["asset"],"type":"object"},"name":"get_pool","title":"Get Pool"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.","inputSchema":{"additionalProperties":false,"properties":{"asset":{"description":"The asset identifier (e.g. BTC.BTC or ETH.ETH)","type":"string"}},"required":["asset"],"type":"object"},"name":"get_pool_stats","title":"Get Pool Stats"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Answers \"did my swap go through?\" in plain terms. Returns a status (not_found, pending, streaming, sent, refunded, completed), whether it is done, a one-line summary to tell the user, streaming progress, an estimated wait, and the refund reason. refund=true with status sent means part was refunded. Start here for swap tracking; use get_tx_status only for raw stage detail.","inputSchema":{"additionalProperties":false,"properties":{"hash":{"description":"The deposit (inbound) transaction hash: the hash of what the user sent to THORChain. A 0x prefix is fine.","type":"string"}},"required":["hash"],"type":"object"},"name":"get_swap_status","title":"Get Swap Status"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns the observed transaction for a hash (inbound or outbound): chain, addresses, coins, memo and the heights THORChain saw it at. For \"did my swap go through?\" use get_swap_status.","inputSchema":{"additionalProperties":false,"properties":{"hash":{"description":"The transaction hash (inbound or outbound)","type":"string"}},"required":["hash"],"type":"object"},"name":"get_tx","title":"Get Transaction"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns THORNode's raw status for an inbound transaction: every processing stage, planned outbounds and sent outbounds. For a plain answer (pending, streaming, sent, refunded) use get_swap_status; use this for stage-level detail.","inputSchema":{"additionalProperties":false,"properties":{"hash":{"description":"The inbound transaction hash to check status for","type":"string"}},"required":["hash"],"type":"object"},"name":"get_tx_status","title":"Get Transaction Status"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.","inputSchema":{"additionalProperties":false,"properties":{"limit":{"description":"Maximum number of results to return (default 100, max 1000)","type":"integer"},"offset":{"description":"Number of results to skip for pagination","type":"integer"}},"type":"object"},"name":"list_pools","title":"List Pools"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Returns THORName details including chain addresses, expiry, and owner.","inputSchema":{"additionalProperties":false,"properties":{"name":{"description":"THORName to look up","type":"string"}},"required":["name"],"type":"object"},"name":"lookup_thorname","title":"Look Up THORName"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Health check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.","inputSchema":{"additionalProperties":false,"type":"object"},"name":"ping","title":"Ping THORNode"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Build a ready-to-execute THORChain swap. Returns the exact vault address to send to, the memo, the source chain, the expected output and guaranteed minimum, the estimated time, and an expiry. Use this when the user wants to actually perform a swap, not just price it (for pricing only, use quote_swap). The returned instruction is what a wallet signs and broadcasts; this tool itself never moves funds.","inputSchema":{"additionalProperties":false,"properties":{"affiliate":{"description":"Optional affiliate address or THORName that collects a fee","type":"string"},"affiliate_bps":{"description":"Optional affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)","type":"integer"},"amount":{"description":"Amount to swap in THORChain base units (1e8; e.g. 50000000 = 0.5 BTC)","type":"integer"},"destination":{"description":"The address on the destination chain that will receive the swap output. Required to execute a swap.","type":"string"},"from_asset":{"description":"The source asset to swap from (e.g. BTC.BTC)","type":"string"},"max_slippage_bps":{"description":"Maximum acceptable slippage in basis points; sets the min-received limit baked into the memo (default 300 = 3%). Range 1-10000.","type":"integer"},"to_asset":{"description":"The target asset to swap to (e.g. ETH.ETH)","type":"string"}},"required":["from_asset","to_asset","amount","destination"],"type":"object"},"name":"prepare_swap","title":"Prepare Swap"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Get a limit order quote with expected output, expiry time, and a generated memo for executing the limit order. Limit orders execute when the target price is reached. For an immediate market swap use quote_swap.","inputSchema":{"additionalProperties":false,"properties":{"affiliate":{"description":"The affiliate address or THORName","type":"string"},"affiliate_bps":{"description":"The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)","type":"integer"},"amount":{"description":"The amount in base units (1e8 for most assets)","type":"integer"},"custom_ttl":{"description":"Custom TTL in blocks for the limit order","type":"integer"},"destination":{"description":"The destination address for the swap output","type":"string"},"from_asset":{"description":"The source asset (e.g. BTC.BTC)","type":"string"},"refund_address":{"description":"The refund address if the swap fails","type":"string"},"streaming_quantity":{"description":"Number of sub-swaps for streaming","type":"integer"},"target_out":{"description":"The limit price: minimum acceptable output amount in base units (1e8). The order executes only at this price or better","type":"integer"},"to_asset":{"description":"The target asset (e.g. ETH.ETH)","type":"string"}},"required":["from_asset","to_asset","amount","target_out"],"type":"object"},"name":"quote_limit","title":"Quote Limit Order"},{"annotations":{"destructiveHint":false,"idempotentHint":true,"openWorldHint":true,"readOnlyHint":true},"description":"Calculate how much output you would receive when swapping one asset for another. Use this tool to answer questions like 'how much ETH would I get for 100 RUNE?' Returns expected output amount, fees, slippage, estimated time, and a memo for executing the swap.","inputSchema":{"additionalProperties":false,"properties":{"affiliate":{"description":"The affiliate address or THORName","type":"string"},"affiliate_bps":{"description":"The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)","type":"integer"},"amount":{"description":"The amount in base units (1e8 for most assets)","type":"integer"},"destination":{"description":"The destination address for the swap output","type":"string"},"from_asset":{"description":"The source asset (e.g. BTC.BTC)","type":"string"},"to_asset":{"description":"The target asset (e.g. ETH.ETH)","type":"string"}},"required":["from_asset","to_asset","amount"],"type":"object"},"name":"quote_swap","title":"Quote Swap"}],"transport":{"endpoint":"https://mcp.thorchain.org/mcp","type":"streamable-http","url":"https://mcp.thorchain.org/mcp"},"version":"1.1.0"}
