midgard_balance_get · MCP API Docs

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": "midgard_balance_get",
    "arguments": {
      "address": "<address>"
    }
  }
}

Arguments

Name	Type	Required	Description
`address`	string	required	Bech32 or chain-specific address to look up.

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 balances does the THORChain address thor1abc...xyz hold?

Look up the cross-chain balance of bc1q...xyz on Midgard.

Get the Midgard balance breakdown for 0xabc...123.

Example response

Illustrative shape — actual values vary.

response shape

{
  "address": "thor1abc...xyz",
  "height": "19543210",
  "coins": [
    {
      "asset": "THOR.RUNE",
      "amount": "12000000000"
    },
    {
      "asset": "BTC.BTC",
      "amount": "50000000"
    }
  ]
}

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).