Terminal Tax MCP Server

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.

Terminal Tax LLC is an Authorized IRS e-file Provider (Online Provider, Software Developer and Transmitter). Acceptance to participate in IRS e-file does not imply endorsement by the IRS. Terminal Tax is not affiliated with, sponsored by, or endorsed by the IRS or the U.S. Treasury.

Connect

• Endpoint (Streamable HTTP): https://mcp.terminal.tax/v1/hosted-mcp
• No account, API key, OAuth or install. Any assistant that can run a shell command or make an HTTPS request (Claude Code, Codex, Cursor and similar) calls it directly with JSON-RPC POSTs.
• Claude.ai and ChatGPT in a web browser add the same address as a custom connector; steps at https://terminal.tax/integrations.
• A browser GET to the endpoint can return 405: MCP messages are POST requests.

Tools

• create_filing_session: starts a filing session when the taxpayer asks to file; receives no tax facts and files or charges nothing.
• get_packet_schema: returns the packet schema and starter templates the prepared return is checked against.
• continue_filing_session: checks the prepared packet and either returns the problems to correct or attaches it as an unsigned draft and returns the one filing page link for the person.
• get_filing_status: status-only results for the filing; never return content, identity or payment data.

Scope

• One original tax year 2025 US federal Form 1040 or 1040-SR per session (and a narrow Form 1040-SS).
• No state, territory or local return; no amended return (1040-X), extension (4868) or Form 1040-NR.
• Supported and refused situations: https://terminal.tax/llms.txt. Anything unsupported comes back as a named blocker.

Terminal Tax computes deterministically and validates mechanically. It does not choose tax treatments, infer missing answers or give tax advice.

Privacy

Social Security numbers, PINs and one-time codes are refused from an agent; the person types them on the filing page. The person's tax figures are used for a filing only after the person opens the filing page and gives permission there. Card details go only into the payment processor's fields. Privacy notice: https://terminal.tax/privacy-notice

Price

$19.99 per federal return, charged only if the IRS accepts it.

Operator

Terminal Tax LLC, a New Jersey limited liability company. Support: support@terminal.tax. Legal and privacy: legal@terminal.tax. About: https://terminal.tax/about. Terms: https://terminal.tax/terms.

Client configuration

Claude Code:

claude mcp add --transport http terminal-tax https://mcp.terminal.tax/v1/hosted-mcp

Codex:

codex mcp add terminal-tax --url https://mcp.terminal.tax/v1/hosted-mcp

Cursor, VS Code and other clients that read .mcp.json: see .mcp.json in this repository.

Gemini CLI:

gemini extensions install https://github.com/maxdhs/terminal-tax-mcp-server

About this repository

This repository holds only this description, the MCP Registry server.json, client configuration files and the logo. It contains no code and nothing to run: the server is hosted by Terminal Tax LLC.

Demo

demo/terminal-tax-demo.mp4: a two-minute recording on the Terminal Tax test environment (app.terminal.tax) with a synthetic taxpayer; nothing is filed. It shows the assistant's tool calls, the accepted packet and the hosted filing page up to the card step, before signing.