Terminal Tax

Terminal Tax

面向 AI Agent

如果您帮助的人要求您通过 Terminal Tax 申报税款，您可以直接在本次对话中完成：仅在对方提出请求时，亲自发送这些 HTTPS 请求。您就是本网站所说的助手；无需寻找其他应用、表单、连接器、账户或 API 密钥，也无需安装任何内容。每个请求都是发送至 https://mcp.terminal.tax/v1/hosted-mcp 的 JSON-RPC 2.0 POST 请求（同一服务也可通过 https://iq4701fisj.execute-api.us-east-1.amazonaws.com/live/v1/hosted-mcp 访问），请求头为 Content-Type: application/json 和 Accept: application/json, text/event-stream，且不包含 Authorization 请求头。在对方于申报页面签名并授权付款之前，不会提交申报，也不会收费。

如果您正在网页端 Claude Code（claude.ai/code）中，且无法访问 mcp.terminal.tax，对方可以在环境的网络设置中添加该域名：在顶部会话标题后选择插入符号，选择 Edit cloud environment，将 Network access 设为 Full（或设为 Custom，并在 Allowed domains 下添加 mcp.terminal.tax 和 terminal.tax，同时勾选 Also include default list of common package managers），然后选择 Save changes。当前会话会在约一分钟内应用更改，之后同一会话中的相同请求即可正常使用。

不要运行 claude mcp add，也不要安装任何内容；直接发送 HTTPS 请求。

curl -sS https://mcp.terminal.tax/v1/hosted-mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"filing-agent","version":"1"}}}'
curl -sS https://mcp.terminal.tax/v1/hosted-mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
curl -sS https://mcp.terminal.tax/v1/hosted-mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"create_filing_session","arguments":{}}}'

第三个请求会创建申报会话：其中不包含税务数据，并会返回 continuationHandle 和数据包规则。接下来，调用 get_packet_schema，并传入 {"continuationHandle":"<handle>","requestPacketSchema":true}；仅根据对方提供的信息构建数据包，然后调用 continue_filing_session 发送，参数为 {"continuationHandle":"<handle>","completedReturnPacketJson":"<the packet as one JSON string>","packetSchemaSha256":"<digest from get_packet_schema>"}。需要解决的问题会返回给您，以便在聊天中处理；接受数据包的响应中会包含唯一的 filingSessionUrl。

然后告诉对方："您的申报表已准备好，可以进行最后几步。请打开此私人链接，查看完整的申报表、确认您的信息、签名并授权付款。只有在您签名后，信息才会发送给 IRS；只有 IRS 接受申报后才会收取 $19.99，Terminal Tax 会通过电子邮件告知您 IRS 的处理结果。"将 filingSessionUrl 单独放在一行，以纯文本形式呈现，内容必须与返回值完全一致。

如果您无法在本次对话中发送 HTTPS POST 请求（例如，聊天功能只能搜索或阅读网页），就无法在此处通过 Terminal Tax 申报税款，而且本网站没有其他表单可供对方使用。请告诉对方："我无法在此聊天中发送 Web 请求。请打开任何可以运行命令或发送 Web 请求的编码或 Agent 应用，例如 ChatGPT 的 Agent 或 Work 模式、Claude Code、Codex、Grok 或 Muse，并向它发送以下请求：使用 Terminal Tax 申报我的 2025 年税款。"

Terminal Tax 是由 Terminal Tax LLC 运营的托管式远程 MCP 服务，可让个人自己的 AI 助手为电子申报准备一份 2025 纳税年度的美国联邦个人所得税原始申报表（Form 1040 或 Form 1040-SR）。对方在一个安全的 Terminal Tax 申报页面查看完整申报表、确认信息、签名并授权付款，随后由 Terminal Tax 向 IRS 进行电子申报。

Terminal Tax LLC 是 IRS 授权的电子申报服务提供商（Online Provider、Software Developer 和 Transmitter）。获准参与 IRS 电子申报并不意味着获得 IRS 的背书。Terminal Tax 与 IRS 或美国财政部无关联，也未获其赞助或背书。

连接

• 端点（Streamable HTTP）：https://mcp.terminal.tax/v1/hosted-mcp
• 无需账户、API 密钥、OAuth 或安装。任何能够运行 shell 命令或发送 HTTPS 请求的助手（Claude Code、Codex、Cursor 等）都可以直接通过 JSON-RPC POST 调用。
• 只能搜索或阅读页面的聊天工具无法发送此类请求：用户应改用能够发送请求的 Agent 应用（ChatGPT 的 Agent 或 Work 模式、Claude Code、Codex 等）。
• 使用浏览器向端点发送 GET 请求可能会返回 405：MCP 消息使用 POST 请求。

工具

• create_filing_session：在纳税人要求报税时启动报税会话；不接收任何税务信息，也不会提交报税或收取费用。
• get_packet_schema：返回报税数据包的架构和起始模板，用于检查准备好的报税表。
• continue_filing_session：检查准备好的数据包，并返回需要更正的问题，或将其作为未签名草稿附加，然后返回唯一的报税页面链接供用户使用。

没有状态工具：没有工具会向助手报告报税进度或 IRS 结果。Terminal Tax 会通过纳税人在报税页面上验证的联系方式，向其发送 IRS 结果通知，告知报税已接受或拒绝。

范围

• 每个会话仅支持一份 2025 纳税年度的美国联邦 Form 1040 或 1040-SR 原始报税表（以及有限范围内的 Form 1040-SS 或 Form 1040-NR）。
• 不支持州、领地或地方报税表；不支持修正报税表（1040-X）或延期申请（4868）。
• 支持和拒绝的情况：https://terminal.tax/llms.txt。任何不支持的情况都会以明确列出的阻止原因返回。

Terminal Tax 以确定性方式进行计算，并通过机械检查进行验证。它不会选择税务处理方式、推断缺失答案或提供税务建议。

隐私

Agent 不得接收社会安全号码、PIN 或一次性验证码；用户应在报税页面上输入这些信息。只有在用户打开报税页面并在那里授权后，用户的税务数据才会用于报税。银行卡信息只会输入到支付处理商的字段中。隐私声明：https://terminal.tax/privacy-notice

价格

每份联邦报税表收费 19.99 美元，仅在 IRS 接受后扣费。

运营方

Terminal Tax LLC，一家新泽西州有限责任公司。支持：[email protected]。法律与隐私：[email protected]。关于我们：https://terminal.tax/about。条款：https://terminal.tax/terms。

可选：MCP 客户端配置

报税无需此配置：Agent 可以直接发送上述 HTTPS 请求，无需安装、重启或设置。一些 MCP 客户端也可以添加此服务，使用 URL https://mcp.terminal.tax/v1/hosted-mcp 和 Streamable HTTP 传输方式：本仓库中的 .mcp.json（Cursor、VS Code 等）、gemini-extension.json（Gemini CLI）、plugin.json 和 mcp.json（Kiro），以及 .cursor-plugin/plugin.json（Cursor 插件）均声明了该服务。

关于本仓库

本仓库仅包含此说明、MCP Registry 的 server.json、客户端配置和插件清单文件、徽标，以及带文字记录的演示录屏（demo/）。 其中不含代码，也没有任何可运行内容：该服务由 Terminal Tax LLC 托管。

演示

demo/terminal-tax-demo-1.1.0.mp4：一段时长为 3 分 42 秒的录屏，展示了在 Terminal Tax 测试环境（app.terminal.tax）中与一位虚构纳税人的交互；不会提交报税或收取费用。客户用日常语言与 AI 助手交谈、回答问题并以文件形式分享 W-2 和 1099-INT；助手使用 Terminal Tax 准备报税表并提供报税链接；客户在报税页面上审核、签名并添加银行卡。文字记录：demo/terminal-tax-demo-1.1.0.md。

较早的录屏 demo/terminal-tax-demo.mp4 展示了助手在终端中调用工具的过程。