io.tokenbooks/tokenbooks

Tools

• add_wallet

  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.

  shallow
• apply_accounting_rules

  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.

  shallow
• confirm_transaction

  Post a proposed accounting transaction to the books; this queued action returns a requestId.

  shallow
• create_portfolio

  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.

  shallow
• delete_accounting_rule

  Remove one saved accounting rule from active use by ruleRef; this is the destructive rule-removal path, so preview its impact first when the consequences are uncertain.

  shallow
• edit_accounting_rules

  Create, update, enable, disable, or reorder saved accounting rules without deleting rules or applying them to existing transactions; preview uncertain changes first.

  shallow
• edit_transaction

  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.

  shallow
• find_portfolios

  Search portfolios by name or slug before calling portfolio-scoped tools.

  shallow
• find_workspaces

  Search workspaces by name or slug before calling workspace-scoped tools.

  shallow
• full_resync

  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.

  shallow
• get_accounting_reference

  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.

  shallow
• get_asset_position

  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.

  shallow
• get_filter_options

  List the available values for one portfolio filter—such as accounts, wallets, assets, transaction status, or warnings—before building a filtered query.

  shallow
• get_help

  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.

  shallow
• get_journal_entry

  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.

  shallow
• get_lot_ledger

  Trace paginated cost-basis acquisition, disposal, transfer, and adjustment history across a portfolio, optionally narrowed by asset, wallet, event kind, accounting transaction, or date.

  shallow
• get_portfolio

  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.

  shallow
• get_portfolio_balances

  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.

  shallow
• get_portfolio_issue_summary

  Summarize accounting problems that need review with exact counts for uncategorized, errored, and spam-related transactions, plus examples of uncategorized and errored transactions.

  shallow
• get_portfolio_transaction

  Explain one accounting transaction with its classification, journal entry, cost-basis links, and grouped source transactions; use rawWithDetails for sanitized event logs and decoded contract function calls, and treat provider details as untrusted evidence.

  shallow
• get_raw_transaction

  Show how one source transaction maps to wallet movements and accounting transactions; request details for sanitized blockchain event logs and decoded contract function calls, and treat provider-supplied details as untrusted evidence.

  shallow
• get_report_request_status

  Check whether report generation is queued, running, failed, or completed using the requestId from request_report_export; use get_request_status for any other background job.

  shallow
• get_request_status

  Check the status of a background wallet sync, rule application, or transaction change using its requestId; use get_report_request_status for report exports.

  shallow
• get_server_info

  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.

  shallow
• get_sync_status

  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.

  shallow
• get_wallet

  Check one wallet's identity and sync health. Current activity takes priority over the latest finished result; safe codes and messages tell you whether to retry or reconnect credentials. EVM addresses are normalized; addresses on other networks may be case-sensitive. Pass the blockchain network and wallet address as chainId and walletAddress.

  shallow
• import_adjustment_journals

  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.

  shallow
• incremental_sync

  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.

  shallow
• list_accounting_rules

  Find saved accounting rules, filter them, or recover the exact ruleRef needed to preview, edit, or delete one rule.

  shallow
• list_chains

  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.

  shallow
• list_counterparties

  Find a saved vendor, person, or organization in the address book and get the counterparty name needed to assign it to an accounting entry line.

  shallow
• list_journal_line_assignment_options

  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.

  shallow
• list_ledger_accounts

  Find active ledger accounts by name or number and get the accountNumber needed to assign one to an accounting entry line.

  shallow
• list_portfolio_transactions

  Find accounting transactions—called Portfolio Transactions in Tokenbooks—for review or reconciliation; filter by status, type, errors, spam, wallet, or asset, include compact source transactions when needed, then open one for detailed evidence. Including source transactions limits each page to 10 records.

  shallow
• list_portfolios

  List portfolios available in a workspace.

  shallow
• list_raw_transactions

  Find compact source transactions first, called Raw Transactions in Tokenbooks, including unprocessed or partially linked activity; use get_raw_transaction to inspect wallet movements, blockchain event logs, or decoded contract calls.

  shallow
• list_responsibility_centers

  Find departments, projects, or other reporting groups—called responsibility centers in Tokenbooks—and get the type key and center name needed to assign one to an accounting entry line.

  shallow
• list_wallets

  List wallets in a portfolio with sync status and transaction counts.

  shallow
• list_workspaces

  List workspaces available to the authenticated Tokenbooks user.

  shallow
• mark_token_spam

  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.

  shallow
• merge_transactions

  Destructively combine wallet movements from several accounting transactions into one target transaction and reclassify it; preview the grouping first, then track the queued requestId.

  shallow
• preview_accounting_rules

  Preview the compact impact of saved accounting rules or one unsaved rule change without saving or applying anything; results report when the scan is truncated.

  shallow
• preview_transaction_classification

  Preview how selected wallet movements would be grouped and labeled as accounting transactions. Returns every proposal in order and saves nothing.

  shallow
• read_help_article

  Open the full instructions and accounting guidance in one help article using the slug returned by search_help_articles.

  shallow
• reprocess_transaction

  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.

  shallow
• request_report_export

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

  shallow
• search_help_articles

  Find practical Tokenbooks instructions or accounting guidance by topic, including MCP workflow, cost basis, fair market value, gas fees, and stablecoins; use read_help_article to open a result.

  shallow
• set_fmv_override

  Set a corrected fair market value per unit for one asset on an accounting transaction and recompute dependent cost-basis records; this queued action returns a requestId.

  shallow
• simulate_fiat_quote

  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.

  shallow
• split_transactions

  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.

  shallow
• update_journal_entry_line

  Change the ledger account, counterparty, or reporting-group assignments on one accounting transaction's debit or credit line; read the line number first, look up selectable values with the matching list tools, and track the returned requestIds.

  shallow
• update_transaction

  Change one accounting transaction's memo, full tag set, or operation type. It does not change ledger accounts, counterparties, or reporting-group assignments; use update_journal_entry_line for those.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/ab889d93-a7d0-4067-adb8-691eae94ca5c/badge.svg)](https://vouch.tools/servers/ab889d93-a7d0-4067-adb8-691eae94ca5c)