Tokenbooks - crypto and fiat accounting and payments
Server Details
Crypto and fiat on one double-entry ledger: sync wallets, reconcile, cost basis, audit-ready close.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 37 tools
Most tools target a distinct resource+action (rules vs transactions vs journals vs lots vs sync vs reports), and the unusually detailed descriptions explicitly draw boundary lines (e.g. get_asset_position vs get_portfolio_balances vs request_report_export; get_request_status noted as the only status tool). The main residual confusion is the cluster of transaction-mutating tools — confirm_transaction, edit_transaction, reprocess_transaction, merge_transactions, split_transactions, preview_transaction_classification — where an agent must read carefully to pick the right repair path. Overlap exists but is largely resolved by the prose.
The vast majority follow a clean verb_noun snake_case pattern (get_*, list_*, create_*, edit_*, merge_*, split_*, request_*, simulate_*). Only full_resync and incremental_sync deviate, using a noun/task-style name instead of a verb, and import_adjustment_journals mixes preview/post semantics under one name. The convention is predictable overall.
37 tools is heavy and pushes past the comfortable range; several exist only to service edge-case repairs (split_transactions, reprocess_transaction, merge_transactions, full_resync). The domain is genuinely broad — workspaces, portfolios, wallets, sync, transactions, journal lines, lot ledger, rules, reports, fiat quotes, imports — so most tools earn a place, but the surface feels larger than an agent can navigate cheaply.
Core lifecycle coverage is strong: create/list/get for workspaces, portfolios, and wallets; sync (incremental/full) with status; transaction create/edit/confirm/reprocess/merge/split; rules CRUD via edit_accounting_rules; journals, lot ledger, reports, imports, and spam handling. Gaps are modest but real: no update/delete for portfolios or workspaces, no wallet removal, and fiat is read-only (simulate_fiat_quote with no actual payout execution).
Available Tools
37 toolsadd_walletAdd Wallet(s) to PortfolioAInspect
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. It does not configure exchange accounts and reports which addresses were added or skipped.
Inputs: wallets (required), portfolioRef (required), workspaceRef (required). Returns: results, syncQueued
apply_accounting_rulesApply Accounting RulesADestructiveInspect
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.
Inputs: portfolioRef (required), workspaceRef (required). Returns: status, requestId
confirm_transactionConfirm Portfolio TransactionAInspect
Post a proposed accounting transaction to the books; this queued action returns a requestId.
Inputs: portfolioRef (required), workspaceRef (required), transactionId (required). Returns: error, status, success, requestId, +1 more
create_portfolioCreate PortfolioAInspect
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.
Inputs: name (required), workspaceRef (required), currency, legalEntityType, +7 more. Returns: name, slug, currency, createdAt, +5 more
create_workspaceCreate WorkspaceAInspect
Create a workspace when list_workspaces is empty or the user wants another; then create_portfolio. On failure, check list_workspaces before retrying.
Inputs: name (required), workspaceIntent. Returns: name, slug, limits, planName
edit_accounting_rulesEdit Accounting RulesADestructiveInspect
Create, update, enable/disable, reorder, or delete saved accounting rules. 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.
Inputs: operation (required), portfolioRef (required), workspaceRef (required), name, +7 more. Returns: mode, jobId, detail, result, +9 more
edit_transactionEdit TransactionAInspect
Create manual source transactions (signed wallet movements; duplicate hashes refused; accounting asynchronous), or change one accounting transaction: memo/tags/type, journal lines or unit fair market value. Read line numbers/list_journal_line_assignment_options first. Track requestIds or waitForCompletion for fields/FMV edits.
Inputs: operation (required), portfolioRef (required), workspaceRef (required), memo, +18 more. Returns: error, failed, status, created, +13 more
full_resyncFull Resync (DANGER — wipes & rebuilds history)ADestructiveInspect
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.
Inputs: portfolioRef (required), workspaceRef (required), wallets. Returns: requestId, portfolioSlug
get_accounting_referenceGet Accounting ReferenceARead-onlyIdempotentInspect
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.
Inputs: no named parameters. Returns: operationTypes, costBasisLotMethods, transactionStatuses, costBasisLotEntryKinds
get_asset_positionGet Asset PositionARead-onlyIdempotentInspect
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, not all ledger accounts; request a balance-sheet report for a complete statement.
Inputs: assetRef (required), portfolioRef (required), workspaceRef (required), includeSpam. Returns: asset, totals, currency, pricedAt, +3 more
get_filter_optionsGet Filter OptionsARead-onlyIdempotentInspect
List the available values for one portfolio filter—such as accounts, wallets, assets, transaction status, or warnings—before building a filtered query.
Inputs: filterName (required), portfolioRef (required), workspaceRef (required), mode, +7 more. Returns: data, assets, period, origins, +15 more
get_helpGet HelpARead-onlyIdempotentInspect
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 a slug from a previous search result to open that article.
Inputs: slug, limit, query. Returns: body, slug, tags, error, +8 more
get_journal_entryGet Journal EntryBRead-onlyIdempotentInspect
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.
Inputs: portfolioRef (required), workspaceRef (required), journalEntryId (required). Returns: id, memo, lines, status, +7 more
get_lot_ledgerGet Cost-Basis Lot LedgerARead-onlyIdempotentInspect
Trace paginated cost-basis acquisition, disposal, transfer, and adjustment history across a portfolio, optionally narrowed by asset, wallet, event kind, accounting transaction, or date.
Inputs: portfolioRef (required), workspaceRef (required), page, sort, +9 more. Returns: data, pagination
get_portfolioGet PortfolioARead-onlyIdempotentInspect
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.
Inputs: portfolioRef (required), workspaceRef (required). Returns: name, slug, currency, createdAt, +5 more
get_portfolio_balancesGet Portfolio BalancesARead-onlyIdempotentInspect
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.
Inputs: portfolioRef (required), workspaceRef (required). Returns: data, allBalancesMatch
get_portfolio_issue_summaryGet Portfolio Issue SummaryARead-onlyIdempotentInspect
Summarize accounting problems that need review with exact counts for uncategorized, errored, and spam-related transactions, plus examples of uncategorized and errored transactions.
Inputs: portfolioRef (required), workspaceRef (required). Returns: counts, isClean, samples, errorsByType
get_request_statusGet Request StatusARead-onlyIdempotentInspect
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; there is no separate report-status tool.
Inputs: requestId (required), workspaceRef (required), portfolioRef, transactionId. Returns: kind, type, error, result, +12 more
get_server_infoGet Server InfoARead-onlyIdempotentInspect
Review supported blockchains and fiat sources, accounting standards, plans, limits and tier features, signup, connection endpoint, authentication, and exclusions. No credentials needed; use before connecting, evaluating costs or coverage, or debugging a connection.
Inputs: no named parameters. Returns: name, notes, title, pricing, +7 more
get_sync_statusGet Sync StatusARead-onlyIdempotentInspect
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.
Inputs: portfolioRef (required), workspaceRef (required). Returns: status, wallets, startedAt, updatedAt, +1 more
import_adjustment_journalsImport Adjustment JournalsAInspect
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.
Inputs: action (required), fileName (required), portfolioRef (required), workspaceRef (required), +3 more. Returns: action, issues, summary, journals, +5 more
incremental_syncIncremental SyncAInspect
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.
Inputs: portfolioRef (required), workspaceRef (required), wallets. Returns: requestId, portfolioSlug
list_accounting_rulesList Accounting RulesARead-onlyIdempotentInspect
Find saved accounting rules, filter them, or recover the exact ruleRef needed to preview, edit, or delete one rule.
Inputs: portfolioRef (required), workspaceRef (required), limit, search, +9 more. Returns: data, pagination
list_chainsList Supported ChainsARead-onlyIdempotentInspect
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.
Inputs: query, evmOnly. Returns: data
list_journal_line_assignment_optionsList Journal Line Assignment OptionsARead-onlyIdempotentInspect
Find ledger accounts, saved counterparties, or responsibility centers (departments or projects) assignable to an accounting entry line.
Inputs: type (required), portfolioRef (required), workspaceRef (required), page, +3 more. Returns: type, total, hasMore, accounts, +2 more
list_portfoliosList PortfoliosARead-onlyIdempotentInspect
List portfolios available in a workspace, or search by name or slug.
Inputs: workspaceRef (required), page, limit, query, +1 more. Returns: data, pagination
list_portfolio_transactionsList Portfolio TransactionsARead-onlyIdempotentInspect
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 one transaction in full instead: classification, journal entry, cost-basis links, and (rawWithDetails) its sanitized event logs and contract calls.
Inputs: portfolioRef (required), workspaceRef (required), sort, limit, +27 more. Returns: id, data, memo, tags, +17 more
list_raw_transactionsList Raw TransactionsARead-onlyIdempotentInspect
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).
Inputs: portfolioRef (required), workspaceRef (required), sort, limit, +11 more. Returns: id, data, hash, memo, +8 more
list_walletsList WalletsARead-onlyIdempotentInspect
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.
Inputs: portfolioRef (required), workspaceRef (required), page, limit, +3 more. Returns: data, name, address, chainId, +7 more
list_workspacesList WorkspacesARead-onlyIdempotentInspect
List workspaces available to the authenticated Tokenbooks user, or search by name or slug.
Inputs: query. Returns: data
mark_token_spamMark Token as SpamAInspect
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.
Inputs: chainId (required), portfolioRef (required), tokenAddress (required), workspaceRef (required), +2 more. Returns: error, status, success, requestId
merge_transactionsMerge Portfolio TransactionsADestructiveInspect
Destructively combine wallet movements from several accounting transactions into one target transaction and reclassify it; preview the grouping first, then track the queued requestId.
Inputs: operations (required), portfolioRef (required), workspaceRef (required), operationType (required), +3 more. Returns: error, status, success, requestId, +1 more
preview_transaction_classificationPreview Transaction ClassificationARead-onlyIdempotentInspect
Preview how selected wallet movements would be grouped and labeled as accounting transactions. Returns every proposal in order and saves nothing.
Inputs: operations (required), portfolioRef (required), workspaceRef (required). Returns: transactions
reprocess_transactionReprocess Portfolio TransactionADestructiveInspect
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.
Inputs: portfolioRef (required), workspaceRef (required), transactionId (required), reason, +3 more. Returns: error, status, success, requests, +5 more
request_report_exportRequest Report ExportAInspect
Queue a 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.
Inputs: format (required), toDate (required), fromDate (required), reportType (required), +3 more. Returns: requestId
simulate_fiat_quoteSimulate Fiat Payout QuoteARead-onlyIdempotentInspect
Estimate exchange rates, processing fees, amount received, and corridor limits for a bank payout before sending money; compare supported rails such as ACH, SEPA, EFT, FPS, IMPS, or SWIFT.
Inputs: network (required), portfolioRef (required), workspaceRef (required), receivingAmount (required), +4 more. Returns: note, quote, status, corridor
split_transactionsSplit Portfolio TransactionADestructiveInspect
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.
Inputs: operations (required), portfolioRef (required), workspaceRef (required), operationType (required), +3 more. Returns: error, status, success, requestId, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
A double-entry ledger built from your invoices, bank lines, expenses, deposits and assets.
Crypto tax software for every wallet and exchange: reconcile transactions and see your tax position.
1Double entry accounting run by your own AI: books, VAT figures, invoices, month close (UK, DE, AT).
Personal, family and business books over fiat and crypto. Reads and records; it cannot pay.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables autonomous financial agents and payment webhooks to create and verify immutable double-entry ledger entries, enforce debit-credit balance invariants, and generate hash-chained audit trails with fraud detection.7MIT

Ekwo OS — open sourceofficial
AlicenseNot gradedqualityAmaintenanceDouble-entry books an agent keeps as the user, on your own Postgres or Supabase: invoices, VAT returns, bank reconciliation, financial statements and 130 country packs.42AGPL 3.0- FlicenseNot gradedqualityCmaintenanceFinancial data infrastructure for AI agents. Connect to a startup's books to read live P&L and bank balances, review and reclassify transactions, manage the chart of accounts, and connect banking sources.-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables MCP clients and autonomous financial agents to submit payment webhook events, journal entries, or transaction streams and receive cryptographically verified, balanced double-entry ledger records with HMAC signatures and hash-chained audit telemetry. It enforces debit/credit invariants and supports fraud detection for real-time accounting workflows.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.