mcpField
A
AgentTax

AgentTax

Local
agenttax.ioFinance0Updated 2w ago

About AgentTax

AgentTax is an MCP server for tax tracking and calculations related to digital services and agent transactions in the US. It serves MCP tool developers and AI agents with payment logging, nexus information, and digital-asset trade records.

Key features

  1. 01Track payments and estimate sales tax
  2. 02Calculate tax with jurisdiction details
  3. 03Review and configure nexus states
  4. 04Log trades and estimate realized gains
  5. 05Draft Form 1099-DA payloads
  6. 06Look up tax rates and thresholds

Use cases

  1. 01Record payments received by a paid MCP server
  2. 02Import transactions in bulk
  3. 03Check state nexus thresholds and configured states
  4. 04Track digital-asset trades for a draft 1099-DA

MCP support

Exposes tax, transaction, nexus and rate tools to MCP clients. Payments can be logged through `track_payment` or automatically tracked using a Stripe webhook; read-only tools include the MCP `readOnlyHint` annotation.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"agenttax-agenttax": {
"command": "npx",
"args": [
"-y",
"@agenttax/mcp-server"
],
"env": {
"AGENTTAX_API_KEY": "<AGENTTAX_API_KEY>"
}
}
}
}
Run commandnpx -y @agenttax/mcp-server
Environment variables to set
AGENTTAX_API_KEYSecretAgentTax API key (free tier at agenttax.io). Optional: without it the server runs in demo mode, 50 calls/day.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@agenttax/mcp-server1.2.0

Tools

15

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
roleenumYesYour role in the transactionbuyer | seller
amountnumberYesTransaction amount in USD
is_b2bbooleanNoBusiness-to-business transaction (triggers state B2B rules, e.g. IA, MD)
buyer_zipstringNoBuyer's 5-digit zip code for local rate lookup
work_typeenumNoWhat the agent's work is economically; drives per-state taxability (compute, research, information_service, content, consulting, trading)compute | research | information_service | content | consulting | trading
seller_zipanyNoSeller's 5-digit zip. Required for TX/UT/AZ/TN origin-sourced intrastate sales and intrastate OH license/digital_good sales
buyer_stateenumYes2-letter US state code of the buyer (or DC)AL | AK | AZ | AR | CA | CO | CT | DE | FL | GA | HI | ID | IL | IN | IA | KS | KY | LA | ME | MD | MA | MI | MN | MS | MO | MT | NE | NV | NH | NJ | NM | NY | NC | ND | OH | OK | OR | PA | RI | SC | SD | TN | TX | UT | VT | VA | WA | WV | WI | WY | DC
use_contextenumNoMaryland only, with is_b2b=true: whether the purchase is solely for use in an enterprise computer systementerprise_system | individual | mixed
seller_stateanyNoSeller's 2-letter state code (needed for origin-sourced intrastate sales)
counterparty_idstringYesIdentifier for the other party (letters, digits and _-.:@ only)
seller_remittingbooleanNoBuyer side: whether the seller is already collecting the tax
transaction_typeenumYesType of transactioncompute | api_access | data_purchase | saas | ai_labor | storage | digital_good | consulting | data_processing | cloud_infrastructure | ai_model_access | marketplace_fee | subscription | license | service
digital_content_typeenumNoWith transaction_type digital_good: what the download is. Several states tax e-books, music and video but not digital art or printablesebook | audio | video | art_image | photograph | printable_document | software | data | other

Details

From the project 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.

{
  "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
claude mcp add agenttax -- npx @agenttax/mcp-server
export AGENTTAX_API_KEY=atx_live_your_key
Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

{
  "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",
  work_type: "content",
  payment_id: "pi_stripe_abc123",
  source: "stripe"
})

Returns tax_owed, tax_rate, taxable, transaction_id, a classification (where the work type came from) and a compliance_note. Sellers get $0 in states where no nexus is configured; the response says so in nexus_warning.

Pass work_type explicitly (compute | research | information_service | content | consulting | trading) when you know what you sold. It is a declaration and gives the exact answer, and it is the only way the consulting or trading exemption applies: for example, AI consulting sold to an Arizona buyer is an exempt professional service (A.R.S. §42-5061(A)(1), TPR 93-48), so work_type: "consulting" returns $0 in AZ. Without work_type the server guesses from description, but a guess never takes the consulting or trading exemption: a description that looks like consulting (e.g. "SOC 2 audit platform subscription") or trading is taxed as SaaS, and classification.note tells you to resend with work_type if the guess was right. A description that looks like compute or research keeps the 1.1.1 classification, which can tax less than SaaS in some states (e.g. CT, MD, SC, TN, WV); pass work_type for an exact answer. Leave is_b2b out when you don't know the buyer; false declares a consumer. Upgrading from 1.1.1? Some track_payment results change; see CHANGELOG.md.

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. transaction_type and work_type are sent exactly as given and treated as declared facts; don't guess them (consulting is exempt in Arizona).

Nexus
get_nexus_thresholds({ state: "NY" })          // what triggers registration
configure_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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.