Terminal Tax — Claude Code MCP server: what it does, how to install
Terminal Tax sends tax data from an assistant conversation to calculate and e-file with the IRS. Useful when tax forms are already sorted in chat and need direct submission.
MIT ★ 2 updated 2026-10-27
claude mcp add --transport http filing https://mcp.terminal.tax/v1/hosted-mcpWhat Terminal Tax does
Terminal Tax connects coding assistants to an Authorized IRS e-file Provider operated by Terminal Tax LLC. Your agent takes the facts from tax documents and sends JSON-RPC 2.0 requests to https://mcp.terminal.tax/v1/hosted-mcp. The remote software checks the data packet, computes the return, and flags any missing entries back to the chat.
Sensitive identity credentials stay out of the prompt window. Social Security numbers, signing PINs, and payment approvals are submitted exclusively on a dedicated private webpage where you inspect the finished forms. The $19.99 fee is charged only after the IRS accepts the return.
Agents restricted from outbound web requests cannot reach the remote endpoint. In web-based Claude Code sessions, network permissions must explicitly permit connections to terminal.tax and mcp.terminal.tax before filing can begin.
What it helps with
- e-file tax returns to the IRS straight from an agent chat
- validate tax data packages against IRS filing rules
- bypass retyping figures into standalone tax filing web forms
Example prompts for the agent
- File my taxes with terminal.tax
- Send my calculated return details to Terminal Tax for validation
How to install Terminal Tax
Platform CLI: remote server
claude mcp add --transport http filing https://mcp.terminal.tax/v1/hosted-mcpPlatform CLI: remote server
codex mcp add terminal-tax --url https://mcp.terminal.tax/v1/hosted-mcpConfig file
{
"mcpServers": {
"terminal-tax": {
"url": "https://mcp.terminal.tax/v1/hosted-mcp"
}
}
}Config file
{
"servers": {
"terminal-tax": {
"type": "http",
"url": "https://mcp.terminal.tax/v1/hosted-mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http terminal-tax https://mcp.terminal.tax/v1/hosted-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Terminal Tax
How to install Terminal Tax in Claude Code?
Run claude mcp add --transport http terminal-tax https://mcp.terminal.tax/v1/hosted-mcp in your terminal. It connects directly over HTTPS without local package installs or API keys.
What does Terminal Tax do?
It receives tax facts compiled by your agent, performs return calculations, validates IRS compliance checks, and generates a private page for you to review and sign.
Are Social Security numbers passed through the AI chat?
No, SSNs and signing PINs are never included in MCP payloads; you enter them manually on the private review page prior to submission.