MCP App Store
by KeenEthics
TokenTax icon

TokenTax MCP Server for ChatGPT

By TokenTax

Overview

Get answers about your crypto taxes without leaving the conversation. This plugin connects ChatGPT and Codex to your TokenTax account, so you can find transactions that need review, track down missing cost basis, check wallet and exchange balances, and explore tax-loss harvesting opportunities. Ask for a summary of your tax years, open the relevant transactions in TokenTax, or preview how on-chain activity will be classified. It only accesses the account you sign in with, and it works from the data already imported and recalculated in TokenTax. It can't move funds, process payments, or give formal tax advice.

How to connect

  1. ChatGPT: Open the TokenTax listing in the ChatGPT app directory and choose Connect. ChatGPT listing TokenTax exposes 17 tools here.

Tools

buildAllTxnsUrl

ChatGPT
Build a browser link for the selected user. Read dataModel from getTaxInfo first. For v1 use txnType, txnHash and currency side/symbols; the URL uses /all-transactions. For v2 use type, hash and currency currency/direction (the getTransactions filterQuery fields supplied at the top level); the URL uses /all-transfers. Supply only filters for the target model.

createTransactions

ChatGPT
Create 1 to 50 manual TokenTax transactions only when the user explicitly asks to record specific transactions, never on your own initiative. Requires data model v2; non-admin users need a paid plan. Saves the entire batch immediately with per-transaction audit history; a failed batch saves nothing. Supply timestamps, classifications, transfers, and their accounts using verified records. movement, bridge, incoming, outgoing transactions are unsupported; use mergeTransactions for movements or bridges between existing transactions. Returns created transactions and audit IDs in input order, with applied=true on success. Creation does not run recalculation. After an uncertain response, check getTransactions before retrying to avoid duplicates.

editTransaction

ChatGPT
Correct an existing TokenTax transaction and its transfers only when the user explicitly asks for a specific correction, never on your own initiative. Requires data model v2; non-admin users need a paid plan. Changes are applied immediately and saved in edit history. Read the transaction with getTransactions first. Supply the complete desired transfer list, including unchanged legs and fees; omitted existing transfers are soft-deleted. Editing movement, bridge, incoming, outgoing transactions or transactions involving Spec ID is unsupported. Use mergeTransactions for movements or bridges between existing transactions. Returns the transaction, edit ID, status, and applied flag. After an uncertain response, reread the transaction before retrying.

getAccountsAndCredentials

ChatGPT
Returns non-external accounts in accounts and external accounts in externalAccounts, each with active credentials nested in a credentials array, plus unassignedCredentials for active data sources without an account. Accounts group activity for tax lot tracking; credentials identify API connections, CSV imports or wallet sources, and several credentials can belong to one account. Includes creation/update dates, sync status, last sync attempt and success, and imported activity metadata. startDate/endDate are configured date boundaries; earliestTransaction/latestTransaction describe date-eligible imported activity. Account and credential addresses and integrations may differ. calculationSettings describes whether and when tax lot calculations use separate accounts. External accounts represent entities the user does not directly control, such as an on-chain staking pool, or user-controlled accounts not synced to TokenTax, such as a cold storage wallet with no taxable activity. They track movements of cryptocurrency and its existing tax lots so the same cost basis can be followed when funds return. An external account does not imply ownership or control of its address, and its external flag does not determine tax treatment.

getLineItems

ChatGPT
Read calculated taxable line items from the tax dashboard, for v1 or v2. Use for actual disposal cost basis, proceeds and realized gain/loss instead of estimating from getTransactions prices. Uses the active successful calculation, with dashboard filters, sort behavior and pagination. Excludes like-kind crypto trades, as the dashboard does. Does not run accounting or change data. Each row is a calculated line item, not a whole sale: several rows can belong to one disposal. Aggregate all relevant pages by sellId (v1) or outgoingId (v2) for a disposal total; use getTransactions to look up the transfer-group IDs for whole-transaction totals. A largest line-item gain is not necessarily the largest sale gain. Monetary output is in report currency (USD when fiatCurrency is null), including fee adjustments; do not apply the fee components again. V1 sellId/buyId reference transactions; v2 outgoingId/incomingId reference transfers. Historical links/snapshots can be missing or refer to deleted records. txnHash is the sale transaction hash (v1: GraphQL txnLineItemSellIdTotxn.blocksvcHash; v2: outgoing transfer snapshot). Hashes can be missing or shared by multiple rows; use transaction/transfer IDs for matching. Returns report metadata and needsRecalculation; null means freshness is unavailable. Results may predate edits or a pending/failed job; getTaxInfo supplies latest job status. An unavailable report is distinct from an available report with zero matching rows. Non-admins require a paid plan for the requested year.

getMissingCostBasis

ChatGPT
Get line items with missing cost basis for a given tax year. Use getLineItems for calculated taxable line items regardless of whether basis is missing. Returns sell date, currency, units sold, proceeds, and associated account info. Results are paginated — check totalCount and page to determine if more pages exist. Results come from the active successful calculation and may not reflect recent edits or a pending/failed recalculation.

getRunningBalance

ChatGPT
Get running balances using the selected user's data model, aggregated overall and by account when available. For v2 users, transfer account assignments take precedence over credential accounts. Negative dates are investigation leads. By default returns only negative balance dates; set includeAllEntries for the full paginated history.

getTaxInfo

ChatGPT
Returns tax settings and dashboard summary figures for each tax year associated with the user. Use getLineItems for the calculated taxable line items underlying disposal basis and realized gain/loss. Results are returned in columnar format (columns + rows). Fields: taxYear (number), filingMethod (e.g. FIFO/LIFO/Minimization), shortTermTaxRate (float), longTermTaxRate (float), state (e.g. "NY"), allowedFilingMethods lists the cost basis methods supported by each tax year's country; choose from this list for updateTaxInfo. dashboardIncome (float — calculated by the TokenTax app from the user's actual transactions), dashboardShortTermGains (float — calculated by the app), dashboardLongTermGains (float — calculated by the app), estimatedPnL (string — user-provided estimate entered during VIP onboarding, e.g. "$12,441"; not a calculated value). Also returns dataModel (v1 or v2) for the selected user; use it to choose transaction filters and reference instructions. Also returns recalculation: latestJob (null if none for the current data model), activeJobId, needsRecalculation, and unavailableReason. latestJob includes id, stored status, createdAt, finishedAt, error, and errorMessage. Status created means queued or running; completed and failed are terminal. Unknown or null statuses are preserved. latestJob is the most recently submitted job for the current data model. This tool only reads status; it does not start recalculation. activeJobId identifies the successful calculation supplying the dashboard figures, or is null if none exists. It can differ from latestJob.id, even when that job completed. needsRecalculation checks edits and dirty reports for the active calculation; null means the check is unavailable (see unavailableReason). Job completion alone does not mean the figures include subsequent edits. Use updateTaxInfo to change filingMethod, shortTermTaxRate, or longTermTaxRate for an unlocked existing tax year when requested. Rates are decimals (0.25 means 25%). After an update, dashboard figures will remain stale until a fresh recalculation runs. Numeric fields show "-" instead of a number when the user has no paid plan for that year (distinct from $0).

getTlhTaxLots

ChatGPT
Returns individual tax lots eligible for tax-loss harvesting, including unrealized gain/loss, account, date acquired, and time to long-term status. Uses the latest available minimization report in the active calculation and the tax rates for its report year. By default returns the 20 lots with the largest unrealized losses (most impactful for harvesting). Pass gainLoss="gain" to see gain lots, or increase pageSize to see more results.

getTransactions

ChatGPT
Query the selected user's All Transactions data. Call getTaxInfo first to read dataModel. For v1, use txnType, txnHash, currency side/symbols and sortBy=txnTimestamp (default). For v2, use type, hash, currency currency/direction and sortBy=timestampMin (default). V2 results contain transfer groups with all active legs in a nested transfers table; filters select whole groups. Accounts are tax lot pools and credentials are data sources. Integration IDs are on individual v2 transfers. Transaction prices are not calculated disposal basis or realized gain/loss. Use getLineItems for those report results. Use only filters and sort fields for the target model; incompatible arguments are rejected.

getTxnPreview

ChatGPT
Preview an on-chain transaction in the selected user's data model. Legacy users receive transaction fields and rawTxn; v2 users receive transfer groups with incoming, outgoing and fee transfers plus rawData. Initial classification is before pricing and reconciliation. Not all integrations support previews.

hypotheticalTrade

ChatGPT
Simulates selling all (or a specific account's) lots of a given token at today's current market price. Fetches the live FMV and calculates the magnitude of the unrealized gain or loss that would be realized. Uses the latest available minimization report in the active calculation and the tax rates for its report year. Use this after identifying a candidate position with getTlhTaxLots.

mergeTransactions

ChatGPT
Combine two existing TokenTax transactions into one movement or bridge only when the user explicitly asks to merge them, never on your own initiative. Use for the evidenced withdrawal and deposit sides of a transfer between different accounts, not trades or speculative matches. Requires data model v2; non-admin users need a paid plan. Inspect both transactions with getTransactions first. The merge applies immediately: the outbound group survives and the inbound group is soft-deleted. Returns the surviving transaction, merge history ID, status, and applied flag. Merging does not run recalculation. After an uncertain response, reread both transactions before retrying.

reconcileEvmTxn

ChatGPT
Fetch on-chain evidence and reconciliation instructions in the selected user's data model. Follow the correction format returned by this tool: transaction corrections for legacy users, group and transfer corrections for v2 users.

reconcileSolanaTxn

ChatGPT
Fetch on-chain evidence and reconciliation instructions in the selected user's data model. Follow the correction format returned by this tool: transaction corrections for legacy users, group and transfer corrections for v2 users.

startRecalculation

ChatGPT
Submit a recalculation using the selected user's current data model and saved tax settings, as in the web app. This tool does not change settings or accept a year/method override - that info is determined by the existing user settings (found in getTaxInfo) Rejects the request if the user's latest nondeleted recalculation job is queued or running, across both data models, as in the web app. Returns userId, dataModel, and jobId after queue submission. Submission does not mean the calculation has completed (recalculations may take minutes to complete).

updateTaxInfo

ChatGPT
Changes the cost basis method and/or short-term and long-term capital gains tax rates for one existing, unlocked tax year. Use when requested by the user; choose from allowedFilingMethods returned by getTaxInfo for that year. Rates are nonnegative decimals (0.25 means 25%). Omitted settings stay unchanged. Edits are blocked during reconciliation mode, including for admins. Saves settings only. When the user requests recalculation, use startRecalculation with the saved settings, or recalculate in the web app. Submission does not mean completion; getTaxInfo returns recalculation status. Only poll when the user asks to monitor or wait for recalculation.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/tokentax"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/tokentax)