# Irs Taxpayer

> Irs Taxpayer is an open-source MCP server for finance and payments. Deterministic US federal tax estimates for 2024 to 2026 through 45 local tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/dma9527/irs-taxpayer-mcp
- **MCP Registry name:** io.github.dma9527/irs-taxpayer
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments)
- **Listing updated:** 2026-11-18

## About

This engine does US individual tax arithmetic from IRS annual tables rather than letting a language model guess. The same inputs always give the same answer, it shows its work, and it fails closed: unsupported states, years or missing facts produce an error, not a rough figure. It is for planning and education, and the README says it is not tax advice or filing software.

The README highlights a direct command-line mode that calculates locally and starts no MCP connection, with an intake questionnaire, validate and plan commands that store facts in a strict local JSON file with no identity fields. MCP mode adds 45 tools, but facts typed into an assistant may be processed by its model provider, so the README recommends local mode or a local-model client for private data.

Decisions it addresses include Roth conversions, using the 0% capital gains bracket, itemizing versus the standard deduction, freelancer quarterly estimates, paycheck withholding and moving between states. It is MIT licensed.

## Features

- **Deterministic engine:** Same inputs give the same output, with a calculation trace.
- **Local CLI mode:** Intake, validate and plan commands run with no model or network.
- **Fails closed:** Unsupported states, years or missing facts return errors.
- **Scenario tools:** Roth conversion, capital gains, itemizing and relocation comparisons.
- **Withholding and estimates:** Quarterly estimates and paycheck analysis with W-4 suggestions.
- **Year-over-year changes:** Rule changes between tax years with source citations.

## Good for

- Estimate the tax cost of a Roth conversion before year end
- See how much room is left in the 0% capital gains bracket
- Decide between itemizing and the standard deduction
- Work out quarterly estimated payments as a freelancer
- Compare state tax burdens for a relocation

## Install

### Claude Code (Terminal)

```sh
claude mcp add irs-taxpayer -- npx -y irs-taxpayer-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "irs-taxpayer": {
      "command": "npx",
      "args": [
        "-y",
        "irs-taxpayer-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "irs-taxpayer": {
      "command": "npx",
      "args": [
        "-y",
        "irs-taxpayer-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "irs-taxpayer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "irs-taxpayer-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "irs-taxpayer": {
      "command": "npx",
      "args": [
        "-y",
        "irs-taxpayer-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "irs-taxpayer": {
      "command": "npx",
      "args": [
        "-y",
        "irs-taxpayer-mcp"
      ]
    }
  }
}
```

## Tools

- `simulate_tax_scenario`: Simulates a tax scenario such as a Roth conversion.
- `optimize_capital_gains`: Shows room left in the 0% bracket and loss-offset warnings.
- `standard_vs_itemized`: Compares the standard deduction with itemizing.
- `estimate_quarterly_tax`: Estimates 1040-ES quarterly amounts with safe-harbor guidance.
- `analyze_paycheck`: Projects annual tax from a paycheck and suggests W-4 changes.
- `analyze_relocation_taxes`: Compares tax across supported state profiles.
- `what_changed_between_tax_years`: Lists rule changes between tax years with citations.

## FAQ

### Does it send my tax data anywhere?

The local CLI sends nothing; in MCP mode, data typed into a client may reach that client's model provider.

### Which tax years are supported?

TY2024 through TY2026.

### Is it tax advice?

No. It is for planning and education only.

### Can it run over HTTP?

Yes, with an optional streamable HTTP mode bound to loopback by default.

### Is Irs Taxpayer free?

Yes. Irs Taxpayer is open source, so you can use and self-host it for free.

### How do I add Irs Taxpayer to Claude Code?

Run this command in your terminal: claude mcp add irs-taxpayer -- npx -y irs-taxpayer-mcp

### What are the best alternatives to Irs Taxpayer?

The closest alternatives to Irs Taxpayer are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Crypto Fng](https://ai-powered.com/mcp/crypto-fng): Crypto Fng is a freemium MCP server for finance and payments.
- [Creditcard](https://ai-powered.com/mcp/creditcard): Creditcard is a freemium MCP server for finance and payments.
- [Zovo LEI Lookup](https://ai-powered.com/mcp/zovo-lei-lookup): Zovo LEI Lookup is an MCP server for finance and payments.
- [Recurly](https://ai-powered.com/mcp/recurly): Recurly is a freemium MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/irs-taxpayer
