AgentTax

AgentTax MCP 服务

由 AgentTax 提供支持，为 MCP 工具开发者和 AI Agent 提供税务合规服务。

面向 MCP 工具开发者

如果你构建的 MCP 工具会按使用量收费，那么在买家所在的州，你就有销售税义务。大多数支付处理商都无法正确处理数字服务的相关税务。

将 AgentTax 添加到你的 MCP 配置中，并在每次收款后调用 track_payment。就这么简单。

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

收款后：

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

返回你的税务义务和合规状态，并将记录保存到你的账户。所有交易都可以在你的 AgentTax 控制面板中查看。

Stripe webhook（全自动）

如果要全自动跟踪税务，无需手动调用任何工具，请将 Stripe webhook 指向 AgentTax：

1. 在 Stripe Dashboard → Developers → Webhooks 中，添加一个端点：

   https://agenttax.io/api/v1/webhooks/stripe?key=atx_live_YOUR_KEY
   

2. 选择事件：payment_intent.succeeded、checkout.session.completed、invoice.paid、charge.succeeded
3. 可选：在 Stripe 产品中设置 metadata.work_type（compute | research | content | consulting | trading），以便准确分类税务

每笔收款都会自动分类、计税并记录。无需更改代码。

Stripe 支付必须包含账单地址。请在 Stripe Checkout 设置中启用完整地址收集。

---

安装

Claude Code

claude mcp add agenttax -- npx @agenttax/mcp-server
export AGENTTAX_API_KEY=atx_live_your_key

Claude Desktop / Cursor / Windsurf

添加到你的 MCP 配置文件中：

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

无需密钥即可使用演示模式（每天 50 次调用，无需账户）。下方标记为“Yes”的工具需要 AGENTTAX_API_KEY。

---

工具

工具	功能	是否需要密钥
track_payment	记录收到的款项并获取销售税义务。面向付费 MCP 服务和 API 的主要工具。	演示模式可用；查看历史记录需密钥
calculate_tax	完整的销售税／使用税计算，包含管辖区明细、审计追踪、置信度评分和提示	演示模式可用；获取完整响应需密钥
ingest_transactions	批量记录最多 100 笔交易（例如 x402 购买），按 external_tx_id 保证幂等性	是
list_transactions	查看交易历史和累计总额	是
get_nexus_thresholds	各州的经济关联门槛（收入／交易笔数）、说明和税务部门来源	否
get_nexus	查看已配置经济关联的州	是
configure_nexus	设置存在经济关联的州（合并语义）	是
log_trade	记录买入／卖出；卖出时返回已实现损益和成本基础	是
list_trades	查看已记录的交易	是
export_1099_da	为已实现的数字资产收益生成 1099-DA 表格草稿数据	是（Pro）
get_rates	查询所有 51 个管辖区或单个管辖区的州销售税税率和数字商品应税情况	否
get_local_rate	查询邮政编码对应的州税与地方税合计税率	否
get_capital_gains_rates	查询州短期／长期资本利得税率	否
get_pricing	机器可读的定价协议	否
check_health	API 健康状态和端点列表	否

只读工具带有 MCP readOnlyHint 注解，因此客户端可以自动批准这些工具。

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"
})

返回 tax_owed、tax_rate、taxable、transaction_id、classification（工作类型的来源）和 compliance_note。在未配置关联关系的州，卖家的税额为 $0；响应会在 nexus_warning 中说明这一点。

已知销售内容时，请明确传入 work_type（compute | research | information_service | content | consulting | trading）。这是一个声明，可得出准确结果，而且只有通过这种方式才能适用咨询或交易豁免：例如，向亚利桑那州买家销售的 AI 咨询属于免税专业服务（A.R.S. §42-5061(A)(1), TPR 93-48），因此 work_type: "consulting" 在 AZ 会返回 $0。未传入 work_type 时，服务端会根据 description 进行推测，但推测结果绝不会适用咨询或交易豁免：看起来像咨询（例如 "SOC 2 audit platform subscription"）或交易的描述会按 SaaS 征税；如果推测正确，classification.note 会提示你重新传入 work_type。看起来像计算或研究的描述会保留 1.1.1 分类，这在某些州可能比 SaaS 税额更低（例如 CT、MD、SC、TN、WV）；如需准确结果，请传入 work_type。不知道买家身份时，请不要传入 is_b2b；false 表示声明买家为消费者。要从 1.1.1 升级？部分 track_payment 结果会发生变化；请参阅 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
})

可选字段：seller_state / seller_zip（在 TX、UT、AZ、TN 及 OH 的部分销售中按销售来源地征税）、use_context（马里兰州 B2B）、digital_content_type（与 transaction_type: "digital_good" 搭配使用）、seller_remitting。transaction_type 和 work_type 会按原样传入，并视为已声明事实；请勿猜测（consulting 在亚利桑那州免税）。

Nexus

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

资本利得与 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

---

获取 API 密钥

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"}'

四个字段均为必填项；agent_work_type 可选值为 compute、research、information_service、content、consulting、trading。请保存响应中的 api_key.key——它只会显示一次。

定价

层级	价格	每月调用次数
Free	$0	1,500
Starter	$25/mo	10,000
Growth	$99/mo	100,000
Pro	$199/mo	1,000,000
x402	每次调用 $0.005，以 Base 上的 USDC 支付	按次付费，无需注册

当前机器可读定价：get_pricing 或 GET https://agenttax.io/api/v1/pricing。

链接

• AgentTax
• API 文档
• 控制面板
• GitHub

许可证

MIT