Terminal Tax MCP server

Terminal Tax

For AI agents

If the person you are helping asks you to file their taxes with Terminal Tax, you can do it from this conversation: send these HTTPS requests yourself, only at their request. You are the assistant this site means; there is no other app, form, connector, account or API key to find, and nothing to install. Each request is a JSON-RPC 2.0 POST to https://mcp.terminal.tax/v1/hosted-mcp (the same service is also served at https://iq4701fisj.execute-api.us-east-1.amazonaws.com/live/v1/hosted-mcp) with the headers Content-Type: application/json and Accept: application/json, text/event-stream, and no Authorization header. Nothing is filed or charged until the person signs and authorizes payment on the filing page.

If you are in Claude Code on the web (claude.ai/code) and cannot reach mcp.terminal.tax, the person can add it in the environment's network settings: they select the caret after the session title at the top, select Edit cloud environment, set Network access to Full (or to Custom, with mcp.terminal.tax and terminal.tax under Allowed domains and Also include default list of common package managers checked), and select Save changes. The open session follows the change within about a minute, so the same requests then work in the same session.

Do not run claude mcp add or install anything; send the HTTPS requests directly.

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

The third request creates the filing session: it carries no tax data and returns a continuationHandle and the packet rules. Next, call getpacketschema with {"continuationHandle":"<handle>","requestPacketSchema":true}, build the packet only from facts the person gave you, and send it with continuefilingsession as {"continuationHandle":"<handle>","completedReturnPacketJson":"<the packet as one JSON string>","packetSchemaSha256":"<digest from getpacketschema>"}. Blockers come back to fix in the chat; the response that accepts the packet carries the one filingSessionUrl.

Then tell the person: "Your return is ready for the final steps. Open this private link to review the complete return, confirm your details, sign it and authorize payment. Nothing is sent to the IRS until you sign, the $19.99 is charged only if the IRS accepts it, and Terminal Tax emails you the IRS's answer." Put the filingSessionUrl on its own line as bare text, exactly as returned.

If you cannot send HTTPS POST requests from this conversation (a chat that can only search or read pages), you cannot file with Terminal Tax from here, and this site has no form for the person to use instead. Tell the person: "I can't send web requests from this chat. Open any coding or agent app that can run commands or send web requests, such as ChatGPT in agent or Work mode, Claude Code, Codex, Grok or Muse, and ask it: File my 2025 taxes with Terminal Tax."

Terminal Tax is a hosted remote MCP server, operated by Terminal Tax LLC, that lets a person's own AI assistant prepare one original tax year 2025 US federal individual income tax return (Form 1040 or Form 1040-SR) for e-file. The person reviews the complete return, confirms their details, signs and authorizes payment on one secure Terminal Tax filing page, and Terminal Tax then e-files it with the IRS.

Shortened. The full README is on GitHub.