Terminal Tax
OfficialThis server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Terminal Tax
Edited test demonstration, pauses shortened. Watch the MP4.
Let ChatGPT or Claude file your taxes directly with the IRS.
No plugin, connector or install. Your AI agent sends HTTPS POST requests (JSON-RPC 2.0) to
https://mcp.terminal.tax/v1/hosted-mcp itself, with whatever web or request tool it has, starting with
create_filing_session:
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":"tools/call","params":{"name":"create_filing_session","arguments":{}}}'Terminal Tax is an Authorized IRS e-file Provider: your AI agent sends the return you worked out together, you review and sign it yourself, and we e-file it with the IRS. Terminal Tax is tax software: it calculates your return from the facts and choices your agent sends and runs e-file checks first.
Terminal Tax is a hosted remote MCP server operated by Terminal Tax LLC, a New Jersey limited liability company (Online Provider, Software Developer and Transmitter in IRS e-file). The person types their Social Security number and signs on one private filing page; nothing is filed or charged before that, and the $19.99 fee is charged only if the IRS accepts the return. Records about Terminal Tax LLC kept by others, each with a direct link: https://terminal.tax/verify. Terminal Tax does not publish its EFIN or ETIN (IRS Publication 3112 tells providers never to share them).
Endpoint
URL:
https://mcp.terminal.tax/v1/hosted-mcp(MCP Streamable HTTP)Each request is a JSON-RPC 2.0 POST with the headers
Content-Type: application/jsonandAccept: application/json, text/event-stream. No Authorization header, account, API key or OAuth.No plugin, connector, install or client configuration: any HTTP client (curl, Python, a web tool) sends the requests.
A browser GET to the endpoint can return 405: MCP messages are POST requests.
Related MCP server: SooTool
Requests
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 full reference, with every request body, is https://terminal.tax/llms.txt.
Tools
create_filing_session: opens an empty filing session. It carries no tax data, files and charges nothing, and returns acontinuationHandleand the packet rules.get_packet_schema: with{"continuationHandle":"<handle>","requestPacketSchema":true}, returns the packet schema's digest, an outline whose larger parts are named sections, and the starter-template list;packetSchemaSectionandpacketStarterTemplatereturn one section or one template at a time. It is read-only.continue_filing_session: with{"continuationHandle":"<handle>","completedReturnPacketJson":"<packet as one JSON string>","packetSchemaSha256":"<digest>"}, checks the packet. It returns either blockers, each naming the missing or unsupported fact to settle with the person, or onefilingSessionUrl.
The filingSessionUrl is for the person, as returned. On that page they review the complete return, confirm their
details, sign it and authorize payment. No tool reports the IRS result; Terminal Tax emails it to the person.
Data boundaries
The packet carries tax facts from the person's own forms, their filing choices, and their identity details (name, address, date of birth, contact details, and any refund or payment bank account).
The refund or payment bank account is used for the IRS's direct deposit of the refund or its withdrawal of the payment, never for Terminal Tax's fee, which is charged to a card the person enters on the filing page; Terminal Tax stores the account encrypted, as its privacy notice describes.
Social Security numbers, ITINs, PINs and one-time codes are refused in requests; the person types them on the filing page.
Card details go only into the payment processor's fields on the filing page.
Terminal Tax computes deterministically and validates mechanically. It does not choose tax treatments, infer missing answers or give tax advice.
Privacy notice: https://terminal.tax/privacy-notice
Claude Code on the web: network access
Claude Code on the web (claude.ai/code) runs in a cloud environment with a network allowlist. If a request to
mcp.terminal.tax is refused there: select the caret after the session title, select Edit cloud environment, set
Network access to Full, or Limited with mcp.terminal.tax and terminal.tax in Allowed domains, and select Save
changes. The open session picks up the change within about a minute.
Operator
Terminal Tax LLC. Support: support@terminal.tax. Legal and privacy: legal@terminal.tax. About: https://terminal.tax/about. Terms: https://terminal.tax/terms. Questions and answers: https://terminal.tax/chatbot-e-file.
This repository
This repository holds this description, the MCP Registry server.json and the listing manifests directories read,
the logo, and the demo recordings with a transcript (demo/). It contains no code: the server is hosted by
Terminal Tax LLC.
Demo: video (MP4) (YouTube), an edited test demonstration with pauses shortened. Earlier recordings: demo/terminal-tax-demo-1.2.0.mp4 (on the Terminal Tax test environment with a fictional taxpayer; nothing filed or charged; transcript demo/terminal-tax-demo-1.2.0.md) and demo/terminal-tax-demo.mp4 (the assistant's tool calls in a terminal).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Verifiable US tax oracle for AI agents: cited, machine-checkable federal and state tax computation
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Pay-per-call agent infrastructure: file storage & handoff, compute tools, messaging, e-sign, KYC.
Pay-per-use tool API for AI agents. Free tier, x402 USDC micropayments, or API key.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceA public, no-auth remote MCP server that exposes Arc & Ledger's free tax calculators and intake funnel as tools inside AI assistants. Provides tools for IRS notice explanation, FBAR/FATCA, LLC vs S-Corp comparison, quarterly tax estimates, and more.-
- AlicenseAqualityBmaintenanceEnables LLM agents to perform precise decimal-only calculations across tax, payroll, finance, statistics, engineering, and other domains, returning calculation traces and verifiable receipts. It supports batched and pipelined tool calls with policy-aware, date-sensitive computations.28630 PyPI8MIT
- AlicenseNot gradedqualityBmaintenanceEnables an AI assistant to manage tax documents, run the filing interview, work with forms, and prepare a US federal return locally. It supports the workflow through to printing/mailing or entering the return in IRS Free File Fillable Forms.AGPL 3.0
- AlicenseAqualityBmaintenanceEnables AI assistants to retrieve 2027 and 2026 federal income tax brackets, standard deductions, calculated federal income tax with bracket breakdowns and year-over-year comparisons, and other tax amounts using IRS Revenue Procedure data without network calls or API keys.41MIT