MCP tool · read 2 credits

thornode_pool_get

Fetch live THORNode pool state by asset. Pass-through of GET /thorchain/pool/{asset}. For the cached/decorated DB version see thorchain_pool_get.

JSON-RPC call

Paste this body into your MCP client's `tools/call` request. The `id` field is the JSON-RPC message correlator (caller-chosen, not a record identifier — set it to anything; the server echoes it back).

tools/call body
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "thornode_pool_get",
    "arguments": {
      "asset": "<asset>"
    }
  }
}

Arguments

Name Type Required Description
asset string required Pool asset, e.g. "BTC.BTC".

Copy-paste prompt samples

Drop one of these into Claude Code, n8n, or any MCP client. Your AI agent should pick this tool to answer.

What is the live BTC.BTC pool state on THORNode?
Get THORNode pool details for THOR.RUNE — depths, status, LP units.
Show me the current ETH.ETH pool exactly as the chain reports it.

Example response

Illustrative shape — actual values vary.

response shape
{
  "asset": "BTC.BTC",
  "short_code": "b",
  "status": "Available",
  "decimals": 8,
  "pending_inbound_asset": "0",
  "pending_inbound_rune": "0",
  "balance_asset": "4521.23456789",
  "balance_rune": "987654.12345678",
  "pool_units": "12345678901234",
  "LP_units": "12345678901234",
  "synth_units": "0",
  "synth_supply": "0",
  "loan_collateral": "0",
  "asset_tor_price": "10234567000000",
  "synth_mint_paused": false
}

Possible errors

VALIDATION
Returned when the arguments fail the typed schema.
NOT_FOUND
Returned when the requested resource does not exist in our DB.
RATE_LIMIT
Returned when your token's credit budget is exhausted.
UPSTREAM
Returned when the upstream HTTP call fails (relayer tools only).