MCP.Market

IRS SOI (income by ZIP) MCP server

by mcpwright·io.github.mcpwright/soi-mcp·v0.1.2
No reviews yet

IRS income & tax stats by ZIP in your agent: AGI distribution, tax, credits, deductions.

A86/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A86/100

full report

Adoption
New

0 stars31 downloads/wk

Reviews

Write one

Nobody has reviewed IRS SOI (income by ZIP) yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

IRS SOI (income by ZIP) tools (10)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • compare_zips

    Rank several ZIPs by a single metric, highest value first.

  • get_agi_distribution

    The income distribution of a ZIP across the six IRS AGI brackets.

  • get_credits

    Refundable-credit take-up for a ZIP: the EITC and additional child tax credit.

  • get_deductions

    Deduction measures for a ZIP: standard vs. itemized, plus SALT.

  • get_filing_status

    Filing-status mix for a ZIP: single / married-joint / head-of-household.

  • get_income

    Income measures for a ZIP: AGI, average AGI per return, and components.

  • get_soi_field

    Raw value of a single SOI field for a ZIP — an escape hatch.

  • get_state_totals

    State-level SOI totals and AGI distribution from the IRS state rollup.

  • get_tax

    Tax measures for a ZIP: income tax, total liability, and average per return.

  • lookup_zip

    Confirm a ZIP has SOI data and return its return and individual counts.

Public scan report

scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it

no findings
  • Code scan9 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 73 days ago12/15
  • Maintainer identityregistry namespace matches repository owner7/10
Overall 86/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How IRS SOI (income by ZIP) compares

Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
86/100
higher than 75% of 4,460 AI and agents servers
Tools
10
the typical AI and agents server has 6
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
31
more than 18% of 1,538 AI and agents servers with a package

What its tools let an agent do: 10 read

Install IRS SOI (income by ZIP) in Claude Code, Cursor or VS Code

claude mcp add soi-mcp -- uvx mcpwright-soi
Add to Cursor

What the publisher says

From the IRS SOI (income by ZIP) repository's README, as published. We do not edit it. Read it on GitHub

soi-mcp

<!-- mcp-name: io.github.mcpwright/soi-mcp -->

IRS income & tax statistics by ZIP code, inside your agent. An MCP server that lets an LLM pull the income distribution, tax, credits, and deductions of any U.S. ZIP straight from the IRS Statistics of Income (SOI) — built on Anthropic's official mcp Python SDK.

All tools are read-only and the data is public domain (a U.S. government work) — no API key required. The dataset is downloaded once into a local SQLite store and served offline.

Status: published — uvx mcpwright-soi (PyPI) and listed in the official MCP Registry as

io.github.mcpwright/soi-mcp. 10 tools, working today (see below). The IRS SOI ZIP release lags ~2–3 years; the

latest available year (currently Tax Year 2022) loads by default, and older years are one

refresh away. See the roadmap for what's next.

Tools

All dollar amounts are returned in whole USD (the source reports thousands). Counts are numbers of returns, rounded by the IRS to the nearest 10.

Install

Requires Python 3.12+. The zero-clone way to run it (the PyPI package is mcpwright-soi; the command, server, and tools are all "soi"):

uvx mcpwright-soi

The first tool call downloads the latest SOI ZIP file (~200 MB) into a local SQLite store under your OS cache directory and serves everything offline thereafter. To pre-load (or to pick a specific tax year) without waiting for the first query:

uvx mcpwright-soi setup            # download the latest available year
uvx mcpwright-soi refresh 2021     # re-pull a specific older year for comparison

Claude Code

claude mcp add soi -- uvx mcpwright-soi

Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "soi": { "command": "uvx", "args": ["mcpwright-soi"] }
  }
}

OpenAI Agents SDK (Python)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

IRS SOI (income by ZIP): common questions

Is IRS SOI (income by ZIP) MCP server safe?
Yes, by our scan: it is graded A (86/100). Read the IRS SOI (income by ZIP) safety report
How do I install IRS SOI (income by ZIP)?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does IRS SOI (income by ZIP) need an API key?
No secret keys are declared. It reads 1 setting from the environment.
Is IRS SOI (income by ZIP) maintained?
The last commit was 76 days ago (2026-08-20). The latest release is v0.1.2.
What can I use instead of IRS SOI (income by ZIP)?
Servers from other publishers that do the same job: Grandet MCP server.
How does IRS SOI (income by ZIP) compare with other AI and agents MCP servers?
safety score 86/100 (higher than 75% of 4,460 AI and agents servers); tools 10 (the typical AI and agents server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to IRS SOI (income by ZIP)

Same job from other publishers: the closest match first, then the best rated.

  • Grandet
    Cheapest API for any model across official, inference and relay providers; find free credits
    A

More from mcpwright →