Tax software: your AI agent sends the facts, we calculate and e-file; you review and sign.
tax.terminal/filing — Model Context Protocol (MCP) Server
The tax.terminal/filing MCP server is described as enabling e-file submission of a 2025 US federal Form 1040. It supports a workflow where an AI assistant prepares the form, and the user reviews and signs on one hosted page.
🛠️ Key Features
E-file a 2025 US federal Form 1040
Review and sign on one hosted page
Intended to be used from an AI assistant
🚀 Use Cases
Preparing and submitting a US federal income tax return for 2025 Form 1040
Collecting user review and signature in a hosted interface
⚡ Developer Benefits
Integrates a single hosted review/sign step into an AI-assisted tax filing flow
⚠️ Limitations
No additional capabilities, tool count, or supported forms beyond “Form 1040” are provided in the available server data
Starts a filing session for a US federal individual income tax return when the taxpayer asks to file. Input: none. Output: a continuationHandle that identifies this filing session in later calls, and packetRules, the packet rules as text. This call receives no tax facts and creates no return and no link; the filing link comes with an accepted packet. A new filing session is also how a fresh link replaces one that expired or was left unfinished, through which nothing was filed or charged: the same packet sent on the new handle returns the new link.
Covered returns: one original tax year 2025 US federal individual income tax return (Form 1040 or 1040-SR, and some Form 1040-SS and Form 1040-NR situations), with no state or local return. The packet rules this call returns list each covered and refused situation.
Takes the filing session's continuationHandle. Returns the packet schema a completed return packet is checked against (the packet holds no Social Security number, ITIN or PIN: the taxpayer types those on the filing page): requestPacketSchema=true returns the schema digest (packetSchemaSha256, sent with the completed packet), an outline whose larger parts are named sections, the section list and the packetStarterTemplates list; packetSchemaSection=<name> returns one section and packetStarterTemplate=<id> one complete starter packet, in which each taxpayer-specific value is the placeholder REPLACE_WITH_TAXPAYER_VALUE, refused by path until replaced, with its askTheTaxpayer messages (the questions for the taxpayer) and each preset answer listed in presets with how it is settled. Read-only: no tax facts are sent here and no return is written. The tax year is return.taxYear=2025 inside the packet, not a tool argument; any other argument is refused by name.
Parameters4
continuationHandle
string
optional
requestPacketSchema
boolean
optional
Returns the packet schema outline, its section list and digest, and the starter-template list; no tax facts are sent and no return is written.
packetSchemaSection
string
optional
One section of the packet schema, by a name from packetSchemaSections. Returns that section's members exactly as they sit in the full schema, where the outline shows {"x-section":"<name>"}, with the section's own sha256.
packetStarterTemplate
string
optional
One complete starter packet, by an id from packetStarterTemplates.templates, with its askTheTaxpayer messages and its presets.
Raw schema
{
"type": "object",
"properties": {
"continuationHandle": {
"type": "string",
"maxLength": 160
},
"requestPacketSchema": {
"type": "boolean",
"const": true,
"description": "Returns the packet schema outline, its section list and digest, and the starter-template list; no tax facts are sent and no return is written."
},
"packetSchemaSection": {
"type": "string",
"enum": [
"agent-identity",
"people",
"wages-retirement-benefits",
"investments",
"other-income-deductions-payments",
"business",
"rental-farm",
"farm-rental",
"additional-businesses",
"partnership-k1",
"partnership-k1-treatment",
"s-corporation-k1",
"s-corporation-k1-treatment",
"choices-required",
"choices-family-education",
"choices-health-retirement",
"choices-premium-tax-credit",
"choices-energy-vehicle",
"choices-less-common",
"choices-foreign-income",
"choices-foreign-assets",
"choices-unbuilt-situations",
"federal-documents",
"form-1040ss",
"form-1040ss-business-property",
"form-1040nr"
],
"description": "One section of the packet schema, by a name from packetSchemaSections. Returns that section's members exactly as they sit in the full schema, where the outline shows {\"x-section\":\"<name>\"}, with the section's own sha256."
},
"packetStarterTemplate": {
"type": "string",
"enum": [
"single_w2_refund",
"single_w2_1099int_refund",
"single_w2_1099div_refund",
"single_two_w2_refund",
"mfj_two_w2_refund",
"mfj_retired_ssa1099_1099int_refund",
"single_w2_balance_due",
"form1040ss_puerto_rico_schedule_c",
"form1040nr_single_w2_refund",
"form1040nr_schedule_c"
],
"description": "One complete starter packet, by an id from packetStarterTemplates.templates, with its askTheTaxpayer messages and its presets."
}
},
"additionalProperties": false,
"oneOf": [
{
"required": [
"requestPacketSchema"
],
"not": {
"anyOf": [
{
"required": [
"completedReturnPacketJson"
]
},
{
"required": [
"packetSchemaSha256"
]
},
{
"required": [
"packetSchemaSection",
"packetStarterTemplate"
]
}
]
}
},
{
"required": [
"packetSchemaSection"
],
"not": {
"anyOf": [
{
"required": [
"completedReturnPacketJson"
]
},
{
"required": [
"packetSchemaSha256"
]
},
{
"required": [
"requestPacketSchema"
]
},
{
"required": [
"packetStarterTemplate"
]
}
]
}
},
{
"required": [
"packetStarterTemplate"
],
"not": {
"anyOf": [
{
"required": [
"completedReturnPacketJson"
]
},
{
"required": [
"packetSchemaSha256"
]
},
{
"required": [
"requestPacketSchema"
]
},
{
"required": [
"packetSchemaSection"
]
}
]
}
}
]
}
continue_filing_session
Checks the taxpayer's completed draft packet for a federal return and, when it passes, holds it as an unsigned draft and returns the link to the filing page; otherwise returns a list of problems to correct. This call files nothing and sends nothing to the IRS: the taxpayer reviews, signs and files on the filing page.
Inputs: the filing session's continuationHandle, completedReturnPacketJson (the whole packet as one JSON string, in this server's packet schema) and packetSchemaSha256 (that schema's digest); other arguments are refused by name. The tax year is return.taxYear=2025 inside the packet. The packet carries the facts the taxpayer stated in this chat and the figures printed on documents the taxpayer gave in it; a fact the taxpayer has not stated is left out rather than written as no, none or 0, and a required fact that is left out comes back as a blocker asking for the taxpayer's answer.
Output: status filing_session_ready with a filingSessionUrl when the packet is accepted; the taxpayer opens that link to give permission, review the return and sign it. Otherwise, blockers (each with a path, a rule and a plain detail) and no link; that packet is not kept, and the same handle accepts a corrected packet. Nothing is filed or charged through a link that expires or is left unfinished, and the same packet sent again with a new filing session's handle returns a fresh link. An accepted packet is held until the taxpayer gives permission on the filing page; declining there, or expiry, erases it. Federal returns: no state, territory or local return is filed. The return has no taxpayer identity fields: the taxpayer's own details go in the packet's separate, required agentIdentity section, which the filing page shows for the taxpayer to confirm. Business identifiers printed on each source form, such as an employer's or payer's name and EIN, are packet fields.
Parameters3
continuationHandle
string
optional
completedReturnPacketJson
string
optional
The complete return packet as one JSON string, in this server's packet schema. Its values are the facts the taxpayer stated and the figures printed on the taxpayer's documents.
packetSchemaSha256
string
optional
The current digest returned by get_packet_schema. The server checks it against the current packet schema; packet-schema-stale means the submitted digest no longer matches that schema.
Raw schema
{
"type": "object",
"properties": {
"continuationHandle": {
"type": "string",
"maxLength": 160
},
"completedReturnPacketJson": {
"type": "string",
"maxLength": 65536,
"description": "The complete return packet as one JSON string, in this server's packet schema. Its values are the facts the taxpayer stated and the figures printed on the taxpayer's documents."
},
"packetSchemaSha256": {
"type": "string",
"minLength": 64,
"maxLength": 64,
"pattern": "^[0-9a-f]{64}$",
"description": "The current digest returned by get_packet_schema. The server checks it against the current packet schema; packet-schema-stale means the submitted digest no longer matches that schema."
}
},
"additionalProperties": false,
"oneOf": [
{
"required": [
"completedReturnPacketJson",
"packetSchemaSha256"
]
}
]
}
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:
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).
Each request is a JSON-RPC 2.0 POST with the headers Content-Type: application/json and
Accept: 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.
create_filing_session: opens an empty filing session. It carries no tax data, files and charges nothing, and
returns a continuationHandle and 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;
packetSchemaSection and packetStarterTemplate return 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 one filingSessionUrl.
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.
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.
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.