THORChain MCP

A read-only MCP server providing access to THORChain network data, including pools, swap quotes, non-custodial swap preparation, transaction status, and network state. It serves as a public discovery tool for agents interacting with the decentralized cross-chain liquidity protocol.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Vendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by THORChain

MCP endpoint (Streamable HTTP)

https://mcp.thorchain.org/mcp

Vendor documentation

What you can do with it

Query THORChain pool data and network state
Obtain swap quotes for cross-chain transactions
Prepare non-custodial swap transactions
Check transaction status on the THORChain network

Source and maintenance

Vendor evidenceRegistry 1.0.0

mcp-registry: org.thorchain/thorchain-mcp@1.0.0 Source repository

Maintenance checked: Nov 1, 2026, 4:44 PM UTC

Protocol and capabilities

Server: thorchain-mcp 1.0.0
MCP protocol: 2025-06-18
Tools: 126 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {
    "listChanged": true
  },
  "logging": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

THORChain MCP Server Instructions: AMOUNT NOTATION: All amounts are in base units (1e8 notation). 1 RUNE = 100,000,000 base units. To convert: divide by 1e8 for human-readable, multiply by 1e8 for base units. Example: 150000000 = 1.5 units. TOOL SELECTION GUIDE: - "How much X would I get for Y?" → Use quote_swap to calculate swap output, fees, and slippage - "I want to actually swap X for Y" → Use prepare_swap; it returns the deposit address, memo, and guaranteed minimum. It never moves funds; the user signs with their own wallet - "What is the price of X?" → Use get_pool to get current pool depths and calculate price - "Show me pool info" → Use list_pools or get_pool - "Network status" → Use get_network_summary - "Did my swap go through?" → Use get_tx_status

Tools

126 advertised

check_reference_memo

Advertised by the server during the last successful anonymous check.

Advertised read-only

Pre-flight check for memoless transactions. Returns what reference would be extracted from the amount and whether it's available for registration.

check_reference_memo input schema

{
  "type": "object",
  "required": [
    "asset",
    "amount"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The asset (e.g. BTC.BTC)"
    },
    "amount": {
      "type": "string",
      "description": "The transaction amount in base units"
    }
  },
  "additionalProperties": false
}

check_reference_memo annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_affiliate_earnings

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns affiliate earnings including fees collected by thorname.

get_affiliate_earnings input schema

{
  "type": "object",
  "additionalProperties": false
}

get_affiliate_earnings annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_affiliate_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical affiliate swap data including volumes and thorname breakdown over time.

get_affiliate_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_affiliate_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_affiliate_stats

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns affiliate statistics including volumes, counts, and fees by thorname.

get_affiliate_stats input schema

{
  "type": "object",
  "additionalProperties": false
}

get_affiliate_stats annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_ban

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the ban status for a node address. Shows if the node is banned, at what block height, and which nodes signed the ban. Bans are used to remove malicious or misbehaving nodes.

get_ban input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The node address to check ban status for (thor1...)"
    }
  },
  "additionalProperties": false
}

get_ban annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_block

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns verbose details of a THORChain block including header info, transactions, and block events. If no height is specified, returns the latest block. Shows block hash, chain ID, height, time, validator info, and all transactions with their results.

get_block input schema

{
  "type": "object",
  "properties": {
    "height": {
      "type": [
        "null",
        "integer"
      ],
      "description": "Optional block height. If not provided returns the latest block."
    }
  },
  "additionalProperties": false
}

get_block annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_bonds

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns bond details for an address including associated nodes and total bonded amount.

get_bonds input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Address to get bond details for"
    }
  },
  "additionalProperties": false
}

get_bonds annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_churns

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns churn event history with dates and block heights.

get_churns input schema

{
  "type": "object",
  "additionalProperties": false
}

get_churns annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_block

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns block data at the specified height including header, transactions, and commit signatures. Provides canonical blockchain data.

get_cometbft_block input schema

{
  "type": "object",
  "properties": {
    "height": {
      "type": "integer",
      "description": "Block height to query. If omitted or 0, returns the latest block."
    }
  },
  "additionalProperties": false
}

get_cometbft_block annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_block_results

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the results of executing transactions in a block, including ABCI events and validator updates. Useful for inspecting transaction outcomes.

get_cometbft_block_results input schema

{
  "type": "object",
  "properties": {
    "height": {
      "type": "integer",
      "description": "Block height to query. If omitted or 0, returns results for the latest block."
    }
  },
  "additionalProperties": false
}

get_cometbft_block_results annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_consensus_params

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns CometBFT consensus parameters (block size, evidence, validator params) at a height.

get_cometbft_consensus_params input schema

{
  "type": "object",
  "properties": {
    "height": {
      "type": "integer",
      "description": "Block height (0 or omitted for latest)"
    }
  },
  "additionalProperties": false
}

get_cometbft_consensus_params annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_consensus_state

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the current consensus round state including height/round/step, proposal block hash, and vote information. Useful for debugging consensus issues.

get_cometbft_consensus_state input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cometbft_consensus_state annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_net_info

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns network information including listening status, connected peers, and peer details. Useful for monitoring P2P network health.

get_cometbft_net_info input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cometbft_net_info annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_status

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the CometBFT node status including node info, sync status, and validator information. Provides canonical consensus-level data about the blockchain.

get_cometbft_status input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cometbft_status annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_tx

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a transaction by its hash including tx result, height, and optional proof of inclusion. Provides canonical transaction data from the consensus layer.

get_cometbft_tx input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "Transaction hash (without 0x prefix)."
    },
    "prove": {
      "type": "boolean",
      "description": "Include proof of transaction inclusion."
    }
  },
  "additionalProperties": false
}

get_cometbft_tx annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cometbft_validators

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the validator set at the specified height including addresses, public keys, and voting power. This is canonical consensus data about who can produce blocks.

get_cometbft_validators input schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number for pagination (1-indexed). Default is 1."
    },
    "height": {
      "type": "integer",
      "description": "Block height to query. If omitted or 0, returns the current validator set."
    },
    "per_page": {
      "type": "integer",
      "description": "Number of validators per page. Default is 30, max is 100."
    }
  },
  "additionalProperties": false
}

get_cometbft_validators annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_constants

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns protocol constants including integer, boolean, and string configuration values that govern THORChain behavior.

get_constants input schema

{
  "type": "object",
  "additionalProperties": false
}

get_constants annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_account

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns account information for a THORChain address including account number, sequence (nonce), and public key if available.

get_cosmos_account input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "THORChain address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_cosmos_account annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_balances

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns account balances for a THORChain address. Shows all coin denominations held by the account.

get_cosmos_balances input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "THORChain address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_cosmos_balances annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_block

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a block at the specified height from the Cosmos SDK blockchain including header, transactions, and commit data.

get_cosmos_block input schema

{
  "type": "object",
  "required": [
    "height"
  ],
  "properties": {
    "height": {
      "type": "integer",
      "description": "Block height to query"
    }
  },
  "additionalProperties": false
}

get_cosmos_block annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_delegations

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all delegations for a delegator address. Shows which validators the address has delegated to and the amounts.

get_cosmos_delegations input schema

{
  "type": "object",
  "required": [
    "delegator_addr"
  ],
  "properties": {
    "delegator_addr": {
      "type": "string",
      "description": "Delegator address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_cosmos_delegations annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_latest_block

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the latest block from the Cosmos SDK blockchain including header, transactions, and commit data.

get_cosmos_latest_block input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cosmos_latest_block annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_node_info

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns Cosmos SDK node information including network, version, protocol versions, and application version. Uses the gRPC-gateway REST API for canonical data.

get_cosmos_node_info input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cosmos_node_info annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_rewards

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns delegation rewards for a delegator address. Shows rewards from each validator and total accumulated rewards.

get_cosmos_rewards input schema

{
  "type": "object",
  "required": [
    "delegator_addr"
  ],
  "properties": {
    "delegator_addr": {
      "type": "string",
      "description": "Delegator address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_cosmos_rewards annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_supply

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the total token supply including all coin denominations. Shows the circulating supply of RUNE and other tokens.

get_cosmos_supply input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cosmos_supply annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_syncing

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns whether the node is currently syncing with the blockchain. A syncing node may have stale data.

get_cosmos_syncing input schema

{
  "type": "object",
  "additionalProperties": false
}

get_cosmos_syncing annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_tx

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a transaction by hash from the Cosmos SDK blockchain. Includes transaction body, auth info, and execution result.

get_cosmos_tx input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "Transaction hash"
    }
  },
  "additionalProperties": false
}

get_cosmos_tx annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_cosmos_validators

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the list of staking validators. Includes operator address, status, tokens, delegator shares, commission rates, and description.

get_cosmos_validators input schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Filter by validator status: BOND_STATUS_BONDED, BOND_STATUS_UNBONDING, or BOND_STATUS_UNBONDED. Leave empty for all."
    }
  },
  "additionalProperties": false
}

get_cosmos_validators annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_depth_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical depth data for a pool including asset depth, RUNE depth, asset price, and liquidity units over time intervals.

get_depth_history input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "asset": {
      "type": "string",
      "description": "Pool asset identifier (e.g. BTC.BTC)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_depth_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_derived_pool

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns one derived (virtual) pool's depths and status.

get_derived_pool input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The derived asset (e.g. THOR.BTC)"
    }
  },
  "additionalProperties": false
}

get_derived_pool annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_dynamic_l1_fees

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns per-THORName dynamic L1 minimum swap-fee floors (ADR-026). Each entry shows the enrolled THORName, trading pair, current dynamic fee floor in basis points, whitelist state (1=Active, 2=Monitor), last active epoch, and latest fee revenue in TOR.

get_dynamic_l1_fees input schema

{
  "type": "object",
  "additionalProperties": false
}

get_dynamic_l1_fees annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_earnings_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical earnings data including liquidity fees, block rewards, and bonding/liquidity earnings over time intervals.

get_earnings_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_earnings_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_holders

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns top RUNE holders with their balances.

get_holders input schema

{
  "type": "object",
  "additionalProperties": false
}

get_holders annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_inbound_addresses

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns vault addresses for depositing assets into THORChain. Each chain has its own inbound address along with gas rates and halted status.

get_inbound_addresses input schema

{
  "type": "object",
  "additionalProperties": false
}

get_inbound_addresses annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_invariant

Advertised by the server during the last successful anonymous check.

Advertised read-only

Runs a specific protocol invariant check and returns the result. Shows whether the invariant is broken and any informative messages about the check. Use this to verify protocol consistency and detect potential issues.

get_invariant input schema

{
  "type": "object",
  "required": [
    "invariant"
  ],
  "properties": {
    "invariant": {
      "type": "string",
      "description": "The invariant name to check (e.g. 'asgard', 'bond', 'pools', 'thorchain')"
    }
  },
  "additionalProperties": false
}

get_invariant annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_keygen

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns keygen information for a specific block height and pubkey. Shows details of the key generation ceremony including the keygen block, member nodes, and signature. Use this to investigate vault creation events.

get_keygen input schema

{
  "type": "object",
  "required": [
    "height",
    "pubkey"
  ],
  "properties": {
    "height": {
      "type": "integer",
      "description": "The block height of the keygen ceremony"
    },
    "pubkey": {
      "type": "string",
      "description": "The pubkey of one of the keygen block members"
    }
  },
  "additionalProperties": false
}

get_keygen annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_keygen_metric

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns keygen timing metrics for a specific vault public key.

get_keygen_metric input schema

{
  "type": "object",
  "required": [
    "pubkey"
  ],
  "properties": {
    "pubkey": {
      "type": "string",
      "description": "The vault public key (thorpub...)"
    }
  },
  "additionalProperties": false
}

get_keygen_metric annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_keysign

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns keysign information for a specific block height. Shows transactions that were scheduled to be signed at that height, including outbound transaction details. Use this to investigate signing operations at a particular block.

get_keysign input schema

{
  "type": "object",
  "required": [
    "height"
  ],
  "properties": {
    "height": {
      "type": "integer",
      "description": "The block height to get keysign information for"
    }
  },
  "additionalProperties": false
}

get_keysign annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_keysign_pubkey

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns keysign information for a specific block height and vault pubkey. Shows transactions signed by a particular vault at that height. Use this to investigate a specific vault's signing activity.

get_keysign_pubkey input schema

{
  "type": "object",
  "required": [
    "height",
    "pubkey"
  ],
  "properties": {
    "height": {
      "type": "integer",
      "description": "The block height to get keysign information for"
    },
    "pubkey": {
      "type": "string",
      "description": "The vault pubkey to filter keysign information"
    }
  },
  "additionalProperties": false
}

get_keysign_pubkey annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_known_pools

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns known pools with their status (available, staged, suspended).

get_known_pools input schema

{
  "type": "object",
  "additionalProperties": false
}

get_known_pools annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_lastblock

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the last observed and signed block heights for all chains. Useful for monitoring chain sync status and detecting chain halts.

get_lastblock input schema

{
  "type": "object",
  "additionalProperties": false
}

get_lastblock annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_lastblock_chain

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the last observed and signed block heights for a specific chain. Useful for monitoring a particular chain's sync status.

get_lastblock_chain input schema

{
  "type": "object",
  "required": [
    "chain"
  ],
  "properties": {
    "chain": {
      "type": "string",
      "description": "The chain to get last block for (e.g. BTC, ETH, THOR)"
    }
  },
  "additionalProperties": false
}

get_lastblock_chain annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_limit_swaps

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the limit swaps queue containing pending limit orders. Each entry includes swap details, ratio, age, and expiry information. Supports filtering by source/target asset, sender, and pagination. Limit orders only work when AdvSwapQueueEnabled is true.

get_limit_swaps input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Number of items to return (default: 100, max: 1000)"
    },
    "offset": {
      "type": "integer",
      "description": "Number of items to skip (default: 0)"
    },
    "sender": {
      "type": "string",
      "description": "Filter by sender address"
    },
    "sort_by": {
      "type": "string",
      "description": "Sort field: ratio, age, amount, or created_height (default: ratio)"
    },
    "sort_order": {
      "type": "string",
      "description": "Sort order: asc or desc (default: asc)"
    },
    "source_asset": {
      "type": "string",
      "description": "Filter by source asset (e.g. BTC.BTC)"
    },
    "target_asset": {
      "type": "string",
      "description": "Filter by target asset (e.g. ETH.ETH)"
    }
  },
  "additionalProperties": false
}

get_limit_swaps annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_limit_swaps_summary

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a summary of the limit swaps queue including total count, total USD value, breakdown by asset pair, oldest swap age, and average age. Useful for getting an overview of pending limit orders without retrieving all individual swaps.

get_limit_swaps_summary input schema

{
  "type": "object",
  "properties": {
    "source_asset": {
      "type": "string",
      "description": "Filter by source asset (e.g. BTC.BTC)"
    },
    "target_asset": {
      "type": "string",
      "description": "Filter by target asset (e.g. ETH.ETH)"
    }
  },
  "additionalProperties": false
}

get_limit_swaps_summary annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_liquidity_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical liquidity change data including add/withdraw counts, volumes, and net liquidity over time intervals.

get_liquidity_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_liquidity_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_lp_position

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns liquidity provider position information for a specific address in a pool. Includes units, pending asset/rune, and last add/withdraw heights.

get_lp_position input schema

{
  "type": "object",
  "required": [
    "asset",
    "address"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The pool asset (e.g. 'BTC.BTC' or 'ETH.ETH')"
    },
    "address": {
      "type": "string",
      "description": "The LP address to lookup"
    }
  },
  "additionalProperties": false
}

get_lp_position annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_members

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns list of all liquidity provider addresses.

get_members input schema

{
  "type": "object",
  "additionalProperties": false
}

get_members annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_midgard_balance

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns balance for an address from Midgard analytics.

get_midgard_balance input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Address to get balance for"
    }
  },
  "additionalProperties": false
}

get_midgard_balance annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_midgard_member

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns liquidity provider positions for an address including pool participation, units, and deposit/withdraw history.

get_midgard_member input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "THORChain address (thor1...) or external chain address"
    }
  },
  "additionalProperties": false
}

get_midgard_member annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_midgard_nodes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns node information including addresses and public keys from Midgard analytics.

get_midgard_nodes input schema

{
  "type": "object",
  "additionalProperties": false
}

get_midgard_nodes annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_midgard_stats

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns global network statistics including swap counts, volumes, liquidity metrics, and RUNE price.

get_midgard_stats input schema

{
  "type": "object",
  "additionalProperties": false
}

get_midgard_stats annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_mimir

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns THORChain protocol configuration parameters (Mimir values). These are key-value pairs that control protocol behavior like fees, limits, and feature flags.

get_mimir input schema

{
  "type": "object",
  "additionalProperties": false
}

get_mimir annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_mimir_admin

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the admin mimir configuration. These are protocol parameters set directly by THORChain admins (the dev team) rather than through node voting. Admin overrides take precedence over node votes.

get_mimir_admin input schema

{
  "type": "object",
  "additionalProperties": false
}

get_mimir_admin annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_mimir_key

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the effective value for a specific mimir key. This shows the final resolved value after considering admin overrides and node voting consensus. Use this to check the current value of any individual protocol parameter.

get_mimir_key input schema

{
  "type": "object",
  "required": [
    "key"
  ],
  "properties": {
    "key": {
      "type": "string",
      "description": "The mimir key to look up (e.g. CHURNINTERVAL, HALTTRADING, etc.)"
    }
  },
  "additionalProperties": false
}

get_mimir_key annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_mimir_node

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the mimir settings voted by a specific node. Shows a map of mimir keys to their voted values for the given node address. Use this to see what protocol parameters a specific node operator is voting for.

get_mimir_node input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The node address to get mimir votes for (thor1...)"
    }
  },
  "additionalProperties": false
}

get_mimir_node annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_network_info

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns THORChain network statistics and health information including bond metrics, pool data, and node counts.

get_network_info input schema

{
  "type": "object",
  "additionalProperties": false
}

get_network_info annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_network_summary

Advertised by the server during the last successful anonymous check.

Advertised read-only

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, which returns large per-node bond arrays.

get_network_summary input schema

{
  "type": "object",
  "additionalProperties": false
}

get_network_summary annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_node

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns detailed information for a specific validator node including bond, status, version, and performance metrics. Bond providers include their Bond Yield configuration (bps share of rewards paid out automatically and its payout_target) when one is set.

get_node input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The node address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_node annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_oracle_price

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the oracle price for a specific asset symbol. The price is returned in USD and is used for protocol calculations and limit order pricing.

get_oracle_price input schema

{
  "type": "object",
  "required": [
    "symbol"
  ],
  "properties": {
    "symbol": {
      "type": "string",
      "description": "The asset symbol to get the price for (e.g. BTC, ETH, RUNE)"
    }
  },
  "additionalProperties": false
}

get_oracle_price annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_oracle_prices

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all oracle prices for supported assets. Oracle prices are used for determining asset values in the protocol and for pricing limit orders. Returns an array of price objects containing symbol (e.g., BTC, ETH) and price in USD.

get_oracle_prices input schema

{
  "type": "object",
  "additionalProperties": false
}

get_oracle_prices annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_outbound_fee_asset

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns outbound fee information for a specific asset including the fee amount, surplus/deficit tracking, and dynamic multiplier.

get_outbound_fee_asset input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The asset to get outbound fee for (e.g. BTC.BTC)"
    }
  },
  "additionalProperties": false
}

get_outbound_fee_asset annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_outbound_fees

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns outbound fee information for all assets including the fee amount, surplus/deficit tracking, and dynamic multiplier. Use this to estimate transaction costs.

get_outbound_fees input schema

{
  "type": "object",
  "additionalProperties": false
}

get_outbound_fees annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_outbound_queue

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the outbound queue containing signed transactions waiting to be broadcast to external chains. Each entry includes the destination chain, address, coin amount, and gas information. These transactions have been signed and are awaiting confirmation.

get_outbound_queue input schema

{
  "type": "object",
  "additionalProperties": false
}

get_outbound_queue annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_pool

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns detailed information for a specific liquidity pool by asset identifier.

get_pool input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The asset identifier (e.g. BTC.BTC or ETH.ETH)"
    }
  },
  "additionalProperties": false
}

get_pool annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_pool_slip

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns slip data for one pool, including current slip and rollup statistics.

get_pool_slip input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The pool asset (e.g. BTC.BTC)"
    }
  },
  "additionalProperties": false
}

get_pool_slip annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_pool_stats

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns detailed analytics and statistics for a specific liquidity pool including volume, fees, APY, and historical metrics.

get_pool_stats input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The asset identifier (e.g. BTC.BTC or ETH.ETH)"
    }
  },
  "additionalProperties": false
}

get_pool_stats annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_queue

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns queue statistics including pending swap count, outbound transaction count, internal queue size, and scheduled outbound value. Use this to understand network congestion.

get_queue input schema

{
  "type": "object",
  "additionalProperties": false
}

get_queue annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_ragnarok

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns whether the chain is in Ragnarok (emergency shutdown mode). Ragnarok is triggered when the network needs to return all funds to users. A true value indicates the network is shutting down.

get_ragnarok input schema

{
  "type": "object",
  "additionalProperties": false
}

get_ragnarok annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_reference_memo

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the memoless transaction memo for a given asset and reference number. Memoless transactions use the amount to encode the reference which maps to a pre-registered memo.

get_reference_memo input schema

{
  "type": "object",
  "required": [
    "asset",
    "reference"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The asset (e.g. BTC.BTC)"
    },
    "reference": {
      "type": "string",
      "description": "The reference number"
    }
  },
  "additionalProperties": false
}

get_reference_memo annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_reference_memo_by_hash

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the memoless transaction memo for a given reference hash. Use this to look up the registered memo for a memoless transaction.

get_reference_memo_by_hash input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "The transaction hash"
    }
  },
  "additionalProperties": false
}

get_reference_memo_by_hash annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_rune_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical RUNE data including price over time intervals.

get_rune_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_rune_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_rune_pool

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the RUNEPool state: protocol-owned liquidity, provider shares, reserve position, deposit limits, and pending deposits/withdrawals.

get_rune_pool input schema

{
  "type": "object",
  "additionalProperties": false
}

get_rune_pool annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_rune_price_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical RUNE price data in USD over time intervals.

get_rune_price_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_rune_price_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_rune_provider

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns one RUNEPool provider's position: deposited RUNE, units, and PnL.

get_rune_provider input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The provider's THORChain address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_rune_provider annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_runepool_member

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns Midgard's analytics view of a RUNEPool member: deposit/withdraw history and current units.

get_runepool_member input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The member's THORChain address (thor1...)"
    }
  },
  "additionalProperties": false
}

get_runepool_member annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_scheduled_queue

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the scheduled outbound queue containing transactions waiting to be signed and broadcast. Each entry includes the destination chain, address, coin amount, gas rate, and associated memo. Transactions are scheduled based on outbound delay.

get_scheduled_queue input schema

{
  "type": "object",
  "additionalProperties": false
}

get_scheduled_queue annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_stable_reserve

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the Stable Reserve module status: RUNE balance, depeg tolerance, POL share, per-asset inventory with health flags and oracle prices, and active deployment swaps. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.

get_stable_reserve input schema

{
  "type": "object",
  "additionalProperties": false
}

get_stable_reserve annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_stable_reserve_contributor

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a contributor's Stable Reserve credit for a given stable asset and address. Requires THORNode v3.20+; earlier networks answer 501 Not Implemented.

get_stable_reserve_contributor input schema

{
  "type": "object",
  "required": [
    "asset",
    "address"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The stable asset (e.g. ETH.USDC-0XA0B8...)"
    },
    "address": {
      "type": "string",
      "description": "The contributor's L1 address"
    }
  },
  "additionalProperties": false
}

get_stable_reserve_contributor annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_streaming_swap

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns details of a specific streaming swap by transaction hash, including progress (count/quantity), amounts swapped (in/out), and any failed sub-swaps.

get_streaming_swap input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "The inbound transaction hash of the streaming swap"
    }
  },
  "additionalProperties": false
}

get_streaming_swap annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_swap_details

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns detailed information about a specific swap including its current state. Shows the full swap message with source/target assets, amounts, destination, affiliate info, and the swap's status and queue type. Use this to track the progress of a specific swap transaction.

get_swap_details input schema

{
  "type": "object",
  "required": [
    "tx_id"
  ],
  "properties": {
    "tx_id": {
      "type": "string",
      "description": "The transaction ID of the swap to look up"
    }
  },
  "additionalProperties": false
}

get_swap_details annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_swap_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical swap data including swap counts, volumes, fees, and average slip over time intervals.

get_swap_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_swap_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_swap_queue

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the current swap queue containing pending swaps waiting to be executed. Each entry includes source/target assets, amounts, destination addresses, and swap state. Use this to monitor swap processing and identify stuck transactions.

get_swap_queue input schema

{
  "type": "object",
  "additionalProperties": false
}

get_swap_queue annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_swapper_clout

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns an address's swapper clout: accumulated fee-based score that reduces outbound delays for trusted swappers.

get_swapper_clout input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The swapper's address (any chain)"
    }
  },
  "additionalProperties": false
}

get_swapper_clout annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tcy_claimer

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns TCY (ThorCoin Yeet) claimer information for a specific address. Takes the claimer's L1 address (e.g. 0x..., bc1..., ltc1...) as listed by list_tcy_claimers and returns the claims (one per asset). Use this to check an individual's TCY claims.

get_tcy_claimer input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The THORChain address to get TCY claimer info for (thor1...)"
    }
  },
  "additionalProperties": false
}

get_tcy_claimer annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tcy_distribution

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns TCY distribution for an address.

get_tcy_distribution input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Address to get TCY distribution for"
    }
  },
  "additionalProperties": false
}

get_tcy_distribution annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tcy_staker

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns TCY (ThorCoin Yeet) staker information for a specific address. Shows the staked amount for the given THORChain address. Use this to check an individual's TCY staking position.

get_tcy_staker input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The THORChain address to get TCY staker info for (thor1...)"
    }
  },
  "additionalProperties": false
}

get_tcy_staker annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_thorname

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns THORName registration information including owner, expiry, and registered chain addresses. THORNames are human-readable aliases for blockchain addresses.

get_thorname input schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The THORName to lookup (e.g. 't' or 'thorswap')"
    }
  },
  "additionalProperties": false
}

get_thorname annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_thorname_owner

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns THORNames owned by an address.

get_thorname_owner input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Owner address to get THORNames for"
    }
  },
  "additionalProperties": false
}

get_thorname_owner annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_trade_account

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all trade account positions for a specific address. Each account includes the asset, units, owner, and last activity heights.

get_trade_account input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "The address to lookup trade accounts for"
    }
  },
  "additionalProperties": false
}

get_trade_account annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_trade_unit

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns trade unit information for a specific asset. Trade units represent the total units and depth of a trade asset pool.

get_trade_unit input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The trade asset to lookup (e.g. 'BTC~BTC' or 'ETH~ETH')"
    }
  },
  "additionalProperties": false
}

get_trade_unit annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tss_metrics

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns TSS keygen and keysign timing metrics across the validator set.

get_tss_metrics input schema

{
  "type": "object",
  "additionalProperties": false
}

get_tss_metrics annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tvl_history

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns historical Total Value Locked (TVL) data including pooled value, bonded value, and total locked value over time intervals.

get_tvl_history input schema

{
  "type": "object",
  "properties": {
    "to": {
      "type": "integer",
      "description": "End timestamp (Unix seconds)"
    },
    "from": {
      "type": "integer",
      "description": "Start timestamp (Unix seconds)"
    },
    "count": {
      "type": "integer",
      "description": "Number of intervals to return"
    },
    "interval": {
      "type": "string",
      "description": "Time interval: 5min hour day week month quarter year"
    }
  },
  "additionalProperties": false
}

get_tvl_history annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tx

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns transaction details for a given hash including observed transaction data, status, and processing stages.

get_tx input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "The transaction hash (inbound or outbound)"
    }
  },
  "additionalProperties": false
}

get_tx annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tx_details

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns comprehensive transaction details including observed transactions, actions taken, outbound transactions, consensus and finalized heights, and whether the vault was updated or the transaction reverted. Use this for deep transaction analysis.

get_tx_details input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "The transaction hash (inbound or outbound) to get detailed information for"
    }
  },
  "additionalProperties": false
}

get_tx_details annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tx_stages

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns detailed processing stages of an inbound transaction including observation counts, confirmation status, swap status (with streaming progress if applicable), outbound delay, and signing status.

get_tx_stages input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "The inbound transaction hash to check processing stages for"
    }
  },
  "additionalProperties": false
}

get_tx_stages annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_tx_status

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns comprehensive transaction status including processing stages, planned outbound transactions, and completed outbound transactions. Use this to track swap progress.

get_tx_status input schema

{
  "type": "object",
  "required": [
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "description": "The inbound transaction hash to check status for"
    }
  },
  "additionalProperties": false
}

get_tx_status annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_upgrade_proposal

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a specific upgrade proposal by name including target block height and upgrade information.

get_upgrade_proposal input schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The upgrade proposal name (e.g. 'v3.137.0')"
    }
  },
  "additionalProperties": false
}

get_upgrade_proposal annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_upgrade_votes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all node votes for a specific upgrade proposal. Each vote shows the node address and whether they approved. Use this to track upgrade consensus.

get_upgrade_votes input schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The upgrade proposal name to get votes for (e.g. 'v3.137.0')"
    }
  },
  "additionalProperties": false
}

get_upgrade_votes annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_vault

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns a specific vault by its public key including coin balances, status, membership, routers, and chain addresses.

get_vault input schema

{
  "type": "object",
  "required": [
    "pubkey"
  ],
  "properties": {
    "pubkey": {
      "type": "string",
      "description": "The vault public key (thorpub1...)"
    }
  },
  "additionalProperties": false
}

get_vault annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_vault_pubkeys

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all vault public keys organized by type: Asgard (active network vaults), Yggdrasil (node vaults), and inactive vaults. Includes router addresses and membership information.

get_vault_pubkeys input schema

{
  "type": "object",
  "additionalProperties": false
}

get_vault_pubkeys annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_vault_solvency

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns aggregate vault solvency showing over-solvent or under-solvent amounts per asset. Positive amounts indicate over-solvency (more assets than expected), negative amounts indicate under-solvency. Critical for monitoring vault health.

get_vault_solvency input schema

{
  "type": "object",
  "additionalProperties": false
}

get_vault_solvency annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_version

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns network version information including current version, next required version for nodes, and the querier version.

get_version input schema

{
  "type": "object",
  "additionalProperties": false
}

get_version annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

get_votes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns governance votes including parameter proposals and node votes.

get_votes input schema

{
  "type": "object",
  "additionalProperties": false
}

get_votes annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_asgard_vaults

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns current Asgard vaults with their pubkeys, coin balances, status, membership, and chain addresses. Asgard vaults are the main network vaults that hold user funds. Supports pagination with limit and offset parameters.

list_asgard_vaults input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return (default 100, max 1000)"
    },
    "offset": {
      "type": "integer",
      "description": "Number of results to skip for pagination"
    }
  },
  "additionalProperties": false
}

list_asgard_vaults annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_derived_pools

Advertised by the server during the last successful anonymous check.

Advertised read-only

Lists all derived (virtual) pools with their depths and status.

list_derived_pools input schema

{
  "type": "object",
  "additionalProperties": false
}

list_derived_pools annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_invariants

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns the list of available protocol invariants that can be checked. Invariants are consistency checks that verify the protocol's internal state is valid. Common invariants include 'asgard', 'bond', 'pools', 'thorchain', etc.

list_invariants input schema

{
  "type": "object",
  "additionalProperties": false
}

list_invariants annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_liquidity_providers

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all liquidity providers for a specific pool. Each entry includes the LP's units, pending amounts, deposit values, and addresses. Use this to analyze pool participation.

list_liquidity_providers input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The pool asset (e.g. 'BTC.BTC' or 'ETH.ETH')"
    }
  },
  "additionalProperties": false
}

list_liquidity_providers annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_mimir_node_votes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all node operator votes on mimir settings. Each vote shows the mimir key, the voted value, and the node address that cast the vote. Use this to track node consensus on protocol parameter changes.

list_mimir_node_votes input schema

{
  "type": "object",
  "additionalProperties": false
}

list_mimir_node_votes annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_nodes

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all registered validator nodes with their status, bond amounts, and operational information. Each bond provider may carry a Bond Yield configuration (bps share of rewards paid out automatically and its payout_target); the fields are absent on nodes without one. Supports pagination with limit and offset parameters.

list_nodes input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return (default 100, max 1000)"
    },
    "offset": {
      "type": "integer",
      "description": "Number of results to skip for pagination"
    }
  },
  "additionalProperties": false
}

list_nodes annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_pool_slips

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns pool slip information for all Layer 1 pools. Pool slip measures trading activity and depth pressure. Shows current slip, rollup counts, and long-term rollup medians used for fee calculations and pool health monitoring.

list_pool_slips input schema

{
  "type": "object",
  "additionalProperties": false
}

list_pool_slips annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_pools

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all active liquidity pools on THORChain with their balances, units, and status. Supports pagination with limit and offset parameters.

list_pools input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return (default 100, max 1000)"
    },
    "offset": {
      "type": "integer",
      "description": "Number of results to skip for pagination"
    }
  },
  "additionalProperties": false
}

list_pools annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_rune_providers

Advertised by the server during the last successful anonymous check.

Advertised read-only

Lists all RUNEPool providers with their deposited RUNE and units.

list_rune_providers input schema

{
  "type": "object",
  "additionalProperties": false
}

list_rune_providers annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_streaming_swaps

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all active streaming swaps. Streaming swaps split large trades into smaller chunks executed over multiple blocks to minimize slippage. Supports pagination with limit and offset parameters.

list_streaming_swaps input schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return (default 100, max 1000)"
    },
    "offset": {
      "type": "integer",
      "description": "Number of results to skip for pagination"
    }
  },
  "additionalProperties": false
}

list_streaming_swaps annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_tcy_claimers

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all TCY (ThorCoin Yeet) claimers. Shows summary information for all addresses that have claimed in the TCY program.

list_tcy_claimers input schema

{
  "type": "object",
  "additionalProperties": false
}

list_tcy_claimers annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_tcy_stakers

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all TCY (ThorCoin Yeet) stakers. Shows summary information for all addresses that have staked in the TCY program.

list_tcy_stakers input schema

{
  "type": "object",
  "additionalProperties": false
}

list_tcy_stakers annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_trade_accounts

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all trade accounts for a specific trade asset. Each account includes the asset, units, owner address, and activity history.

list_trade_accounts input schema

{
  "type": "object",
  "required": [
    "asset"
  ],
  "properties": {
    "asset": {
      "type": "string",
      "description": "The trade asset to list accounts for (e.g. 'BTC~BTC' or 'ETH~ETH')"
    }
  },
  "additionalProperties": false
}

list_trade_accounts annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_trade_units

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all trade units across all trade assets. Each unit includes the asset, total units, and depth.

list_trade_units input schema

{
  "type": "object",
  "additionalProperties": false
}

list_trade_units annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

list_upgrade_proposals

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns all pending network upgrade proposals. Each proposal includes the upgrade name, target block height, and upgrade info. Use this to monitor upcoming network changes.

list_upgrade_proposals input schema

{
  "type": "object",
  "additionalProperties": false
}

list_upgrade_proposals annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

lookup_thorname

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns THORName details including chain addresses, expiry, and owner.

lookup_thorname input schema

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "THORName to look up"
    }
  },
  "additionalProperties": false
}

lookup_thorname annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

ping

Advertised by the server during the last successful anonymous check.

Advertised read-only

Health check endpoint. Returns 'pong' if the THORNode is responding. Use this to verify connectivity to the node.

ping input schema

{
  "type": "object",
  "additionalProperties": false
}

ping annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

prepare_swap

Advertised by the server during the last successful anonymous check.

Advertised read-only

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.

prepare_swap input schema

{
  "type": "object",
  "required": [
    "from_asset",
    "to_asset",
    "amount",
    "destination"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "Amount to swap in THORChain base units (1e8; e.g. 50000000 = 0.5 BTC)"
    },
    "to_asset": {
      "type": "string",
      "description": "The target asset to swap to (e.g. ETH.ETH)"
    },
    "affiliate": {
      "type": "string",
      "description": "Optional affiliate address or THORName that collects a fee"
    },
    "from_asset": {
      "type": "string",
      "description": "The source asset to swap from (e.g. BTC.BTC)"
    },
    "destination": {
      "type": "string",
      "description": "The address on the destination chain that will receive the swap output. Required to execute a swap."
    },
    "affiliate_bps": {
      "type": "integer",
      "description": "Optional affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)"
    },
    "max_slippage_bps": {
      "type": "integer",
      "description": "Maximum acceptable slippage in basis points; sets the min-received limit baked into the memo (default 300 = 3%). Range 1-10000."
    }
  },
  "additionalProperties": false
}

prepare_swap annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

quote_limit

Advertised by the server during the last successful anonymous check.

Advertised read-only

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.

quote_limit input schema

{
  "type": "object",
  "required": [
    "from_asset",
    "to_asset",
    "amount",
    "target_out"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "The amount in base units (1e8 for most assets)"
    },
    "to_asset": {
      "type": "string",
      "description": "The target asset (e.g. ETH.ETH)"
    },
    "affiliate": {
      "type": "string",
      "description": "The affiliate address or THORName"
    },
    "custom_ttl": {
      "type": "integer",
      "description": "Custom TTL in blocks for the limit order"
    },
    "from_asset": {
      "type": "string",
      "description": "The source asset (e.g. BTC.BTC)"
    },
    "target_out": {
      "type": "integer",
      "description": "The limit price: minimum acceptable output amount in base units (1e8). The order executes only at this price or better"
    },
    "destination": {
      "type": "string",
      "description": "The destination address for the swap output"
    },
    "affiliate_bps": {
      "type": "integer",
      "description": "The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)"
    },
    "refund_address": {
      "type": "string",
      "description": "The refund address if the swap fails"
    },
    "streaming_quantity": {
      "type": "integer",
      "description": "Number of sub-swaps for streaming"
    }
  },
  "additionalProperties": false
}

quote_limit annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

quote_swap

Advertised by the server during the last successful anonymous check.

Advertised read-only

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.

quote_swap input schema

{
  "type": "object",
  "required": [
    "from_asset",
    "to_asset",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "integer",
      "description": "The amount in base units (1e8 for most assets)"
    },
    "to_asset": {
      "type": "string",
      "description": "The target asset (e.g. ETH.ETH)"
    },
    "affiliate": {
      "type": "string",
      "description": "The affiliate address or THORName"
    },
    "from_asset": {
      "type": "string",
      "description": "The source asset (e.g. BTC.BTC)"
    },
    "destination": {
      "type": "string",
      "description": "The destination address for the swap output"
    },
    "affiliate_bps": {
      "type": "integer",
      "description": "The affiliate fee in basis points (0-1000; protocol caps total affiliate fees at 1000 bps)"
    }
  },
  "additionalProperties": false
}

quote_swap annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

reverse_lookup_thorname

Advertised by the server during the last successful anonymous check.

Advertised read-only

Returns THORNames associated with an address.

reverse_lookup_thorname input schema

{
  "type": "object",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "Address to look up THORNames for"
    }
  },
  "additionalProperties": false
}

reverse_lookup_thorname annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

search_cometbft_tx

Advertised by the server during the last successful anonymous check.

Advertised read-only

Searches for transactions matching the query. Supports queries like 'tx.height=1000', 'message.action="send"', or composite queries. Returns matching transactions with optional proofs.

search_cometbft_tx input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number (1-indexed). Default is 1."
    },
    "prove": {
      "type": "boolean",
      "description": "Include proof for each transaction."
    },
    "query": {
      "type": "string",
      "description": "Search query (e.g. tx.height=1000 or message.action='send')."
    },
    "order_by": {
      "type": "string",
      "description": "Result ordering: 'asc' or 'desc'. Default is 'asc'."
    },
    "per_page": {
      "type": "integer",
      "description": "Results per page. Default is 30, max is 100."
    }
  },
  "additionalProperties": false
}

search_cometbft_tx annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

search_cosmos_txs

Advertised by the server during the last successful anonymous check.

Advertised read-only

Searches for transactions matching the query events. Supports filtering by message type, sender, recipient, and other event attributes.

search_cosmos_txs input schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "description": "Page number (1-indexed). Default is 1."
    },
    "limit": {
      "type": "integer",
      "description": "Results per page. Default is 100."
    },
    "events": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "Query events to filter transactions (e.g. message.action='send'). Multiple events are ANDed."
    },
    "order_by": {
      "type": "string",
      "description": "Result ordering: ORDER_BY_ASC or ORDER_BY_DESC. Default is ORDER_BY_ASC."
    }
  },
  "additionalProperties": false
}

search_cosmos_txs annotations

{
  "readOnlyHint": true,
  "idempotentHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 844 ms
95th percentile latency: 844 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 4:53 PM UTC · probe · passed · 844 ms · metadata changed · 126 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http thorchain-mcp https://mcp.thorchain.org/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add thorchain-mcp --url https://mcp.thorchain.org/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable thorchain-mcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "thorchain-mcp": {
      "url": "https://mcp.thorchain.org/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "thorchain-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.thorchain.org/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start thorchain-mcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "thorchain-mcp": {
      "type": "http",
      "url": "https://mcp.thorchain.org/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http thorchain-mcp https://mcp.thorchain.org/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "thorchain-mcp": {
      "url": "https://mcp.thorchain.org/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "thorchain-mcp": {
      "serverUrl": "https://mcp.thorchain.org/mcp"
    }
  }
}

Let your agent find its tools

Find servers like THORChain MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 4,340

Do you run THORChain MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing

THORChain MCP

Endpoint and access

What you can do with it

Source and maintenance

Protocol and capabilities

Server-provided instructions

Tools

Prompts

Resources

30-day availability

Maintenance history

Connect from your client

Claude Code

Codex

Cursor

Cline

VS Code

Gemini CLI

Claude Desktop

Windsurf

Let your agent find its tools

Other ai and machine learning servers

Do you run THORChain MCP?