MCP tool · read 2 credits

midgard_actions_get

Proxy GET /v2/actions on Midgard. Filter by address, txid, asset, or type. Pass-through response — see Midgard v2 docs for the full schema. Pagination via offset+limit.

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_actions_get",
    "arguments": {
      "address": "<address>",
      "txid": "<txid>",
      "asset": "<asset>",
      "type": "swap",
      "limit": 1,
      "offset": 0
    }
  }
}

Arguments

Name Type Required Description
address string optional THORChain address to filter by.
txid string optional Inbound or outbound tx hash.
asset string optional Asset identifier, e.g. "BTC.BTC".
type string
enum: "swap", "addLiquidity", "withdraw", "donate", "refund", "switch"
optional Action type filter.
limit integer optional Page size (max 50).
offset integer optional Pagination offset.

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 last 20 actions for THORChain address thor1abc...xyz.
Show me every swap that touched BTC.BTC in the last 50 transactions.
Look up the THORChain action with txid ABCDEF1234567890... on Midgard.
List the most recent withdraw actions across THORChain.

Example response

Illustrative shape — actual values vary.

response shape
{
  "actions": [
    {
      "date": "1714780800000000000",
      "height": "19543210",
      "status": "success",
      "type": "swap",
      "in": [
        {
          "address": "thor1abc...xyz",
          "coins": [
            {
              "asset": "BTC.BTC",
              "amount": "50000000"
            }
          ]
        }
      ],
      "out": [
        {
          "address": "thor1abc...xyz",
          "coins": [
            {
              "asset": "THOR.RUNE",
              "amount": "12000000000"
            }
          ]
        }
      ]
    }
  ],
  "count": "1"
}

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