# AgentTax [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/AgentTax/agenttax-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 664  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/agenttax

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

## Tools
Capabilities this server exposes over MCP:

- **track_payment** — Log a payment you received and get your sales tax liability. The main tool for paid MCP servers and APIs.
- **calculate_tax** — Full sales/use tax calculation with jurisdiction breakdown, audit trail, confidence score and advisories
- **ingest_transactions** — Bulk-log up to 100 transactions (e.g. x402 purchases), idempotent on `external_tx_id
- **list_transactions** — Your transaction history with running totals
- **get_nexus_thresholds** — Each state's economic nexus thresholds (revenue / transaction count), notes and DOR source
- **get_nexus** — The states you have configured nexus in
- **configure_nexus** — Set the states you have nexus in (merge semantics)
- **log_trade** — Log a buy/sell; sells return realized gain/loss with cost basis
- **list_trades** — Trades you have logged
- **export_1099_da** — Draft Form 1099-DA payload for realized digital-asset gains
- **get_rates** — State sales tax rates and digital-goods taxability, all 51 jurisdictions or one
- **get_local_rate** — Combined state + local rate for a zip code
- **get_capital_gains_rates** — State short/long-term capital gains rates
- **get_pricing** — Machine-readable pricing contract
- **check_health** — API health and endpoint list

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `AGENTTAX_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What AgentTax MCP server does

The AgentTax MCP server gives AI agents and MCP tool developers access to US tax-compliance operations through the Model Context Protocol. Its main use is recording payments received for paid MCP servers or APIs and obtaining an estimated sales-tax liability based on the buyer’s location, the seller’s configured nexus, and the type of work sold.

The server also covers state economic-nexus thresholds, sales-tax rates, digital-goods taxability, local rates by ZIP code, and state short- and long-term capital-gains rates. Separate trade tools record digital-asset purchases and sales, calculate realized gains using cost basis, and produce a draft Form 1099-DA payload. The draft is not a filed tax return.

This places the AgentTax MCP server in the Finance & Fintech category. It is relevant for developers monetizing agent tools, tracking x402 or other transactions, or maintaining tax records for crypto activity.

## How it works

The server runs as an MCP process and sends requests to the AgentTax service. A typical payment flow calls `track_payment` with an amount, buyer state, optional ZIP code, description, payment identifier, and source. The response includes the tax owed, rate, taxable status, transaction ID, classification, and compliance information. A declared `work_type` such as `compute`, `content`, `consulting`, or `trading` can provide a more specific classification; otherwise, the service infers a category from the description.

For larger imports, `ingest_transactions` accepts up to 100 transactions and avoids duplicate records when the same external transaction ID is reused. Transaction history and running totals are available through `list_transactions`. Nexus states can be read with `get_nexus` and updated with `configure_nexus`, while `get_nexus_thresholds` reports state thresholds and Department of Revenue sources.

## Setup and configuration

Install the package with `npx @agenttax/mcp-server` and configure it as an MCP server. Claude Code uses `claude mcp add`; Claude Desktop, Cursor, and Windsurf use their MCP configuration files. Set `AGENTTAX_API_KEY` for account-backed history and protected operations. Demo mode works without a key and permits 50 calls per day.

An API key can be obtained by submitting an email, password, agent name, and supported agent work type to the AgentTax signup endpoint. The key is shown only once. Account plans include Free, Starter, Growth, and Pro tiers; an x402 option charges per call in USDC on Base.

## Tools and capabilities

The AgentTax MCP server exposes tools for:

- Payment tracking, full tax calculations, and bulk transaction ingestion.
- Transaction history, nexus configuration, and nexus-threshold research.
- State and local sales-tax rates, digital-goods taxability, and capital-gains rates.
- Buy and sell logging with realized gain or loss calculations.
- Draft 1099-DA generation, pricing lookup, health checks, and endpoint discovery.

A Stripe webhook can automate payment tracking for selected payment events, including successful payment intents, completed checkout sessions, paid invoices, and successful charges. Stripe must provide a billing address; full address collection should be enabled in Checkout. Product metadata can identify the work type.

## Limitations and notes

Tax results depend on accurate transaction details, buyer location, work classification, and nexus settings. Descriptions are classified automatically when `work_type` is omitted, but inferred classifications do not apply consulting or trading exemptions. The `calculate_tax` tool treats declared transaction and work types as facts, so callers should not guess them.

Tools requiring an API key include transaction ingestion and history, nexus configuration and retrieval, trade logging and listing, and 1099-DA export. The 1099-DA export additionally requires the Pro tier. Read-only tools carry the MCP `readOnlyHint` annotation, allowing compatible clients to auto-approve them. AgentTax provides tax calculations and draft data; the supplied material does not describe it as filing returns or replacing professional tax advice.

_Full upstream README: https://allmcps.com/mcp/agenttax/readme_