MCP tool ·
write
2 credits
thornode_bank_balances
Fetch a THORChain address bank balances. Pass-through of GET /bank/balances/{address} on the configured THORNode.
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_bank_balances",
"arguments": {
"address": "<address>"
}
}
}Arguments
| Name | Type | Required | Description |
|---|---|---|---|
address
|
string | required | THORChain address (thor1...). |
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.
Get the bank balances for THORChain address thor1abc...xyz.
How much RUNE does thor1...xyz hold according to THORNode?
Show me the live bank module balances for my THORChain wallet.
Example response
Illustrative shape — actual values vary.
response shape
{
"result": [
{
"denom": "rune",
"amount": "12000000000"
},
{
"denom": "x/ruji",
"amount": "500000000"
}
]
}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).