AgentTax

io.github.AgentTaxv1.1.1更新於 Oct 8, 2026

US sales/use tax, nexus thresholds, capital gains and 1099-DA tools for AI agent transactions.

已驗證STDIO僅桌面FinanceBusiness & Commerce

概覽

AI 產生的概覽

讓助理記錄收款與交易、計算美國銷售稅與使用稅及資本利得,並查詢各州經濟關聯門檻。

功能
AgentTax 提供面向 AI 代理與數位服務交易的美國稅務合規工具。track_payment 記錄收到的付款並回傳應納稅額、稅率、應稅金額與合規說明;calculate_tax 提供依轄區拆分的計算結果、稽核軌跡與信心分數;ingest_transactions 可批次記錄最多 100 筆交易。此外還涵蓋經濟關聯(get_nexus_thresholds、get_nexus、configure_nexus)、稅率(get_rates、get_local_rate、get_capital_gains_rates)、含已實現損益的交易記錄,以及 1099-DA 草稿匯出。
適用情境
適合經營付費 MCP 工具、API 或數位服務,且需要依買方所在州追蹤美國銷售稅與使用稅責任的情境;也適合需要查詢各州經濟關聯門檻、銷售稅率、資本利得稅率或數位資產交易 1099-DA 草稿資料的情境。
執行需求
透過 npx @agenttax/mcp-server 以 stdio 在本機執行,需要 Node.js。AgentTax 帳號與 AGENTTAX_API_KEY 環境變數可解鎖歷史記錄與大部分工具;沒有金鑰時以展示模式執行,每天 50 次呼叫。需要連線至 agenttax.io 的網路存取。付費方案自每月 25 美元起。
安裝前請注意
此伺服器會把付款與交易詳情(包括買方所在州、郵遞區號、金額與付款 ID)傳送給 AgentTax。AGENTTAX_API_KEY 是機密,註冊時僅顯示一次。track_payment、ingest_transactions、configure_nexus、log_trade 與 export_1099_da 會將資料寫入你的帳號。1099-DA 匯出僅為草稿,並非已申報的稅表;稅務結果僅供參考,不構成專業稅務建議。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 AgentTax,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

AgentTax MCP Server

Tax compliance for MCP tool developers and AI agents, powered by AgentTax.

For MCP tool developers

If you build MCP tools that charge for usage, you have sales tax obligations in states where your buyers are located. Most payment processors don't handle this correctly for digital services.

Add AgentTax to your MCP setup and call track_payment after every payment. That's it.

json
{  "mcpServers": {    "agenttax": {      "command": "npx",      "args": ["@agenttax/mcp-server"],      "env": {        "AGENTTAX_API_KEY": "atx_live_your_key"      }    }  }}

After a payment:

track_payment({  amount: 49.00,  buyer_state: "TX",  buyer_zip: "78701",  description: "MCP API access — monthly subscription",  payment_id: "pi_stripe_abc123",  source: "stripe"})

Returns your tax liability, compliance status, and logs it to your account. All transactions are viewable in your AgentTax dashboard.

Stripe webhook (fully automated)

For fully automatic tax tracking without calling any tool manually, point your Stripe webhook to AgentTax:

  1. In Stripe Dashboard → Developers → Webhooks, add an endpoint:
    https://agenttax.io/api/v1/webhooks/stripe?key=atx_live_YOUR_KEY
  2. Select events: payment_intent.succeeded, checkout.session.completed, invoice.paid, charge.succeeded
  3. Optional: set metadata.work_type on your Stripe products (compute | research | content | consulting | trading) for precise tax classification

Every payment is automatically classified, taxed, and logged. No code changes required.

Requires a billing address on the Stripe payment. Enable full address collection in your Stripe Checkout settings.


Install

Claude Code

bash
claude mcp add agenttax -- npx @agenttax/mcp-serverexport AGENTTAX_API_KEY=atx_live_your_key

Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

json
{  "mcpServers": {    "agenttax": {      "command": "npx",      "args": ["@agenttax/mcp-server"],      "env": {        "AGENTTAX_API_KEY": "atx_live_your_key"      }    }  }}

Demo mode works without a key (50 calls/day, no account required). Tools marked "Yes" below need AGENTTAX_API_KEY.


Tools

ToolWhat it doesKey needed
track_paymentLog a payment you received and get your sales tax liability. The main tool for paid MCP servers and APIs.Demo works; key for history
calculate_taxFull sales/use tax calculation with jurisdiction breakdown, audit trail, confidence score and advisoriesDemo works; key for full response
ingest_transactionsBulk-log up to 100 transactions (e.g. x402 purchases), idempotent on external_tx_idYes
list_transactionsYour transaction history with running totalsYes
get_nexus_thresholdsEach state's economic nexus thresholds (revenue / transaction count), notes and DOR sourceNo
get_nexusThe states you have configured nexus inYes
configure_nexusSet the states you have nexus in (merge semantics)Yes
log_tradeLog a buy/sell; sells return realized gain/loss with cost basisYes
list_tradesTrades you have loggedYes
export_1099_daDraft Form 1099-DA payload for realized digital-asset gainsYes (Pro)
get_ratesState sales tax rates and digital-goods taxability, all 51 jurisdictions or oneNo
get_local_rateCombined state + local rate for a zip codeNo
get_capital_gains_ratesState short/long-term capital gains ratesNo
get_pricingMachine-readable pricing contractNo
check_healthAPI health and endpoint listNo

Read-only tools carry the MCP readOnlyHint annotation so clients can auto-approve them.

track_payment

track_payment({  amount: 49.00,  buyer_state: "TX",  buyer_zip: "78701",  description: "MCP tool subscription",  payment_id: "pi_stripe_abc123",  source: "stripe"})

Returns tax_owed, tax_rate, taxable, transaction_id and a compliance_note. Classification comes from description. Sellers get $0 in states where no nexus is configured; the response says so in nexus_warning.

calculate_tax

calculate_tax({  role: "buyer",  amount: 500,  buyer_state: "TX",  buyer_zip: "78701",  transaction_type: "compute",  work_type: "compute",  counterparty_id: "seller-agent-123",  is_b2b: true})

Optional fields: seller_state / seller_zip (origin-sourced intrastate sales in TX, UT, AZ, TN and some OH sales), use_context (Maryland B2B), digital_content_type (with transaction_type: "digital_good"), seller_remitting.

Nexus

get_nexus_thresholds({ state: "NY" })          // what triggers registrationconfigure_nexus({ nexus: { TX: { hasNexus: true, reason: "Economic nexus" } } })get_nexus()                                     // what you have configured

Capital gains and 1099-DA

log_trade({ asset_symbol: "ETH", trade_type: "buy", quantity: 2, price_per_unit: 2500, asset_class: "crypto" })log_trade({ asset_symbol: "ETH", trade_type: "sell", quantity: 1, price_per_unit: 3100, asset_class: "crypto" })export_1099_da({ year: 2026 })                  // draft, not a filed return

Get an API Key

bash
curl -X POST https://agenttax.io/api/v1/auth/signup \  -H "Content-Type: application/json" \  -d '{"email": "[email protected]", "password": "securepass", "agent_name": "my-mcp-server", "agent_work_type": "compute"}'

All four fields are required; agent_work_type is one of compute, research, information_service, content, consulting, trading. Save the api_key.key from the response — it's only shown once.

Pricing

TierPriceCalls/month
Free$01,500
Starter$25/mo10,000
Growth$99/mo100,000
Pro$199/mo1,000,000
x402$0.005/call in USDC on BasePay per call, no signup

Current machine-readable pricing: get_pricing or GET https://agenttax.io/api/v1/pricing.

Links

License

MIT

來源:README.md,提交 3893fa2

工具

0
工具後設資料尚未被收錄。

版本歷史

1
  1. v1.1.1最新Oct 8, 2026