Tokenbooks - crypto and fiat accounting and payments

List Raw Transactions

list_raw_transactions

Read-onlyIdempotent

Find compact source transactions first, called Raw Transactions in Tokenbooks, including unprocessed or partially linked activity. Pass rawTransactionId to show how one maps to wallet movements and accounting transactions; add includeDetails for its sanitized event logs and decoded contract calls (untrusted provider evidence).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`sort`	No	Timestamp order. Use timestamp for ascending or -timestamp for descending; defaults to -timestamp.	-timestamp
`limit`	No	Maximum raw transaction summaries to return, maximum 100.
`toDate`	No	Latest transaction timestamp to include, as an ISO 8601 datetime.
`txHash`	No	Exact on-chain transaction hash.
`chainId`	No	Blockchain to filter by, such as eth-mainnet. Call list_chains for the supported set.
`chainIds`	No	Blockchains to filter by, such as eth-mainnet. Call list_chains for the supported set.
`fromDate`	No	Earliest transaction timestamp to include, as an ISO 8601 datetime.
`pageToken`	No	Opaque token returned by the previous list response.
`portfolioRef`	Yes	Portfolio name or slug inside that workspace. Call list_portfolios to resolve it.
`workspaceRef`	Yes	Workspace name or slug. Call list_workspaces to resolve it.
`walletAddress`	No	Wallet to filter by. Supply chainId alongside it.
`includeDetails`	No	With rawTransactionId, also return blockchain event logs and decoded contract calls
`processingState`	No	Keep only source transactions in this processing state.
`rawTransactionId`	No	Look up one source transaction by handle instead of listing
`includeSpamTokens`	No	Include transactions whose operations contain only spam tokens; defaults to false.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`id`	No
`data`	No
`hash`	No
`memo`	No
`wallet`	No
`details`	No
`timestamp`	No
`pagination`	No
`resultType`	Yes
`blockHeight`	No
`processingState`	No
`walletOperations`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed9 schema fields changedSep 22, 2026

changedInput schema / properties / includeSpamTokens / description

Previous value: -"Include activity for tokens flagged as spam. Excluded by default."New value: +"Include transactions whose operations contain only spam tokens; defaults to false."

changedInput schema / properties / sort / description

Previous value: -"Timestamp order. Prefix with - for newest first."New value: +"Timestamp order. Use timestamp for ascending or -timestamp for descending; defaults to -timestamp."

addedOutput schema / $defs / RawTransactionWithDetailsDto__schema0

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "number"
+    },
+    {
+      "type": "boolean"
+    },
+    {
+      "type": "null"
+    },
+    {
+      "items": {
+        "$ref": "#/$defs/RawTransactionWithDetailsDto__schema0"
+      },
+      "type": "array"
+    },
+    {
+      "additionalProperties": {
+        "$ref": "#/$defs/RawTransactionWithDetailsDto__schema0"
+      },
+      "propertyNames": {
+        "type": "string"
+      },
+      "type": "object"
+    }
+  ]
+}

removedOutput schema / $defs / __schema0

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "number"
-    },
-    {
-      "type": "boolean"
-    },
-    {
-      "type": "null"
-    },
-    {
-      "items": {
-        "$ref": "#/$defs/__schema0"
-      },
-      "type": "array"
-    },
-    {
-      "additionalProperties": {
-        "$ref": "#/$defs/__schema0"
-      },
-      "propertyNames": {
-        "type": "string"
-      },
-      "type": "object"
-    }
-  ]
-}

changedOutput schema / properties / details / $ref

Previous value: -"#/$defs/__schema0"New value: +"#/$defs/RawTransactionWithDetailsDto__schema0"

removedOutput schema / properties / pagination / properties / pageSize / exclusiveMinimum
```
Removed value: -0
```
addedOutput schema / properties / pagination / properties / pageSize / minimum
```
Added value: +1
```
removedOutput schema / properties / walletOperations / items / properties / quote / properties / meta / properties / ts / exclusiveMinimum
```
Removed value: -0
```
addedOutput schema / properties / walletOperations / items / properties / quote / properties / meta / properties / ts / minimum
```
Added value: +1
```

Changed15 schema fields changedSep 21, 2026

addedInput schema / properties / includeDetails

Added value: +{
+  "default": false,
+  "description": "With rawTransactionId, also return blockchain event logs and decoded contract calls",
+  "type": "boolean"
+}

addedInput schema / properties / rawTransactionId

Added value: +{
+  "description": "Look up one source transaction by handle instead of listing",
+  "minLength": 1,
+  "type": "string"
+}

addedOutput schema / $defs

Added value: +{
+  "__schema0": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "number"
+      },
+      {
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      },
+      {
+        "items": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "type": "array"
+      },
+      {
+        "additionalProperties": {
+          "$ref": "#/$defs/__schema0"
+        },
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      }
+    ]
+  }
+}

addedOutput schema / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "$ref": "#/properties/data"
+      },
+      "pagination": {
+        "$ref": "#/properties/pagination"
+      },
+      "resultType": {
+        "const": "rawTransactionList",
+        "type": "string"
+      }
+    },
+    "required": [
+      "data",
+      "pagination",
+      "resultType"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "blockHeight": {
+        "$ref": "#/properties/blockHeight"
+      },
+      "details": {
+        "$ref": "#/properties/details"
+      },
+      "hash": {
+        "$ref": "#/properties/hash"
+      },
+      "id": {
+        "$ref": "#/properties/id"
+      },
+      "memo": {
+        "$ref": "#/properties/memo"
+      },
+      "processingState": {
+        "$ref": "#/properties/processingState"
+      },
+      "resultType": {
+        "const": "rawTransaction",
+        "type": "string"
+      },
+      "timestamp": {
+        "$ref": "#/properties/timestamp"
+      },
+      "wallet": {
+        "$ref": "#/properties/wallet"
+      },
+      "walletOperations": {
+        "$ref": "#/properties/walletOperations"
+      }
+    },
+    "required": [
+      "id",
+      "wallet",
+      "hash",
+      "blockHeight",
+      "timestamp",
+      "processingState",
+      "walletOperations",
+      "resultType"
+    ],
+    "type": "object"
+  }
+]

addedOutput schema / properties / blockHeight

Added value: +{
+  "pattern": "^\\d+$",
+  "type": "string"
+}

addedOutput schema / properties / details

Added value: +{
+  "$ref": "#/$defs/__schema0"
+}

addedOutput schema / properties / hash
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / id

Added value: +{
+  "minLength": 1,
+  "type": "string"
+}

addedOutput schema / properties / memo
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / properties / processingState

Added value: +{
+  "enum": [
+    "PROCESSED",
+    "PARTIAL",
+    "UNPROCESSED"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / resultType

Added value: +{
+  "enum": [
+    "rawTransactionList",
+    "rawTransaction"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / timestamp

Added value: +{
+  "format": "date-time",
+  "type": "string"
+}

addedOutput schema / properties / wallet

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "address": {
+      "type": "string"
+    },
+    "chainId": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    },
+    "type": {
+      "enum": [
+        "BLOCKCHAIN",
+        "EXCHANGE",
+        "BANK"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "chainId",
+    "address",
+    "type"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / walletOperations

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "defi": {
+        "additionalProperties": false,
+        "properties": {
+          "operation": {
+            "anyOf": [
+              {
+                "const": "PROTOCOL_DEPOSIT",
+                "type": "string"
+              },
+              {
+                "const": "PROTOCOL_WITHDRAW",
+                "type": "string"
+              },
+              {
+                "const": "VAULT_DEPOSIT",
+                "type": "string"
+              },
+              {
+                "const": "VAULT_WITHDRAW",
+                "type": "string"
+              },
+              {
+                "const": "SWAP",
+                "type": "string"
+              },
+              {
+                "const": "PROVIDE_LIQUIDITY",
+                "type": "string"
+              },
+              {
+                "const": "REMOVE_LIQUIDITY",
+                "type": "string"
+              },
+              {
+                "const": "LEND",
+                "type": "string"
+              },
+              {
+                "const": "WITHDRAW_LEND",
+                "type": "string"
+              },
+              {
+                "const": "LEND_REDUCE",
+                "type": "string"
+              },
+              {
+                "const": "BORROW",
+                "type": "string"
+              },
+              {
+                "const": "REPAY",
+                "type": "string"
+              },
+              {
+                "const": "LOAN_LIQUIDATION",
+                "type": "string"
+              },
+              {
+                "const": "STAKE",
+                "type": "string"
+              },
+              {
+                "const": "UNSTAKE",
+                "type": "string"
+              },
+              {
+                "const": "CLAIM_REWARDS",
+                "type": "string"
+              }
+            ]
+          },
+          "positionRef": {
+            "type": "string"
+          },
+          "tokenRole": {
+            "anyOf": [
+              {
+                "const": "UNDERLYING",
+                "type": "string"
+              },
+              {
+                "const": "COLLATERAL",
+                "type": "string"
+              },
+              {
+                "const": "RECEIPT_TOKEN",
+                "type": "string"
+              },
+              {
+                "const": "LP_SHARE",
+                "type": "string"
+              },
+              {
+                "const": "LIABILITY_TOKEN",
+                "type": "string"
+              },
+              {
+                "const": "REWARD",
+                "type": "string"
+              },
+              {
+                "const": "OTHER",
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "from": {
+        "additionalProperties": false,
+        "properties": {
+          "address": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "address"
+        ],
+        "type": "object"
+      },
+      "portfolioTransactionId": {
+        "type": "string"
+      },
+      "quote": {
+        "additionalProperties": false,
+        "properties": {
+          "currency": {
+            "type": "string"
+          },
+          "meta": {
+            "additionalProperties": false,
+            "properties": {
+              "s": {
+                "enum": [
+                  "SYNC_SOURCE",
+                  "FMV_ENGINE",
+                  "DERIVED_REPRESENTED",
+                  "DERIVED_SIBLING",
+                  "POLICY",
+                  "MANUAL"
+                ],
+                "type": "string"
+              },
+              "ts": {
+                "exclusiveMinimum": 0,
+                "maximum": 8210266876799,
+                "type": "integer"
+              }
+            },
+            "required": [
+              "s"
+            ],
+            "type": "object"
+          },
+          "source": {
+            "type": "string"
+          },
+          "value": {
+            "pattern": "^-?\\d+(\\.\\d+)?$",
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "to": {
+        "additionalProperties": false,
+        "properties": {
+          "address": {
+            "type": "string"
+          },
+          "label": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "address"
+        ],
+        "type": "object"
+      },
+      "token": {
+        "additionalProperties": false,
+        "properties": {
+          "address": {
+            "type": "string"
+          },
+          "assetId": {
+            "type": "string"
+          },
+          "chainId": {
+            "type": "string"
+          },
+          "decimals": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "isSpam": {
+            "type": "boolean"
+          },
+          "representsTokenAddress": {
+            "type": "string"
+          },
+          "stablecoinPeggedFiatCurrency": {
+            "type": "string"
+          },
+          "symbol": {
+            "type": "string"
+          },
+          "type": {
+            "anyOf": [
+              {
+                "const": "ERC20",
+                "type": "string"
+              },
+              {
+                "const": "NATIVE",
+                "type": "string"
+              },
+              {
+                "const": "FIAT",
+                "type": "string"
+              },
+              {
+                "const": "NFT",
+                "type": "string"
+              },
+              {
+                "const": "REBASE_LST",
+                "type": "string"
+              },
+              {
+                "const": "INTEREST_BEARING",
+                "type": "string"
+              },
+              {
+                "const": "VALUE_ACCRUING",
+                "type": "string"
+              },
+              {
+                "const": "LP_SHARE",
+                "type": "string"
+              },
+              {
+                "const": "DEBT",
+                "type": "string"
+              },
+              {
+                "const": "REFLECT",
+                "type": "string"
+              },
+              {
+                "const": "VOTE_ESCROWED",
+                "type": "string"
+              }
+            ]
+          }
+        },
+        "required": [
+          "chainId",
+          "address",
+          "assetId",
+          "symbol",
+          "type",
+          "decimals",
+          "isSpam"
+        ],
+        "type": "object"
+      },
+      "txIndex": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "type": {
+        "enum": [
+          "IN",
+          "OUT",
+          "GAS",
+          "SELF"
+        ],
+        "type": "string"
+      },
+      "value": {
+        "pattern": "^-?\\d+(\\.\\d+)?$",
+        "type": "string"
+      }
+    },
+    "required": [
+      "txIndex",
+      "type",
+      "from",
+      "to",
+      "token",
+      "value"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "data",
-  "pagination"
-]New value: +[
+  "resultType"
+]

Changed2 schema fields changedSep 20, 2026

changedInput schema / properties / portfolioRef / description

Previous value: -"Portfolio name or slug inside that workspace. Call list_portfolios, or find_portfolios when the user named one, to resolve it."New value: +"Portfolio name or slug inside that workspace. Call list_portfolios to resolve it."

changedInput schema / properties / workspaceRef / description

Previous value: -"Workspace name or slug. Call list_workspaces, or find_workspaces when the user named one, to resolve it."New value: +"Workspace name or slug. Call list_workspaces to resolve it."

Changed11 schema fields changedSep 17, 2026

addedInput schema / properties / chainId / description

Added value: +"Blockchain to filter by, such as eth-mainnet. Call list_chains for the supported set."

addedInput schema / properties / chainIds / description

Added value: +"Blockchains to filter by, such as eth-mainnet. Call list_chains for the supported set."

addedInput schema / properties / fromDate / description

Added value: +"Earliest transaction timestamp to include, as an ISO 8601 datetime."

addedInput schema / properties / includeSpamTokens / description

Added value: +"Include activity for tokens flagged as spam. Excluded by default."

addedInput schema / properties / portfolioRef / description

Added value: +"Portfolio name or slug inside that workspace. Call list_portfolios, or find_portfolios when the user named one, to resolve it."

addedInput schema / properties / processingState / description

Added value: +"Keep only source transactions in this processing state."

addedInput schema / properties / sort / description

Added value: +"Timestamp order. Prefix with - for newest first."

addedInput schema / properties / toDate / description

Added value: +"Latest transaction timestamp to include, as an ISO 8601 datetime."

addedInput schema / properties / txHash / description
```
Added value: +"Exact on-chain transaction hash."
```

addedInput schema / properties / walletAddress / description

Added value: +"Wallet to filter by. Supply chainId alongside it."

addedInput schema / properties / workspaceRef / description

Added value: +"Workspace name or slug. Call list_workspaces, or find_workspaces when the user named one, to resolve it."

First observedSep 14, 2026

TDQS

A4.4/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already carry readOnlyHint, idempotentHint, and destructiveHint, so the safety profile is covered. The description adds value by disclosing that raw transactions may be 'unprocessed or partially linked' and that includeDetails returns 'sanitized event logs and decoded contract calls' from an 'untrusted provider' — a meaningful trust caveat. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences with zero waste. The first sentence front-loads the core purpose, and the second gives conditional usage guidance. Every clause carries meaningful information, and no redundancy or filler is present.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given a fully described 15-parameter schema, an output schema, and safety annotations, the description supplies the necessary mental model: raw-first lookup, mapping via rawTransactionId, and details with untrusted-provider caveat. It does not discuss pagination or sorting, but those are fully documented in the schema. A slightly explicit note on when to prefer this over list_portfolio_transactions would push it to 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3. The description earns a 4 by explaining how rawTransactionId and includeDetails work together: rawTransactionId maps to wallet movements/accounting transactions, and includeDetails adds provider-sourced event logs and contract calls. This goes beyond the schema's field-level descriptions.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb-resource pair: 'Find compact source transactions... called Raw Transactions in Tokenbooks.' It clarifies scope ('including unprocessed or partially linked activity') and the concept is distinct from sibling list tools. An agent can immediately tell what this tool returns and how it differs from higher-level portfolio transactions.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives practical usage cues: this is the 'first' source-level lookup, and it explains conditional flows ('Pass rawTransactionId to show how one maps...; add includeDetails for...'). It stops short of explicitly naming when not to use it or comparing it with sibling tools like list_portfolio_transactions, but the workflow guidance is clear enough to be useful.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Tokenbooks - crypto and fiat accounting and payments tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?