Tokenbooks - crypto and fiat accounting and payments

io.tokenbooks由 tokenbooks.io 發布官方發布者v0.1.1更新於 Oct 24, 2026

Crypto and fiat on one double-entry ledger: sync wallets, reconcile, cost basis, audit-ready close.

已驗證Streamable HTTP可網頁執行金融資料與分析

概覽

AI 產生的概覽

遠端 Tokenbooks 會計伺服器,讓助理同步加密錢包與法幣活動、核對交易,並產出複式記帳帳簿與稅務資料。

可以做什麼
檢視工作區、投資組合、錢包、鏈與會計參考值,檢查同步健康與餘額比對狀態。尋找、預覽、建立、編輯、排序、刪除並批次套用會計規則,儲存前可先預覽影響。檢視原始與會計交易,預覽分類,確認、重算、合併、拆分、編輯分錄列,並將代幣標記為垃圾。新增錢包,執行增量或完整重新同步,並依請求 ID 追蹤背景工作。讀取日記帳分錄、成本基礎批次歷史與資產持倉,從 CSV 或 XLSX 匯入調整分錄,並排隊產生試算表、PDF 或 JSON 報告。模擬法幣出金報價並搜尋內建說明。
適用情境
適合需要直接在 Tokenbooks 帳戶中操作的場合:核對錢包活動、分類交易、維護會計規則、追溯成本基礎,或為結帳準備報告與匯出。也適合在報告期前檢查同步健康並審閱問題。
執行需求
遠端 streamable HTTP 端點 api.tokenbooks.io,不需本機套件。需要 Tokenbooks 帳戶與已驗證使用者,因為多數工具作用於該使用者的工作區與投資組合。伺服器資訊工具會說明支援的鏈、法幣來源、方案與驗證方式。
安裝前請注意
多個工具會寫入或銷毀資料:完整重新同步會刪除並重建錢包、日記帳與成本基礎歷史;套用規則是破壞性批次工作;合併、拆分、重算與標記垃圾會變更現有記錄。確認與匯入會將分錄過帳至帳簿。請先預覽並追蹤請求 ID。法幣報價模擬涉及真實出金。錢包地址與交易資料會傳送至 Tokenbooks 服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tokenbooks - crypto and fiat accounting and payments,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.tokenbooks%2Ftokenbooks/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tokenbooks-crypto-and-fiat-accounting-an": {
      "type": "http",
      "url": "https://api.tokenbooks.io/mcp"
    }
  }
}

工具

36

get_server_info

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.

無需輸入參數。

get_accounting_reference

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.

無需輸入參數。

list_workspaces

List Workspaces

List workspaces available to the authenticated Tokenbooks user, or search by name or slug.

輸入參數query

list_portfolios

List Portfolios

List portfolios available in a workspace, or search by name or slug.

輸入參數pagelimitquerypageSizeworkspaceRef必填

get_portfolio

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.

輸入參數portfolioRef必填workspaceRef必填

get_portfolio_balances

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.

輸入參數portfolioRef必填workspaceRef必填

list_accounting_rules

List Accounting Rules

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

輸入參數limitsearchenabledruleRefwalletsassetIdspageTokenactionTypesportfolioRef必填workspaceRef必填accountNumbersconditionFields另有 1 個

edit_accounting_rules

Edit Accounting Rules

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.

輸入參數nameactionenabledpreviewruleRefoperation必填conditionsmaxAffectedportfolioRef必填workspaceRef必填orderedRuleRefs

apply_accounting_rules

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.

輸入參數portfolioRef必填workspaceRef必填

list_wallets

List Wallets

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.

輸入參數pagelimitchainIdpageSizeportfolioRef必填workspaceRef必填walletAddress

list_journal_line_assignment_options

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.

輸入參數pagetype必填limitsearchpageSizeportfolioRef必填workspaceRef必填

edit_transaction

Edit Transaction

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.

輸入參數memotagsreasonwalletassetIdsubTypeoperation必填timeoutMslineNumberquoteSourceportfolioRef必填transactions另有 10 個

import_adjustment_journals

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.

輸入參數action必填fileName必填resolutionsportfolioRef必填previewTokenworkspaceRef必填contentBase64必填

get_sync_status

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.

輸入參數portfolioRef必填workspaceRef必填

incremental_sync

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.

輸入參數walletsportfolioRef必填workspaceRef必填

full_resync

Full Resync (DANGER — wipes & rebuilds history)

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.

輸入參數walletsportfolioRef必填workspaceRef必填

list_portfolio_transactions

List Portfolio Transactions

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.

輸入參數sortlimitisSpamsearchstatustoDatetxHashaddresschainIdhasLotsincludesubType另有 19 個

list_raw_transactions

List Raw Transactions

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

輸入參數sortlimittoDatetxHashchainIdchainIdsfromDatepageTokenportfolioRef必填workspaceRef必填walletAddressincludeDetails另有 3 個

get_filter_options

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.

輸入參數modefiltersearchpageSizeselectedpageTokenfilterName必填reportTypeportfolioRef必填workspaceRef必填

get_portfolio_issue_summary

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.

輸入參數portfolioRef必填workspaceRef必填

confirm_transaction

Confirm Portfolio Transaction

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

輸入參數portfolioRef必填workspaceRef必填transactionId必填

reprocess_transaction

Reprocess Portfolio 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.

輸入參數reasontimeoutMsportfolioRef必填workspaceRef必填transactionId必填pollIntervalMswaitForCompletion

preview_transaction_classification

Preview Transaction Classification

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

輸入參數operations必填portfolioRef必填workspaceRef必填

merge_transactions

Merge Portfolio 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.

輸入參數reasonsubTypeoperations必填portfolioRef必填workspaceRef必填operationType必填transactionId必填

split_transactions

Split Portfolio Transaction

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.

輸入參數reasonsubTypeoperations必填portfolioRef必填workspaceRef必填operationType必填transactionId必填

mark_token_spam

Mark Token as 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.

輸入參數isSpamreasonchainId必填portfolioRef必填tokenAddress必填workspaceRef必填

simulate_fiat_quote

Simulate Fiat Payout 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.

輸入參數network必填portfolioRef必填workspaceRef必填senderCurrencyreceivingAmount必填purposeOfPaymentreceivingCurrencyrecipientBankCountry

get_journal_entry

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.

輸入參數portfolioRef必填workspaceRef必填journalEntryId必填

get_lot_ledger

Get Cost-Basis 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.

輸入參數pagesortlimitfiltertoDatechainIdassetReffromDatepageSizeentryKindportfolioRef必填workspaceRef必填另有 1 個

request_report_export

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

輸入參數format必填toDate必填fromDate必填reportType必填totalsOnlyportfolioRef必填workspaceRef必填

get_request_status

Get Request Status

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.

輸入參數requestId必填portfolioRefworkspaceRef必填transactionId

add_wallet

Add Wallet(s) to Portfolio

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.

輸入參數wallets必填portfolioRef必填workspaceRef必填

create_portfolio

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.

輸入參數name必填currencyworkspaceRef必填legalEntityTypejurisdictionCodereportingTimezonecostBasisLotMethodcostBasisPerWalletstablecoinTreatmentgasFeeAccountingTreatmentfinancialReportingFramework

get_asset_position

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.

輸入參數assetRef必填includeSpamportfolioRef必填workspaceRef必填

list_chains

List Supported 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.

輸入參數queryevmOnly

get_help

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.

輸入參數sluglimitquery

版本歷史

2
  1. v0.1.1最新Sep 17, 2026
  2. v0.1.0Sep 16, 2026

評分

已滿足適用檢查項的 83%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分

    請宣告包含 README 的 GitHub 儲存庫,或在 OAuth 受保護資源後設資料中提供 resource_documentation。

  • 授權條款不適用

    託管服務按其提供方的條款使用,因此這裡不要求授權條款。此檢查項不計入百分比。