# Terminal Tax

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2 repo stars
- Author: terminaltax
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/terminaltax/terminal-tax-mcp-server
- Updated: 2026-10-27
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/terminal-tax

## What it 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.

## Requirements
- Remote server: `https://mcp.terminal.tax/v1/hosted-mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http filing https://mcp.terminal.tax/v1/hosted-mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add terminal-tax --url https://mcp.terminal.tax/v1/hosted-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "terminal-tax": {
            "url": "https://mcp.terminal.tax/v1/hosted-mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "terminal-tax": {
            "type": "http",
            "url": "https://mcp.terminal.tax/v1/hosted-mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http terminal-tax https://mcp.terminal.tax/v1/hosted-mcp
```

## When to use it
- 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
- File my taxes with terminal.tax
- Send my calculated return details to Terminal Tax for validation

## Similar
- [tax-penalty-calc](https://affpapa.org/en/nevibecode/skills/tax-penalty-calc.md) — skill · 433 installs
- [mileage-tracker](https://affpapa.org/en/nevibecode/skills/mileage-tracker.md) — skill · 446 installs
- [irs-taxpayer](https://affpapa.org/en/nevibecode/mcp/irs-taxpayer.md) — MCP server · ★ 13 repo stars
- [Aiwyn Tax](https://affpapa.org/en/nevibecode/mcp/aiwyn-tax.md) — MCP server · 6395 installs
- [tax-efficiency](https://affpapa.org/en/nevibecode/skills/tax-efficiency.md) — skill · 756 installs
- [tax-liability-tracking](https://affpapa.org/en/nevibecode/skills/tax-liability-tracking.md) — skill · 473 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
