Tokenbooks - crypto and fiat accounting and payments
REMOTE · API.TOKENBOOKS.IO · SCANNED SEP 29
Crypto and fiat on one double-entry ledger: sync wallets, reconcile, cost basis, audit-ready close.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security57
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (edit_accounting_rules). See how to fix → View diagnostics → Fail
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability79
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 7126 tokens (~197/item across 36 items; 36 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management17
- Stability check failed: schema churn in the 15 days we've observed: 16 tool removals, 0 breaking changes, 0 auth/transport breaks, 3 additions. See how to fix → Fail
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 37 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Tokenbooks - crypto and fiat accounting and payments MCP server?
Tokenbooks - crypto and fiat accounting and payments is a hosted endpoint at https://api.tokenbooks.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · api.tokenbooks.io
claude mcp add --transport http io-tokenbooks-tokenbooks 'https://api.tokenbooks.io/mcp'
{
"mcpServers": {
"io-tokenbooks-tokenbooks": {
"url": "https://api.tokenbooks.io/mcp"
}
}
} {
"servers": {
"io-tokenbooks-tokenbooks": {
"type": "http",
"url": "https://api.tokenbooks.io/mcp"
}
}
} [mcp_servers.io-tokenbooks-tokenbooks] url = "https://api.tokenbooks.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"io-tokenbooks-tokenbooks": {
"type": "remote",
"url": "https://api.tokenbooks.io/mcp",
"enabled": true
}
}
} openclaw mcp add io-tokenbooks-tokenbooks --url 'https://api.tokenbooks.io/mcp' --transport streamable-http
mcp_servers:
io-tokenbooks-tokenbooks:
url: "https://api.tokenbooks.io/mcp" {
"McpServers": {
"io-tokenbooks-tokenbooks": {
"Transport": "http",
"Url": "https://api.tokenbooks.io/mcp"
}
}
} assistant mcp add io-tokenbooks-tokenbooks -t streamable-http -u 'https://api.tokenbooks.io/mcp'
{
"mcpServers": {
"io-tokenbooks-tokenbooks": {
"type": "http",
"url": "https://api.tokenbooks.io/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 29 Sept 26 0
- “get_asset_position” added an optional parameter “includeSpam” cosmetic
1 cosmetic change on this day. Switch on “Show cosmetic changes” to see it.
- 28 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 7 to 11.
- 25 Sept 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 22 Sept 26 0
- A breaking change shipped without a version bump: still 0.1.1 ▼ security
- Tool “get_portfolio_transaction” was removed ▼ security
- Tool “get_raw_transaction” was removed ▼ security
- Tool “get_wallet” was removed ▼ security
- The server rewrote its instructions, which are the text every model session reads security
- Tool “list_portfolio_transactions” rewrote its description, which is the text the model reads security
- Tool “list_raw_transactions” rewrote its description, which is the text the model reads security
- Tool “list_wallets” rewrote its description, which is the text the model reads security
- “list_portfolio_transactions” added an optional parameter “transactionId” cosmetic
- “list_raw_transactions” added an optional parameter “includeDetails” cosmetic
- “list_raw_transactions” added an optional parameter “rawTransactionId” cosmetic
- “list_wallets” added an optional parameter “walletAddress” cosmetic
- “list_accounting_rules” reworded the description of “accountNumbers” cosmetic
- “list_accounting_rules” reworded the description of “actionTypes” cosmetic
- “list_accounting_rules” reworded the description of “assetIds” cosmetic
- “list_accounting_rules” reworded the description of “conditionFields” cosmetic
- “list_accounting_rules” reworded the description of “counterpartyNames” cosmetic
- “list_accounting_rules” reworded the description of “wallets” cosmetic
- “list_portfolio_transactions” reworded the description of “address” cosmetic
- “list_portfolio_transactions” reworded the description of “assetRefs” cosmetic
- “list_portfolio_transactions” reworded the description of “counterparty” cosmetic
- “list_portfolio_transactions” reworded the description of “errorType” cosmetic
- “list_portfolio_transactions” reworded the description of “hasError” cosmetic
- “list_portfolio_transactions” reworded the description of “hasJournalEntry” cosmetic
- “list_portfolio_transactions” reworded the description of “hasLots” cosmetic
- “list_portfolio_transactions” reworded the description of “include” cosmetic
- “list_portfolio_transactions” reworded the description of “isSpam” cosmetic
- “list_portfolio_transactions” reworded the description of “operationType” cosmetic
- “list_portfolio_transactions” reworded the description of “responsibilityCenterTypeKeys” cosmetic
- “list_portfolio_transactions” reworded the description of “search” cosmetic
- “list_portfolio_transactions” reworded the description of “status” cosmetic
- “list_portfolio_transactions” reworded the description of “subType” cosmetic
- “list_raw_transactions” reworded the description of “includeSpamTokens” cosmetic
- “list_raw_transactions” reworded the description of “sort” cosmetic
- “list_wallets” reworded the description of “chainId” cosmetic
- 21 Sept 26 −3
- Stability: 0.20 → fail ▼ security
- A breaking change shipped without a version bump: still 0.1.1 ▼ security
- Tool “delete_accounting_rule” was removed ▼ security
- Tool “find_portfolios” was removed ▼ security
- Tool “find_workspaces” was removed ▼ security
- Tool “get_report_request_status” was removed ▼ security
- Tool “list_counterparties” was removed ▼ security
- Tool “list_ledger_accounts” was removed ▼ security
- Tool “list_responsibility_centers” was removed ▼ security
- Tool “preview_accounting_rules” was removed ▼ security
- Tool “read_help_article” was removed ▼ security
- Tool “search_help_articles” was removed ▼ security
- Tool “set_fmv_override” was removed ▼ security
- Tool “update_journal_entry_line” was removed ▼ security
- Tool “update_transaction” was removed ▼ security
- The server rewrote its instructions, which are the text every model session reads security
- Tool “edit_accounting_rules” rewrote its description, which is the text the model reads security
- Tool “get_request_status” rewrote its description, which is the text the model reads security
- Tool “list_portfolios” rewrote its description, which is the text the model reads security
- Tool “list_workspaces” rewrote its description, which is the text the model reads security
- Tool “request_report_export” rewrote its description, which is the text the model reads security
- Tool “edit_accounting_rules” is now declared destructive security
- Schema quality: 158 → 176 ▼ functional
- Tool coverage: 18% → 100% ▲ functional
- Tool “add_wallet” now declares an output schema ▲ functional
- Tool “apply_accounting_rules” now declares an output schema ▲ functional
- Tool “confirm_transaction” now declares an output schema ▲ functional
- Tool “create_portfolio” now declares an output schema ▲ functional
- Tool “edit_accounting_rules” now declares an output schema ▲ functional
- Tool “full_resync” now declares an output schema ▲ functional
- Tool “get_accounting_reference” now declares an output schema ▲ functional
- Tool “get_asset_position” now declares an output schema ▲ functional
- Tool “get_filter_options” now declares an output schema ▲ functional
- Tool “get_journal_entry” now declares an output schema ▲ functional
- Tool “get_lot_ledger” now declares an output schema ▲ functional
- Tool “get_portfolio_balances” now declares an output schema ▲ functional
- Tool “get_portfolio_issue_summary” now declares an output schema ▲ functional
- Tool “get_request_status” now declares an output schema ▲ functional
- Tool “get_server_info” now declares an output schema ▲ functional
- Tool “incremental_sync” now declares an output schema ▲ functional
- Tool “list_accounting_rules” now declares an output schema ▲ functional
- Tool “list_chains” now declares an output schema ▲ functional
- Tool “list_portfolios” now declares an output schema ▲ functional
- Tool “list_wallets” now declares an output schema ▲ functional
- Tool “list_workspaces” now declares an output schema ▲ functional
- Tool “mark_token_spam” now declares an output schema ▲ functional
- Tool “merge_transactions” now declares an output schema ▲ functional
- Tool “reprocess_transaction” now declares an output schema ▲ functional
- Tool “request_report_export” now declares an output schema ▲ functional
- Tool “simulate_fiat_quote” now declares an output schema ▲ functional
- Tool “split_transactions” now declares an output schema ▲ functional
- New tool “edit_transaction” functional
- New tool “get_help” functional
- New tool “list_journal_line_assignment_options” functional
- “edit_accounting_rules” added an optional parameter “maxAffected” cosmetic
- “edit_accounting_rules” added an optional parameter “preview” cosmetic
- “list_portfolios” added an optional parameter “query” cosmetic
- “add_wallet” reworded the description of “portfolioRef” cosmetic
- “add_wallet” reworded the description of “workspaceRef” cosmetic
- “create_portfolio” reworded the description of “workspaceRef” cosmetic
- “edit_accounting_rules” reworded the description of “operation” cosmetic
- “edit_accounting_rules” reworded the description of “portfolioRef” cosmetic
- “edit_accounting_rules” reworded the description of “workspaceRef” cosmetic
- “get_filter_options” reworded the description of “portfolioRef” cosmetic
- “get_filter_options” reworded the description of “workspaceRef” cosmetic
- “get_portfolio_transaction” reworded the description of “portfolioRef” cosmetic
- “get_portfolio_transaction” reworded the description of “workspaceRef” cosmetic
- “get_raw_transaction” reworded the description of “portfolioRef” cosmetic
- “get_raw_transaction” reworded the description of “workspaceRef” cosmetic
- “import_adjustment_journals” reworded the description of “portfolioRef” cosmetic
- “import_adjustment_journals” reworded the description of “workspaceRef” cosmetic
- “list_accounting_rules” reworded the description of “portfolioRef” cosmetic
- “list_accounting_rules” reworded the description of “workspaceRef” cosmetic
- “list_portfolio_transactions” reworded the description of “portfolioRef” cosmetic
- “list_portfolio_transactions” reworded the description of “responsibilityCenterTypeKeys” cosmetic
- “list_portfolio_transactions” reworded the description of “workspaceRef” cosmetic
- “list_raw_transactions” reworded the description of “portfolioRef” cosmetic
- “list_raw_transactions” reworded the description of “workspaceRef” cosmetic
- “preview_transaction_classification” reworded the description of “portfolioRef” cosmetic
- “preview_transaction_classification” reworded the description of “workspaceRef” cosmetic
- 19 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 +1
- Schema quality: 137 → 158 ▼ functional
- Tool coverage: 75% → 98% ▲ functional
- Schema quality: good → excellent functional
- “add_wallet” reworded the description of “portfolioRef” cosmetic
- “add_wallet” reworded the description of “workspaceRef” cosmetic
- “create_portfolio” reworded the description of “workspaceRef” cosmetic
- “delete_accounting_rule” reworded the description of “portfolioRef” cosmetic
- “delete_accounting_rule” reworded the description of “ruleRef” cosmetic
- “delete_accounting_rule” reworded the description of “workspaceRef” cosmetic
- “edit_accounting_rules” reworded the description of “enabled” cosmetic
- “edit_accounting_rules” reworded the description of “name” cosmetic
- “edit_accounting_rules” reworded the description of “operation” cosmetic
- “edit_accounting_rules” reworded the description of “orderedRuleRefs” cosmetic
- “edit_accounting_rules” reworded the description of “portfolioRef” cosmetic
- “edit_accounting_rules” reworded the description of “ruleRef” cosmetic
- “edit_accounting_rules” reworded the description of “workspaceRef” cosmetic
- “get_filter_options” reworded the description of “portfolioRef” cosmetic
- “get_filter_options” reworded the description of “workspaceRef” cosmetic
- “get_portfolio_transaction” reworded the description of “include” cosmetic
- “get_portfolio_transaction” reworded the description of “portfolioRef” cosmetic
- “get_portfolio_transaction” reworded the description of “transactionId” cosmetic
- “get_portfolio_transaction” reworded the description of “workspaceRef” cosmetic
- “get_raw_transaction” reworded the description of “includeDetails” cosmetic
- “get_raw_transaction” reworded the description of “portfolioRef” cosmetic
- “get_raw_transaction” reworded the description of “rawTransactionId” cosmetic
- “get_raw_transaction” reworded the description of “workspaceRef” cosmetic
- “import_adjustment_journals” reworded the description of “action” cosmetic
- “import_adjustment_journals” reworded the description of “portfolioRef” cosmetic
- “import_adjustment_journals” reworded the description of “previewToken” cosmetic
- “import_adjustment_journals” reworded the description of “workspaceRef” cosmetic
- “list_accounting_rules” reworded the description of “accountNumbers” cosmetic
- “list_accounting_rules” reworded the description of “actionTypes” cosmetic
- “list_accounting_rules” reworded the description of “assetIds” cosmetic
- “list_accounting_rules” reworded the description of “conditionFields” cosmetic
- “list_accounting_rules” reworded the description of “counterpartyNames” cosmetic
- “list_accounting_rules” reworded the description of “enabled” cosmetic
- “list_accounting_rules” reworded the description of “portfolioRef” cosmetic
- “list_accounting_rules” reworded the description of “ruleRef” cosmetic
- “list_accounting_rules” reworded the description of “search” cosmetic
- “list_accounting_rules” reworded the description of “wallets” cosmetic
- “list_accounting_rules” reworded the description of “workspaceRef” cosmetic
- “list_portfolio_transactions” reworded the description of “portfolioRef” cosmetic
- “list_portfolio_transactions” reworded the description of “workspaceRef” cosmetic
- “list_raw_transactions” reworded the description of “chainId” cosmetic
- “list_raw_transactions” reworded the description of “chainIds” cosmetic
- “list_raw_transactions” reworded the description of “fromDate” cosmetic
- “list_raw_transactions” reworded the description of “includeSpamTokens” cosmetic
- “list_raw_transactions” reworded the description of “portfolioRef” cosmetic
- “list_raw_transactions” reworded the description of “processingState” cosmetic
- “list_raw_transactions” reworded the description of “sort” cosmetic
- “list_raw_transactions” reworded the description of “toDate” cosmetic
- “list_raw_transactions” reworded the description of “txHash” cosmetic
- “list_raw_transactions” reworded the description of “walletAddress” cosmetic
- “list_raw_transactions” reworded the description of “workspaceRef” cosmetic
- “preview_accounting_rules” reworded the description of “enabled” cosmetic
- “preview_accounting_rules” reworded the description of “maxAffected” cosmetic
- “preview_accounting_rules” reworded the description of “name” cosmetic
- “preview_accounting_rules” reworded the description of “operation” cosmetic
- “preview_accounting_rules” reworded the description of “orderedRuleRefs” cosmetic
- “preview_accounting_rules” reworded the description of “portfolioRef” cosmetic
- “preview_accounting_rules” reworded the description of “ruleRef” cosmetic
- “preview_accounting_rules” reworded the description of “workspaceRef” cosmetic
- “preview_transaction_classification” reworded the description of “portfolioRef” cosmetic
- “preview_transaction_classification” reworded the description of “workspaceRef” cosmetic
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 29 Sept 2026 · Probed https://api.tokenbooks.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=api.tokenbooks.io | CN=YE1,O=Let's Encrypt,C=US | 28 Sept 2026 | 27 Dec 2026 | ECDSA 256 | ECDSA-SHA384 | 6f635e577658c724d60472a6183bf245bbf |
| SANs: api.tokenbooks.io | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of api.tokenbooks.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| io. | present | 57355 | 8 | Verified |
| tokenbooks.io. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://api.tokenbooks.io/mcp | Verified | 200 | |
| http (plaintext) | http://api.tokenbooks.io/mcp | HTTPS enforced | 301 | https://api.tokenbooks.io:443/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
add_wallet Add Wallet(s) to Portfolio ~119
Add one or more blockchain addresses and start their first sync. Omit the blockchain connection identifier (integrationId) to add an EVM 0x address on every supported EVM network; other addresses require an integrationId. This tool does not configure exchange accounts and reports which addresses were added or skipped.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| wallets | array | yes | – |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| results | array | yes | – |
| syncQueued | boolean | yes | – |
No examples provided.
apply_accounting_rules Apply Accounting Rules ~86
Re-run the current saved rules and default assignments for vendors, people, or organizations (counterparty defaults) across eligible existing accounting transactions; this destructive bulk job ignores unsaved edits, so preview first, then track its requestId with get_request_status.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| requestId | string | yes | – |
| status | string | yes | – |
No examples provided.
confirm_transaction Confirm Portfolio Transaction ~62
Post a proposed accounting transaction to the books; this queued action returns a requestId.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| transactionId | string | yes | Portfolio transaction ID |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| requestId | string | – | – |
| status | string | yes | – |
| success | boolean | – | – |
| transactionId | string | yes | – |
No examples provided.
create_portfolio Create Portfolio ~252
Create an accounting portfolio in an existing workspace, optionally choosing jurisdiction and policies; Canada and US profiles require matching currency, entity type, and timezone. If no jurisdiction is selected, Tokenbooks uses generic accounting defaults. Search help for policy choices; workspace creation remains in the Tokenbooks UI.
| Name | Type | Req | Description |
|---|---|---|---|
| costBasisLotMethod | string | – | Lot-matching method for disposals |
| costBasisPerWallet | boolean | – | Whether acquisition lots stay scoped to each wallet |
| currency | string | – | Functional currency (default USD) |
| financialReportingFramework | string | – | Financial reporting framework (default TAX_ONLY) |
| gasFeeAccountingTreatment | string | – | Accounting treatment for gas spend |
| jurisdictionCode | string | – | Exact assigned ISO country code, or custom. If omitted, resolves Custom regardless of currency |
| legalEntityType | string | – | Legal entity classification for an explicit country profile |
| name | string | yes | Portfolio name |
| reportingTimezone | string | – | Canonical IANA reporting timezone (default UTC) |
| stablecoinTreatment | string | – | Stablecoin valuation treatment; this does not change lot tracking |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| accountingConfiguration | object | yes | – |
| createdAt | string | yes | – |
| currency | string | yes | – |
| legalEntityType | string | – | – |
| name | string | yes | – |
| reportingTimezone | string | yes | – |
| slug | string | yes | – |
| updatedAt | string | yes | – |
No examples provided.
edit_accounting_rules Edit Accounting Rules ~483
Create, update, enable/disable, reorder, or delete saved accounting rules -- the rule's whole authoring lifecycle. Pass preview: true on any of those to see the impact without saving; use operation: current to preview the saved ruleset as it stands. Results report when a scan is truncated.
| Name | Type | Req | Description |
|---|---|---|---|
| action | object | – | Only for operation create, update; required for operation create. |
| conditions | object | – | Only for operation create, update; required for operation create. |
| enabled | – | – | Whether the rule evaluates. A disabled rule is kept but never fires. Only for operation create, set_enabled; required for operation set_enabled. |
| maxAffected | integer | – | Preview only: how many affected transactions to sample, at most 25. affectedCount in the result equals this sample size; check candidateCount for the true total match count. |
| name | string | – | Human-readable rule name, shown in the rules list. Only for operation create, update; required for operation create. |
| operation | string | yes | create: Create a new rule, or preview creating one (preview: true). update: Change the name, conditions, or actions of an existing rule, or preview the change (preview: true). Provide at least one of… |
| orderedRuleRefs | array | – | Every rule handle in the portfolio, in the order they should evaluate. Rules apply in order, so earlier rules win. Only for operation reorder; required for each. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| preview | boolean | – | When true, evaluate the change and return its impact without saving it. Not for operation current. |
| ruleRef | string | – | Saved rule handle, from list_accounting_rules. Only for operation update, set_enabled, delete; required for each. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| affectedCount | integer | – | – |
| candidateCount | integer | – | – |
| changes | array | – | – |
| detail | string | – | – |
| firstAffectedAt | string | – | – |
| jobId | string | – | – |
| lastAffectedAt | string | – | – |
| mode | string | – | – |
| result | – | – | – |
| scannedCount | integer | – | – |
| status | string | – | – |
| truncatedBy | string | – | – |
No examples provided.
edit_transaction Edit Transaction ~730
Change one accounting transaction (a Portfolio Transaction): update_fields for memo, the full tag set, or operation type; update_journal_line for the ledger account, counterparty, or reporting-group assignments on one debit or credit line (read the line number first, look up selectable values with list_journal_line_assignment_options); or set_fmv_override to correct a fair market value and recompute dependent cost-basis records. Track returned requestIds, or pass waitForCompletion (update_fields, set_fmv_override) to wait for a terminal state.
| Name | Type | Req | Description |
|---|---|---|---|
| accountNumber | string | – | Chart-of-accounts number to assign (from list_journal_line_assignment_options, type: ledger_account) Only for operation update_journal_line. |
| assetId | string | – | Asset ID to override (e.g. eth_1, as returned by the read tools) Only for operation set_fmv_override; required for each. |
| counterpartyName | string | – | Counterparty name to assign; pass null to unset Only for operation update_journal_line. |
| lineNumber | integer | – | Journal entry line number (1-based) Only for operation update_journal_line; required for each. |
| memo | string | – | New memo; pass null to clear it Only for operation update_fields. |
| newValueQuote | string | – | Exact per-unit decimal string in base currency, e.g. "0". Do not use price. Only for operation set_fmv_override; required for each. |
| operation | string | yes | update_fields: Change memo, the full tag set, or the accounting operation type. update_journal_line: Change the ledger account, counterparty, or reporting-group assignments on one transaction's debit… |
| operationType | string | – | New accounting operation type Only for operation update_fields. |
| pollIntervalMs | integer | – | Polling interval in milliseconds, 100 to 5000 (default 500) Not for operation update_journal_line. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| quoteCurrency | string | – | Optional quote currency (defaults to base currency) Only for operation set_fmv_override. |
| quoteSource | string | – | Optional source/justification for the price Only for operation set_fmv_override. |
| reason | string | – | Immutable root reason whose nonempty bytes are preserved exactly; use ptx:<uuid> for transaction references Only for operation set_fmv_override. |
| responsibilityCenterAssignments | array | – | Typed responsibility-center assignment set, one per dimension. Replaces the line assignments; pass [] to clear every dimension. Type keys and center names come from list_journal_line_assignment_optio… |
| subType | string | – | New operation sub-type (requires operationType) Only for operation update_fields. |
| tags | array | – | Replace the full set of transaction tags Only for operation update_fields. |
| timeoutMs | integer | – | Maximum wait time in milliseconds, 1000 to 60000 (default 30000) Not for operation update_journal_line. |
| transactionId | string | yes | Portfolio transaction ID |
| waitForCompletion | – | – | When true, poll queued request IDs and include terminal status/final state before returning Not for operation update_journal_line. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| completed | boolean | – | – |
| error | object | – | – |
| finalState | object | – | – |
| lineNumber | number | – | – |
| operation | string | yes | – |
| primaryRequestId | string | – | – |
| requestId | string | – | – |
| requests | – | – | – |
| results | array | – | – |
| status | string | – | – |
| statuses | array | – | – |
| success | boolean | – | – |
| transactionId | string | yes | – |
No examples provided.
full_resync Full Resync (DANGER — wipes & rebuilds history) ~102
DANGER: delete and rebuild the selected wallet transaction, journal, and cost-basis history from source data. Use only after the user explicitly requests this destructive reset and accepts the consequences; use incremental_sync for routine new activity.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| wallets | array | – | Optional exact wallet pairs; omit to wipe and rebuild every wallet in the portfolio |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioSlug | string | yes | – |
| requestId | string | yes | – |
No examples provided.
get_accounting_reference Get Accounting Reference ~47
Look up valid accounting values—including operation types, transaction statuses, cost-basis methods, and lot event kinds—before classifying or filtering; use the returned exact values instead of guessing.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| costBasisLotEntryKinds | array | yes | – |
| costBasisLotMethods | array | yes | – |
| operationTypes | array | yes | – |
| transactionStatuses | array | yes | – |
No examples provided.
get_asset_position Get Asset Position ~113
Summarize one cryptocurrency or token across every wallet with quantity, cost basis, market value, unrealized gain or loss, and portfolio totals. This covers wallet holdings rather than all ledger accounts; request a balance-sheet report for a complete accounting statement.
| Name | Type | Req | Description |
|---|---|---|---|
| assetRef | string | yes | Asset symbol or canonical asset id |
| includeSpam | boolean | – | Also match assets marked as spam |
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| asset | object | yes | – |
| currency | string | yes | – |
| perWallet | array | yes | – |
| pricedAt | string | – | – |
| totals | object | yes | – |
| unitPrice | string | – | – |
| valuation | object | yes | – |
No examples provided.
get_filter_options Get Filter Options ~291
List the available values for one portfolio filter—such as accounts, wallets, assets, transaction status, or warnings—before building a filtered query.
| Name | Type | Req | Description |
|---|---|---|---|
| filter | string | – | Human-readable Portfolio Transactions filter expression. Only for filterName portfolio-transaction-status-counts. |
| filterName | string | yes | Public filter option provider name. |
| mode | string | – | Address side to inspect for portfolio-transaction-addresses. Required for address filters. Use from for source addresses and to for destination addresses. Only for filterName portfolio-transaction-ad… |
| pageSize | integer | – | Requested number of resources to return. Oversized values are clamped to the route limit. Not for filterName accounts. |
| pageToken | string | – | Opaque token returned by the previous list response. Not for filterName accounts. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| search | string | – | Optional case-insensitive text search applied by the provider to labels, addresses, names, or other provider-owned searchable fields. Not for filterName accounts. |
| selected | – | – | Already-selected option values for selected-value hydration from URL filter state. A single HTTP query value is accepted as a one-element array. Not for filterName accounts. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| accountNumbers | array | – | – |
| accountTypes | array | – | – |
| assets | array | – | – |
| cacheStatus | string | yes | – |
| currencies | array | – | – |
| data | – | – | – |
| hierarchy | array | – | – |
| includeNoWallet | object | – | – |
| normalBalanceTypes | array | – | – |
| origins | array | – | – |
| pagination | – | – | – |
| paymentLabelStates | array | – | – |
| revisionHash | string | yes | – |
| statuses | array | – | – |
| subTypes | array | – | – |
| wallets | array | – | – |
No examples provided.
get_help Get Help ~126
Find practical Tokenbooks instructions or accounting guidance. Pass query to search by topic (MCP workflow, cost basis, fair market value, gas fees, stablecoins, ...), or pass slug to open one article directly using a slug from a previous get_help search result.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum number of search results, only used with query |
| query | string | – | Search query for Tokenbooks instructions or accounting guidance. Omit when using slug. |
| slug | string | – | Help article slug to open directly, from a previous get_help search result. Omit when using query. |
| Name | Type | Req | Description |
|---|---|---|---|
| audience | string | – | – |
| body | string | – | – |
| error | string | – | – |
| message | string | – | – |
| query | string | – | – |
| relatedConcepts | array | – | – |
| relatedTools | array | – | – |
| results | array | – | – |
| slug | string | – | – |
| summary | string | – | – |
| tags | array | – | – |
| title | string | – | – |
No examples provided.
get_journal_entry Get Journal Entry ~76
Read every debit and credit line in one journal entry—the detailed accounting record—and trace each line to its cost-basis records and blockchain movements.
| Name | Type | Req | Description |
|---|---|---|---|
| journalEntryId | string | yes | Journal entry ID |
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| adjustmentJournalImportProvenance | object | – | – |
| id | string | yes | – |
| isAdjustment | boolean | yes | – |
| lines | array | yes | – |
| memo | string | – | – |
| operationType | string | – | – |
| portfolioTransactionId | string | – | – |
| status | string | yes | – |
| subType | string | – | – |
| systemNotes | string | – | – |
| timestamp | string | yes | – |
No examples provided.
get_lot_ledger Get Cost-Basis Lot Ledger ~386
Trace paginated cost-basis acquisition, disposal, transfer, and adjustment history across a portfolio, optionally narrowed by asset, wallet, event kind, accounting transaction, or date.
| Name | Type | Req | Description |
|---|---|---|---|
| assetRef | string | – | Deprecated compatibility selector for asset symbol or asset id. Prefer filter=asset_id. |
| chainId | string | – | Exact chain ID when filtering to one wallet; requires walletAddress |
| entryKind | array | – | Filter by lot entry kind (any of) |
| filter | string | – | Public AIP-160 filter string. Supported fields: id lot identifier (=, !=, in, not in), entry_id ledger-row identifier (=, !=, in, not in), asset_id (=, !=, in, not in), asset_spam (= true or false),… |
| fromDate | string | – | Optional ISO timestamp lower bound |
| limit | – | – | Maximum items to return, maximum 100. Preferred MCP pagination field. |
| page | integer | – | Page number, starting at 1 |
| pageSize | – | – | Deprecated alias for limit, maximum 100. Prefer limit for new MCP calls. |
| portfolioRef | string | yes | Portfolio exact name or slug |
| sort | string | – | Single public sort field. Prefix with - for descending. Supported fields: timestamp, diff, value, price |
| toDate | string | – | Optional ISO timestamp upper bound |
| walletAddress | string | – | Exact case-sensitive wallet address when filtering to one wallet; requires chainId |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| pagination | object | yes | – |
No examples provided.
get_portfolio Get Portfolio ~70
Read one portfolio's settings and accounting policy by exact name or slug, including its financial reporting framework and legal entity type. If legalEntityType is omitted, it is unset.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| accountingConfiguration | object | yes | – |
| createdAt | string | yes | – |
| currency | string | yes | – |
| legalEntityType | string | – | – |
| name | string | yes | – |
| reportingTimezone | string | yes | – |
| slug | string | yes | – |
| updatedAt | string | yes | – |
No examples provided.
get_portfolio_balances Get Portfolio Balances ~70
Check whether each wallet's computed token balances match its latest synchronized snapshot; returns per-wallet match status, token count, last transaction time, and an overall match flag.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| allBalancesMatch | boolean | yes | – |
| data | array | yes | – |
No examples provided.
get_portfolio_issue_summary Get Portfolio Issue Summary ~72
Summarize accounting problems that need review with exact counts for uncategorized, errored, and spam-related transactions, plus examples of uncategorized and errored transactions.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| counts | object | yes | – |
| errorsByType | array | yes | – |
| isClean | boolean | yes | – |
| samples | object | yes | – |
No examples provided.
get_request_status Get Request Status ~134
Check the status of any queued background work — report generation, wallet sync, rule application, or a transaction change — using the requestId returned when it was queued. Works for every request kind; there is no separate report-status tool.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | – | Portfolio exact name or slug |
| requestId | string | yes | Request ID returned by the call that queued the work (e.g. incremental_sync, full_resync, request_report_export) |
| transactionId | string | – | Optional transaction ID that caused the async request, for agent context |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| appProgress | object | – | – |
| completedAt | – | – | – |
| createdAt | – | yes | – |
| error | – | – | – |
| finishedOn | number | – | – |
| kind | string | yes | – |
| outcome | object | – | – |
| progress | number | – | – |
| progressPercent | number | – | – |
| requestId | – | yes | – |
| result | – | – | – |
| returnValue | – | – | – |
| status | string | yes | – |
| subject | object | – | – |
| type | string | – | – |
| updatedAt | string | – | – |
No examples provided.
get_server_info Get Server Info ~83
Learn what this accounting server covers before connecting: supported blockchains and fiat sources, accounting standards, plans with their capacity limits and what each tier adds, how to sign up, connection endpoint and authentication methods, and what it deliberately leaves out. Needs no credentials, so call it first when evaluating a connection, answering what Tokenbooks costs or includes, or debugging a connection.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| authentication | array | yes | – |
| coverage | object | yes | – |
| documentationUrl | string | yes | – |
| endpoint | string | yes | – |
| gettingStarted | object | yes | – |
| limitations | array | yes | – |
| name | string | yes | – |
| notes | array | yes | – |
| pricing | object | yes | – |
| summary | string | yes | – |
| title | string | yes | – |
No examples provided.
get_sync_status Get Sync Status ~68
Check sync health across every wallet in a portfolio. Current activity takes priority over each latest finished result; safe codes and messages tell you whether to retry or reconnect credentials.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| completedAt | string | – | – |
| startedAt | string | – | – |
| status | string | yes | – |
| updatedAt | string | yes | – |
| wallets | array | yes | – |
No examples provided.
import_adjustment_journals Import Adjustment Journals ~227
Preview or post a complete CSV or XLSX file of balanced manual adjustment journals for one portfolio. Preview first; post only after reviewing every blocking issue, then resend the unchanged source with its preview token and any resolutions.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | preview: Parse the file and report what it would import, writing nothing. Always preview before posting. post: Commit the import that a preview of the same file produced. |
| contentBase64 | string | yes | CSV or XLSX source file content as base64-encoded bytes (max 5 MiB). |
| fileName | string | yes | Original CSV or XLSX source filename. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| previewToken | string | – | Token returned by the matching preview, proving the file has not changed since. Only for action post; required for each. |
| resolutions | array | – | Only for action post; required for each. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | – |
| createdJournalCount | integer | – | – |
| importRef | string | – | – |
| issues | – | – | – |
| journals | – | yes | – |
| omittedJournalCount | integer | yes | – |
| previewToken | string | – | – |
| readyToPost | boolean | – | – |
| summary | – | – | – |
No examples provided.
incremental_sync Incremental Sync ~93
Pull only recent blockchain and wallet activity while keeping all existing transaction and accounting history; use this routine refresh before reports or when new activity is missing, then track its requestId with get_request_status.
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioRef | string | yes | Portfolio exact name or slug |
| wallets | array | – | Optional exact wallet pairs; omit to sync every wallet in the portfolio |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| portfolioSlug | string | yes | – |
| requestId | string | yes | – |
No examples provided.
list_accounting_rules List Accounting Rules ~270
Find saved accounting rules, filter them, or recover the exact ruleRef needed to preview, edit, or delete one rule.
| Name | Type | Req | Description |
|---|---|---|---|
| accountNumbers | array | – | Ledger account numbers as CSV or repeated query values. |
| actionTypes | array | – | Action types as CSV or repeated query values. |
| assetIds | array | – | Asset ids as CSV or repeated query values. |
| conditionFields | array | – | Condition fields as CSV or repeated query values. |
| counterpartyNames | array | – | Counterparty names as CSV or repeated query values. |
| enabled | boolean | – | Keep only enabled rules, or only disabled ones. Omit to return both. |
| limit | integer | – | Requested number of resources to return. Oversized values are clamped to the route limit. |
| pageToken | string | – | Opaque token returned by the previous list response. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| ruleRef | string | – | Saved rule handle, from list_accounting_rules. |
| search | string | – | Free-text match against rule names. |
| wallets | array | – | Wallet selectors as chainId:walletAddress values. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| pagination | object | yes | – |
No examples provided.
list_chains List Supported Chains ~102
Find which blockchains support wallet syncing by name, Tokenbooks chain slug, or numeric EVM network ID; results identify EVM networks whose shared 0x address can be added together with add_wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| evmOnly | boolean | – | When true, return only EVM-compatible chains |
| query | string | – | Optional chain name, slug, or EVM chain id (e.g. "Optimism", "optimism-mainnet", "10") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
No examples provided.
list_journal_line_assignment_options List Journal Line Assignment Options ~273
Find the ledger accounts, saved counterparties, or responsibility centers (departments, projects, or other reporting groups) that can be assigned to an accounting entry line. Pass type to choose the lookup: ledger_account returns each account's accountNumber, counterparty returns the counterparty name, and responsibility_center returns its type key and center name.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum items to return, maximum 100. Preferred MCP pagination field. Only for type counterparty. |
| page | integer | – | Page number, starting at 1 Only for type counterparty. |
| pageSize | integer | – | Deprecated alias for limit, maximum 100. Prefer limit for new MCP calls. Only for type counterparty. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| search | string | – | Filter by name (also matches account number for ledger accounts) |
| type | string | yes | ledger_account: Ledger accounts assignable to a journal line. counterparty: Saved vendors, people, or organizations assignable to a journal line. responsibility_center: Departments, projects, or othe… |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| accounts | array | – | – |
| counterparties | array | – | – |
| hasMore | boolean | – | – |
| responsibilityCenters | array | – | – |
| total | number | – | – |
| type | string | yes | – |
No examples provided.
list_portfolio_transactions List Portfolio Transactions ~653
Find accounting transactions—called Portfolio Transactions in Tokenbooks—for review or reconciliation; filter by status, type, errors, spam, wallet, or asset, optionally attaching grouped contributing raw source records (10-record page cap). Pass transactionId to explain full details of one transaction instead: classification, journal entry, cost-basis links, and (rawWithDetails) its sanitized event logs and contract calls.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | Match transfer from/to address (case-insensitive) |
| assetRefs | array | – | Filter by asset symbol (case-insensitive) |
| chainId | string | – | Public wallet chain ID. |
| chainIds | array | – | Optional chain ID filters |
| counterparty | array | – | Filter by counterparty name (case-insensitive) |
| defiPositionKey | string | – | Filter by protocol-defined DeFi position key |
| defiPositionWalletAddress | string | – | Filter by DeFi position wallet address |
| defiPositionWalletChainId | string | – | Filter by DeFi position wallet chain ID |
| errorType | array | – | Filter by error/warning code, e.g. ["FmvNotAvailable"] |
| fromDate | string | – | Optional ISO timestamp lower bound |
| hasError | boolean | – | true: has a processing error; false: error-free |
| hasJournalEntry | boolean | – | true: has a non-empty journal entry; false: does not |
| hasLots | boolean | – | true: produced cost-basis lots; false: did not |
| include | string | – | Include grouped contributing raw source transactions; rawWithDetails adds sanitized provider details and requires transactionId |
| isSpam | boolean | – | true: transfers involve spam tokens; false: non-spam only |
| limit | – | – | Maximum Portfolio Transactions to return, maximum 100. |
| maxValue | string | – | Maximum transfer fiat quote value (inclusive), as a decimal string |
| minValue | string | – | Minimum transfer fiat quote value (inclusive), as a decimal string |
| operationType | array | – | Filter by operation type, e.g. ["UNCATEGORIZED"] |
| pageToken | string | – | Opaque token returned by the previous list response. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| responsibilityCenterTypeKeys | array | – | Filter by journal-line responsibility-center type key (e.g. primary, goal; from list_journal_line_assignment_options) |
| search | string | – | Free-text search over memo, tx hash, transaction ID |
| sort | string | – | Timestamp sort. Prefix with - for descending order. |
| status | array | – | Filter by status, e.g. ["POSTED"] |
| subType | array | – | Filter by operation sub-type (case-insensitive) |
| toDate | string | – | Optional ISO timestamp upper bound |
| transactionId | string | – | Look up one transaction by handle instead of listing |
| txHash | string | – | Filter by exact on-chain transaction hash |
| walletAddress | string | – | Public wallet address on the selected chain. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| classification | object | – | – |
| data | array | – | – |
| errorDetails | array | – | – |
| errorMessage | string | – | – |
| fileAttachments | array | – | – |
| id | string | – | – |
| intercompanyPair | object | – | – |
| journalEntry | – | – | – |
| memo | string | – | – |
| operationType | string | – | – |
| pagination | object | – | – |
| portfolioTransactionContext | object | – | – |
| rawTransactions | array | – | – |
| resultType | string | yes | – |
| status | string | – | – |
| subType | string | – | – |
| systemNotes | string | – | – |
| tags | array | – | – |
| timestamp | string | – | – |
| walletOperations | array | – | – |
| walletSource | object | – | – |
No examples provided.
list_portfolios List Portfolios ~103
List portfolios available in a workspace, or search by name or slug.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | – | – | Maximum items to return, maximum 100. Preferred MCP pagination field. |
| page | integer | – | Page number, starting at 1 |
| pageSize | – | – | Deprecated alias for limit, maximum 100. Prefer limit for new MCP calls. |
| query | string | – | Optional portfolio name or slug search query |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| pagination | object | yes | – |
No examples provided.
list_raw_transactions List Raw Transactions ~370
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).
| Name | Type | Req | Description |
|---|---|---|---|
| chainId | string | – | Blockchain to filter by, such as eth-mainnet. Call list_chains for the supported set. |
| chainIds | array | – | Blockchains to filter by, such as eth-mainnet. Call list_chains for the supported set. |
| fromDate | string | – | Earliest transaction timestamp to include, as an ISO 8601 datetime. |
| includeDetails | boolean | – | With rawTransactionId, also return blockchain event logs and decoded contract calls |
| includeSpamTokens | boolean | – | Include transactions whose operations contain only spam tokens; defaults to false. |
| limit | – | – | Maximum raw transaction summaries to return, maximum 100. |
| pageToken | string | – | Opaque token returned by the previous list response. |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| processingState | string | – | Keep only source transactions in this processing state. |
| rawTransactionId | string | – | Look up one source transaction by handle instead of listing |
| sort | string | – | Timestamp order. Use timestamp for ascending or -timestamp for descending; defaults to -timestamp. |
| toDate | string | – | Latest transaction timestamp to include, as an ISO 8601 datetime. |
| txHash | string | – | Exact on-chain transaction hash. |
| walletAddress | string | – | Wallet to filter by. Supply chainId alongside it. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| blockHeight | string | – | – |
| data | array | – | – |
| details | – | – | – |
| hash | string | – | – |
| id | string | – | – |
| memo | string | – | – |
| pagination | object | – | – |
| processingState | string | – | – |
| resultType | string | yes | – |
| timestamp | string | – | – |
| wallet | object | – | – |
| walletOperations | array | – | – |
No examples provided.
list_wallets List Wallets ~168
List wallets in a portfolio with sync status and transaction counts. Pass chainId and walletAddress to check one wallet instead — safe codes/messages show whether to retry or reconnect credentials. EVM addresses are normalized; other networks may be case-sensitive.
| Name | Type | Req | Description |
|---|---|---|---|
| chainId | string | – | Optional chain filter, or with walletAddress |
| limit | – | – | Maximum items to return, maximum 100. Preferred MCP pagination field. |
| page | integer | – | Page number, starting at 1 |
| pageSize | – | – | Deprecated alias for limit, maximum 100. Prefer limit for new MCP calls. |
| portfolioRef | string | yes | Portfolio exact name or slug |
| walletAddress | string | – | Look up one wallet; requires chainId |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | – |
| chainId | string | – | – |
| createdAt | string | – | – |
| data | array | – | – |
| lastSyncAt | string | – | – |
| name | string | – | – |
| pagination | object | – | – |
| resultType | string | yes | – |
| syncMessages | array | – | – |
| syncStatus | string | – | – |
| transactionCount | integer | – | – |
No examples provided.
list_workspaces List Workspaces ~41
List workspaces available to the authenticated Tokenbooks user, or search by name or slug.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | – | Optional workspace name or slug search query |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
No examples provided.
mark_token_spam Mark Token as Spam ~155
Mark or unmark a token as spam so unwanted dust or airdrops are excluded from accounting and existing records are updated; this queued action defaults to marking spam and returns a requestId.
| Name | Type | Req | Description |
|---|---|---|---|
| chainId | string | yes | Chain ID of the token (from a walletOperation) |
| isSpam | boolean | – | Spam flag to set (default true; false unmarks) |
| portfolioRef | string | yes | Portfolio exact name or slug |
| reason | string | – | Optional immutable root reason. Nonempty bytes are preserved exactly; use ptx:<uuid> for transaction references. |
| tokenAddress | string | yes | Token contract address (from a walletOperation) |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| requestId | string | – | – |
| status | string | yes | – |
| success | boolean | – | – |
No examples provided.
merge_transactions Merge Portfolio Transactions ~149
Destructively combine wallet movements from several accounting transactions into one target transaction and reclassify it; preview the grouping first, then track the queued requestId.
| Name | Type | Req | Description |
|---|---|---|---|
| operationType | string | yes | Accounting operation type for the merged transaction |
| operations | array | yes | Operations to merge into the target |
| portfolioRef | string | yes | Portfolio exact name or slug |
| reason | string | – | Optional immutable root reason. Nonempty bytes are preserved exactly; use ptx:<uuid> for transaction references. |
| subType | string | – | Optional operation sub-type |
| transactionId | string | yes | Target transaction the operations are merged into |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| requestId | string | – | – |
| status | string | yes | – |
| success | boolean | – | – |
| transactionId | string | yes | – |
No examples provided.
preview_transaction_classification Preview Transaction Classification ~101
Preview how selected wallet movements would be grouped and labeled as accounting transactions. Returns every proposal in order and saves nothing.
| Name | Type | Req | Description |
|---|---|---|---|
| operations | array | yes | Exact transfer-operation handles returned by transaction reads, including the accounting transaction each operation currently belongs to |
| portfolioRef | string | yes | Portfolio name or slug inside that workspace. Call list_portfolios to resolve it. |
| workspaceRef | string | yes | Workspace name or slug. Call list_workspaces to resolve it. |
| Name | Type | Req | Description |
|---|---|---|---|
| transactions | array | yes | – |
No examples provided.
reprocess_transaction Reprocess Portfolio Transaction ~149
Recalculate one accounting transaction after correcting its inputs; this destructive queued job may regroup only its assigned wallet movements, and waitForCompletion can return the final state.
| Name | Type | Req | Description |
|---|---|---|---|
| pollIntervalMs | integer | – | Request-status polling interval in milliseconds |
| portfolioRef | string | yes | Portfolio name or slug |
| reason | string | – | Optional immutable root reason; nonempty bytes are preserved exactly |
| timeoutMs | integer | – | Maximum wait time in milliseconds |
| transactionId | string | yes | Selected portfolio transaction ID to reprocess |
| waitForCompletion | boolean | – | Wait for the queued reprocess request to reach a terminal state before returning |
| workspaceRef | string | yes | Workspace name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| completed | boolean | – | – |
| error | object | – | – |
| finalState | object | – | – |
| requestId | string | – | – |
| requests | object | – | – |
| status | string | yes | – |
| statuses | array | – | – |
| success | boolean | – | – |
| transactionId | string | yes | – |
No examples provided.
request_report_export Request Report Export ~139
Queue generation of the requested spreadsheet, PDF, or JSON accounting report—such as profit and loss, trial balance, balance sheet, journal, or transaction export—for a reporting period; track the returned requestId with get_request_status.
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | yes | Export format |
| fromDate | string | yes | Report period start ISO timestamp |
| portfolioRef | string | yes | Portfolio exact name or slug |
| reportType | string | yes | Report type |
| toDate | string | yes | Report period end ISO timestamp |
| totalsOnly | boolean | – | Return summary only when true |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| requestId | string | yes | – |
No examples provided.
simulate_fiat_quote Simulate Fiat Payout Quote ~200
Estimate exchange rates, processing fees, amount received, and corridor limits for a bank payout before sending money; use it to compare supported rails such as ACH, SEPA, EFT, FPS, IMPS, or SWIFT.
| Name | Type | Req | Description |
|---|---|---|---|
| network | string | yes | Fiat payout rail / bank method |
| portfolioRef | string | yes | Portfolio exact name or slug |
| purposeOfPayment | string | – | Purpose-of-payment classification |
| receivingAmount | string | yes | Amount the recipient should receive, as a decimal string in the receiving currency (e.g. "500000") |
| receivingCurrency | string | – | ISO 4217 receiving currency; defaults to the network default |
| recipientBankCountry | string | – | ISO 3166-1 alpha-2 recipient bank country; defaults to the network default |
| senderCurrency | string | – | Stablecoin funding the payout (default USDC) |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| corridor | object | yes | – |
| note | string | – | – |
| quote | object | – | – |
| status | string | yes | – |
No examples provided.
split_transactions Split Portfolio Transaction ~210
Destructively move selected whole existing operation handles unchanged out of one accounting transaction into a new classified transaction; use this only when the needed economic legs already exist as operation handles. It cannot divide one transfer amount into new economic legs: repair sync normalization or use a supported persisted replacement lifecycle for a missing leg. Preview the grouping first, then track the queued requestId.
| Name | Type | Req | Description |
|---|---|---|---|
| operationType | string | yes | Accounting operation type for the new transaction |
| operations | array | yes | Whole existing operation handles to move unchanged into a new transaction; do not use this to divide one normalized transfer amount into new economic legs |
| portfolioRef | string | yes | Portfolio exact name or slug |
| reason | string | – | Optional immutable root reason. Nonempty bytes are preserved exactly; use ptx:<uuid> for transaction references. |
| subType | string | – | Optional operation sub-type |
| transactionId | string | yes | Source transaction to split operations out of |
| workspaceRef | string | yes | Workspace exact name or slug |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | – |
| requestId | string | – | – |
| status | string | yes | – |
| success | boolean | – | – |
| transactionId | string | yes | – |
No examples provided.
What is the Tokenbooks - crypto and fiat accounting and payments MCP server?
Tokenbooks - crypto and fiat accounting and payments is an MCP server listed in the public MCP registry as io.tokenbooks/tokenbooks. Crypto and fiat on one double-entry ledger: sync wallets, reconcile, cost basis, audit-ready close. This page covers its hosted endpoint (https://api.tokenbooks.io/mcp).
Is the Tokenbooks - crypto and fiat accounting and payments MCP server safe to use?
Tokenbooks - crypto and fiat accounting and payments scores 67 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Tokenbooks - crypto and fiat accounting and payments MCP server expose?
Tokenbooks - crypto and fiat accounting and payments exposes 36 tools: get_server_info, get_accounting_reference, list_workspaces, list_portfolios, get_portfolio, and 31 more. Their descriptions and schemas cost roughly 6,773 tokens of context every time the server is loaded.
Does the Tokenbooks - crypto and fiat accounting and payments MCP server require authentication?
No. We connected to Tokenbooks - crypto and fiat accounting and payments without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the Tokenbooks - crypto and fiat accounting and payments MCP server still maintained?
Tokenbooks - crypto and fiat accounting and payments is still listed as active in the MCP registry. We last reached this channel on 29 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.