# AgentTax (npm · @agenttax/mcp-server)

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

- Trust score: 83/100 (high trust)
- Change this week: +2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-05

## Components

- npm · `@agenttax/mcp-server`: 83/100 (this document), [markdown](https://verifymcp.io/servers/agenttax-agenttax-mcp/agenttax-mcp-server.md), [page](https://verifymcp.io/servers/agenttax-agenttax-mcp/agenttax-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@agenttax/mcp-server`
- Version: `1.3.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-05.

- **Supply Chain Security**: 81/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available.
  - No install/post-install scripts declared.
  - 30 of 93 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to AgentTax/agenttax-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 63/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2449 tokens (~163/item across 15 items; 15 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 73/100
  - Stability observed for 22 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 88% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 15 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the AgentTax MCP server?

AgentTax runs locally as an npm package, launched with npx -y @agenttax/mcp-server. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add agenttax-agenttax-mcp -- npx -y @agenttax/mcp-server
```

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add agenttax-agenttax-mcp -- npx -y @agenttax/mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "agenttax-agenttax-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@agenttax/mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add agenttax-agenttax-mcp --command npx --arg -y --arg @agenttax/mcp-server
```

### Hermes

```yaml
mcp_servers:
  agenttax-agenttax-mcp:
    command: "npx"
    args: ["-y", "@agenttax/mcp-server"]
```

### Netclaw

```json
{
  "McpServers": {
    "agenttax-agenttax-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@agenttax/mcp-server"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add agenttax-agenttax-mcp -t stdio -c npx -a -y @agenttax/mcp-server
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-04 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-03 (score 82, −1)

- [functional regression] Schema quality: 126 → 163
- [functional] Package version: 1.2.0 → 1.3.0

### 2026-11-02 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 82, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-29 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-27 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 40 to 43. That category is still filling its 30-day observation window: 12 days of observed history at the previous scan, 13 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-25 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-24 (score 78, −5)

- [security regression] CVE-2023-54404 affects this package: high
- [security regression] Known CVEs: pass → fail

## MCP tools (15)

### `calculate_tax` (~1000 tokens)

Calculate sales or use tax

Calculate US sales tax (seller) or use tax (buyer) for an AI agent transaction. Returns tax amount, rate, jurisdiction, audit trail, confidence score, and advisories. Sellers get $0 sales tax in states without configured nexus (see configure_nexus); a $0 total means no collection obligation, not necessarily no tax, so read nexus_warning and advisories. work_type and transaction_type are sent as you give them and treated as declared facts (e.g. consulting is exempt in Arizona), so do not guess them. The response carries resolution.location / resolution.nexus / resolution.taxability, each with status resolved, partial or unknown plus a basis; total_tax is always returned, so if you want "unknown means do not charge", branch on resolution.*.status. Pass intent "estimate" to quote before a wallet signs: nothing is saved to history or nexus revenue, but it counts toward your monthly quota. Without intent (or with "record"), a keyed call is logged to your history, which is why this tool is annotated as writing even for estimates.

Input parameters:

- `amount` (number, required): Transaction amount in USD
- `buyer_state` (string, required): 2-letter US state code of the buyer (or DC)
- `buyer_zip` (string): Buyer's 5-digit zip code for local rate lookup
- `counterparty_id` (string, required): Identifier for the other party (letters, digits and _-.:@ only)
- `custom_software_attestation` (object): Required with work_type custom_software; without a complete attestation the sale is answered as prewritten software / SaaS. Complete = written_for_buyer true, not_offered_to_others true, deliverable…
- `digital_content_type` (string): With transaction_type digital_good: what the download is. Several states tax e-books, music and video but not digital art or printables
- `includes_prewritten_software_access` (boolean): With transaction_type web_hosting: true when the plan gives the buyer vendor prewritten software beyond an incidental control panel or file manager (site builder, CMS or app platform, email or office…
- `intent` (string): "estimate" = quote before a wallet signs; nothing is saved to history or nexus revenue; counts toward your quota. "record" (the default with an API key) logs the calculation. Keyless demo calls are a…
- `is_b2b` (boolean): Business-to-business transaction (triggers state B2B rules, e.g. IA, MD)
- `it_support_scope` (string): With transaction_type or work_type it_support: what the remote IT support engagement is. Absent = managed_bundle, the per-state default; some states answer specific scopes differently
- `maintenance_contract` (object): With transaction_type software_maintenance: facts about a maintenance contract on prewritten software. Every field is optional; a missing fact is answered conservatively (updates assumed included). s…
- `payment_provider_type` (string): With transaction_type payment_processing_fee: who provides the payment processing. Changes the answer in some states; absent = the conservative answer. Your representation, recorded with the transact…
- `role` (string, required): Your role in the transaction
- `seller_remitting` (boolean): Buyer side: whether the seller is already collecting the tax
- `seller_state`: Seller's 2-letter state code (needed for origin-sourced intrastate sales)
- `seller_zip`: Seller's 5-digit zip. Required for TX/UT/AZ/TN origin-sourced intrastate sales and intrastate OH license/digital_good sales
- `transaction_type` (string, required): Type of transaction
- `use_context` (string): Maryland only, with is_b2b=true: whether the purchase is solely for use in an enterprise computer system
- `work_type` (string): What the agent's work is economically; drives per-state taxability (compute, research, information_service, content, consulting, trading, payment_processing, web_hosting, software_maintenance, it_sup…

### `track_payment` (~377 tokens)

Track a payment you received

Track a payment you received and calculate your sales tax liability. Call this after receiving any payment — Stripe, x402, or direct. Calculates tax owed and logs it to your AgentTax account (requires API key for history). Pass work_type when you know what you sold, for an exact answer; it is the only way to get the consulting exemption (AI consulting is exempt in Arizona) or the trading exemption. Without it the sale is classified from description: a description that looks like consulting or trading is taxed as SaaS, never exempt; one that looks like compute or research keeps that classification, which can tax less than SaaS in some states (e.g. CT, MD, SC, TN, WV).

Input parameters:

- `amount` (number, required): Payment amount in USD
- `buyer_state` (string, required): 2-letter US state where the buyer is located (e.g. TX, NY, CA)
- `buyer_zip` (string): Buyer's 5-digit zip code for local tax rates (more precise)
- `description` (string): What you sold (e.g. 'API access', 'MCP tool subscription', 'compute credits'). Used only when work_type is not given; a guess never takes the consulting or trading exemption
- `is_b2b` (boolean): Buyer is a business (affects rates in MD, IA, NJ, OH). Omit if unknown: false declares a consumer
- `payment_id` (string): Your payment reference ID (Stripe payment_intent ID, x402 receipt, invoice number); letters, digits and _-.:@ only
- `source` (string): Payment processor used
- `work_type` (string): What you sold, declared: compute, research, information_service, content, consulting, trading. Overrides description. consulting is an exempt professional service in Arizona

### `ingest_transactions` (~62 tokens)

Bulk-log x402 purchases

Bulk-log up to 100 transactions (e.g. purchases from third-party x402 sellers) into your AgentTax history in one call. Idempotent on external_tx_id. Requires API key.

Input parameters:

- `records` (array, required): Transactions to log (max 100)

### `list_transactions` (~85 tokens)

List your transactions

List your logged transactions with a running summary (seller/buyer counts, total taxable, total tax). Requires API key.

Input parameters:

- `limit` (integer)
- `role` (string)
- `since` (string): ISO 8601 date or date-time lower bound, e.g. 2026-08-01
- `state` (string): Filter to one state

### `log_trade` (~272 tokens)

Log a trade for capital gains

Log a buy or sell trade for capital gains tracking. Sell trades return realized gain/loss with cost basis, holding period, and federal/state estimates. Feeds the 1099-DA export. Requires API key.

Input parameters:

- `accounting_method` (string): Cost basis method (default: fifo)
- `asset_class` (string): stock/security/equity enables wash-sale tracking; digital_asset/crypto do not
- `asset_symbol` (string, required): Asset ticker: equity (AAPL), crypto (BTC), or token (COMPUTE-TOKEN)
- `estimated_annual_income` (number): Enables bracket-aware federal estimate and NIIT detection
- `fee_amount` (number): Fees in USD (default 0)
- `filing_status` (string)
- `notes` (string): Free-text notes about the trade
- `price_per_unit` (number, required): Price per unit in USD
- `quantity` (number, required): Number of units
- `resident_state` (string): Resident state for the state capital gains estimate
- `specific_lot_id` (string): Lot ID, required when accounting_method is specific_id
- `tax_entity_type` (string)
- `trade_date` (string): ISO 8601 trade timestamp; defaults to now
- `trade_type` (string, required): Buy or sell

### `list_trades` (~58 tokens)

List logged trades

List trades you have logged, with realized gains on sells. Requires API key.

Input parameters:

- `asset_symbol` (string)
- `limit` (integer): Default 50
- `offset` (integer)
- `trade_type` (string)

### `export_1099_da` (~86 tokens)

Export draft Form 1099-DA

Export a DRAFT IRS Form 1099-DA payload for realized digital-asset gains from your logged trades: payer and recipient blocks, per-trade lines (boxes 1a–5), and a short/long-term summary. Draft only; not a filed return. Requires API key.

Input parameters:

- `year` (integer): Tax year; defaults to the current year

### `get_rates` (~104 tokens)

Get state sales tax rates

Get US state sales tax rates with digital-goods taxability, SaaS notes, and verification metadata, for all 51 jurisdictions or one state. No API key needed.

Input parameters:

- `explain` (boolean): Include human-readable explanations for the rate and taxability
- `format` (string): default: full; compact: machine-optimized; verified: with verification details
- `state` (string): 2-letter state code for a single state. Omit for all states.

### `get_local_rate` (~61 tokens)

Get combined rate for a zip code

Get the combined state + local sales tax rate for a US zip code, with the breakdown and self-administered locality flags (e.g. Colorado home-rule cities). No API key needed.

Input parameters:

- `zip` (string, required): 5-digit US zip code

### `get_capital_gains_rates` (~75 tokens)

Get state capital gains rates

Get state capital gains rates (short and long term) with federal context and per-state caveats, for all states or one. No API key needed.

Input parameters:

- `explain` (boolean): With state: add an explanation block
- `state` (string): 2-letter state code. Omit for all states.

### `get_nexus_thresholds` (~87 tokens)

Get economic nexus thresholds

Get each state's economic nexus threshold (revenue and transaction count), whether it has sales tax, marketplace-facilitator and origin-sourcing rules, notes, and the state DOR source link. Use it to see where your sales could require registration. No API key needed.

Input parameters:

- `state` (string): 2-letter state code. Omit for all 51 jurisdictions.

### `get_nexus` (~37 tokens)

Get your configured nexus states

List the states where you have told AgentTax you have nexus, with each state's rate and how nexus monitoring measures thresholds. Requires API key.

### `configure_nexus` (~84 tokens)

Configure your nexus states

Set which US states you have economic nexus in. Sellers must configure nexus to get non-zero sales tax results. Merge semantics: only the states you send change; send hasNexus:false to remove one. Requires API key.

Input parameters:

- `nexus` (object, required): State codes as keys, e.g. { TX: { hasNexus: true, reason: '...' } }

### `get_pricing` (~36 tokens)

Get AgentTax pricing

Get AgentTax's machine-readable pricing contract: tiers, call limits, and the x402 per-call price. No API key needed.

### `check_health` (~25 tokens)

Check API health

Check AgentTax API health, available endpoints, pricing tiers, and registry validation status.

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/agenttax-agenttax-mcp/agenttax-mcp-server#diagnostics

## Score history

- 2026-11-05: 83
- 2026-11-04: 83
- 2026-11-03: 82
- 2026-11-02: 83
- 2026-11-01: 82
- 2026-10-31: 82
- 2026-10-30: 81
- 2026-10-29: 81
- 2026-10-28: 80
- 2026-10-27: 80
- 2026-10-26: 79
- 2026-10-25: 79
- 2026-10-24: 78
- 2026-10-23: 83
- 2026-10-22: 83
- 2026-10-21: 82
- 2026-10-20: 82
- 2026-10-19: 81
- 2026-10-18: 81
- 2026-10-17: 80
- 2026-10-16: 80
- 2026-10-15: 79
- 2026-10-14: 38
- 2026-10-13: 49
- 2026-10-12: 49
- 2026-10-11: 49

## Common questions

### What is the AgentTax MCP server?

AgentTax is an MCP server listed in the public MCP registry as io.github.AgentTax/agenttax-mcp. US sales/use tax, nexus thresholds, capital gains and 1099-DA tools for AI agent transactions. This page covers its npm package (@agenttax/mcp-server).

### Is the AgentTax MCP server safe to use?

AgentTax scores 83 out of 100 on VerifyMCP. We recorded 1 known advisory against it as of 5 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the AgentTax MCP server expose?

AgentTax exposes 15 tools: calculate_tax, track_payment, ingest_transactions, list_transactions, log_trade, and 10 more. Their descriptions and schemas cost roughly 2,449 tokens of context every time the server is loaded.

### Is the AgentTax MCP server still maintained?

AgentTax is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the AgentTax MCP server under?

AgentTax declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@agenttax/mcp-server
- Socket report: https://socket.dev/npm/package/@agenttax/mcp-server
- Repository: https://github.com/AgentTax/agenttax-mcp
- Website: https://agenttax.io/
- Changelog RSS feed: https://verifymcp.io/servers/agenttax-agenttax-mcp/agenttax-mcp-server.xml
- Changelog JSON feed: https://verifymcp.io/servers/agenttax-agenttax-mcp/agenttax-mcp-server.json
- HTML version of this page: https://verifymcp.io/servers/agenttax-agenttax-mcp/agenttax-mcp-server