Irs Taxpayer
Deterministic US federal tax estimates for 2024 to 2026 through 45 local tools
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 1.2.7
- Listing updated
- today
Similar MCP servers
About Irs Taxpayer
Irs Taxpayer is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add irs-taxpayer -- npx -y irs-taxpayer-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"irs-taxpayer": {
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"irs-taxpayer": {
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"irs-taxpayer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"irs-taxpayer": {
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"irs-taxpayer": {
"command": "npx",
"args": [
"-y",
"irs-taxpayer-mcp"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
MIT licensed
Irs Taxpayer 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.

