Log inSubmit server
Irs Taxpayer logo

Irs Taxpayer

Local MCP tax engine for estimating US federal and supported state taxes, deductions, credits, retirement planning, and quarterly payments.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Irs Taxpayer

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "irs-taxpayer": {
      "command": "npx",
      "args": [
        "-y",
        "irs-taxpayer-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 44 tools correctly (7d ago).

Overview

The irs-taxpayer MCP server exposes a deterministic local tax engine for US individual tax estimation and planning. It provides MCP tools for federal calculations, filing-status comparisons, quarterly estimates, deductions, credits, retirement topics, and supported state-tax paths, with direct CLI commands available for local-only workflows. Run it over standard input/output, Docker, or streamable HTTP; no IRS login or SSN is required. Reach for it when an AI assistant needs structured tax estimates, but verify results with a qualified tax professional because laws, supported years, and state coverage can change.

Use cases

  • Estimate federal tax from income, filing status, and dependents
  • Compare filing statuses for a tax-planning scenario
  • Calculate quarterly estimated payments for freelance income
  • Evaluate supported deductions, credits, and retirement strategies

Key features

  • Deterministic local tax calculations
  • Federal and supported state tax estimates
  • Quarterly payment and withholding estimates
  • Structured tax-plan results with calculation traces
  • Direct CLI and MCP interfaces
  • Streamable HTTP transport

Tools44

What Irs Taxpayer lets your agent do. Expand a tool for its parameters.

Verified live~13.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/5 checks healthy over the last 35d

What it can do

From the 44 tools this server returned when we ran it; 44 declare their own safety hints.

Makes network requests · 1Read-only tools · 44
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age239 days
Maintainers1

Observed 2026-10-15 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · irs-taxpayer-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars13Stargazers on the source repository.
npm downloads1.8kPackage downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed44Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Irs Taxpayer works

What irs-taxpayer MCP server does

The irs-taxpayer MCP server gives an MCP-compatible assistant access to a local tax estimation and planning engine for US individual taxpayers. It works from tax facts supplied by the user or a local facts file and returns human-readable text alongside structured results. The project includes federal calculations, selected credits and deductions, retirement-planning topics, estimated quarterly payments, filing-status comparisons, and explicitly supported state-tax paths.

The calculation model includes federal brackets and selected provisions modeled for tax year 2025, including OBBB provisions described by the project. Unsupported tax years, state profiles, or required worksheet inputs fail closed rather than producing a rough estimate. Results are educational estimates, not tax, legal, or financial advice.

How it works

The MCP adapter lets an AI client turn natural-language requests into tool arguments. Available tools include calculate_federal_tax, get_tax_brackets, compare_filing_statuses, estimate_quarterly_tax, calculate_total_tax, calculate_w4_withholding, and the generate_tax_plan workflow. The latter returns structured domain results, assumptions, source provenance, a calculation trace, and stated unsupported boundaries.

The underlying engine runs locally and makes no runtime network requests, telemetry calls, or automatic persistence. Public IRS data is bundled and versioned with the software. The server itself does not send or store taxpayer data, but information entered into a cloud-hosted MCP client may be processed by that client’s model provider. Use direct CLI mode or a local-model client when facts must remain local end to end.

Setup and configuration

Install the package globally or run it through npx. For MCP mode, add a stdio entry with the package command to an MCP client configuration, then restart the client. The README provides configurations for Claude Desktop, Kiro, and Cursor. Docker can also run the server interactively.

For a direct local workflow, use intake to collect facts, template to create a strict JSON template, validate to check a facts file, and plan to calculate results. These commands do not start MCP or invoke a model. Facts files are limited to 1 MiB, reject unknown fields and symbolic links, and omit names, SSNs, addresses, employer IDs, and account numbers. New POSIX files use mode 0600; existing files require an explicit force option before replacement.

The server also supports streamable HTTP with --http, using /mcp and a health endpoint at /health. HTTP mode is stateless and binds to loopback by default. Browser access requires an exact allowed Origin configured with a repeatable flag. The older --sse option is retained only as a deprecated alias.

Tools and capabilities

  • Calculate federal tax with bracket detail and supported AMT, NIIT, Medicare, QBI, self-employment, capital-gains, and child-tax-credit components.
  • Compare all four filing statuses for the same income.
  • Estimate quarterly payments with safe-harbor guidance.
  • Combine federal and supported state estimates with take-home and monthly-income figures.
  • Estimate paycheck withholding and generate a structured tax plan.
  • Inspect brackets and standard deductions by filing status and year.

Limitations and notes

Coverage is limited to the tax years, state profiles, and facts implemented by the engine. Tax rules change frequently, and calculations can contain omissions or errors. The project authors are not tax professionals, CPAs, enrolled agents, or attorneys, and using the software does not create a professional-client relationship. Confirm filing decisions with a qualified tax professional.

The irs-taxpayer MCP server requires careful privacy decisions when used through an AI host. Although its own engine is local and does not make network requests, prompts and tool arguments can leave the machine through the selected MCP client or model provider. No IRS account authentication or taxpayer identity is needed.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Irs Taxpayer

irs-taxpayer is an MCP server that connects AI assistants to a local deterministic tax engine using bundled public IRS data. Its main tools calculate federal and combined tax, compare filing statuses, estimate quarterly payments, inspect brackets, estimate withholding, and generate structured tax plans for supported US taxpayer scenarios.

Install it with `npm install --global irs-taxpayer-mcp`, or configure an MCP client to run `npx -y irs-taxpayer-mcp`. Restart the client after saving its MCP configuration.

Yes, irs-taxpayer works with Cursor through its MCP settings. Add the same stdio configuration shown for the package, using `npx` with `-y irs-taxpayer-mcp`, then restart Cursor.

Yes, direct CLI mode keeps fact collection and calculation local and does not invoke a model or send facts over the network. MCP mode also makes no network requests, but facts entered through a hosted MCP client may be processed by that client’s model provider.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewIrs Taxpayer AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/irs-taxpayer?style=directory)](https://allmcps.com/mcp/irs-taxpayer)
HTML Embed
<a href="https://allmcps.com/mcp/irs-taxpayer"><img src="https://allmcps.com/api/badge/irs-taxpayer?style=directory" alt="Irs Taxpayer on AllMCPs" /></a>