IRS SOI (income by ZIP)
Pulls IRS Statistics of Income data by ZIP code into your agent without an API key. The dataset downloads once to local SQLite, then serves offline. Ten read-only tools cover income distribution across AGI brackets, tax liability, EITC and child tax credit take-up, SALT deductions, and filing status. The AGI distribution tool is the standout: it shows the income shape of a ZIP (percent of returns under $25k, $25-50k, up to $200k+), not just an average. Compare multiple ZIPs by metric or roll up state totals. Data lags 2-3 years (currently Tax Year 2022). Reach for this when you need granular income and tax stats for neighborhood analysis, policy research, or market segmentation without scraping spreadsheets.
- tools
- 10
- transport
- STDIO
- env var
- 1
- last updated
- Aug 20, 2026
Tools
10 toolsPublic tool metadata for what this MCP can expose to an agent.
lookup_zipConfirm a ZIP has SOI data → state, number of returns, number of individuals, tax year.
Confirm a ZIP has SOI data → state, number of returns, number of individuals, tax year.
No parameter schema in public metadata yet.
get_incomeAdjusted gross income (AGI), average AGI per return, and income components: salaries/wages, taxable interest, ordinary dividends, business net income, net capital gain.
Adjusted gross income (AGI), average AGI per return, and income components: salaries/wages, taxable interest, ordinary dividends, business net income, net capital gain.
No parameter schema in public metadata yet.
get_agi_distributionThe ZIP's returns and AGI split across the six IRS AGI brackets, with each bracket's share.
The ZIP's returns and AGI split across the six IRS AGI brackets, with each bracket's share.
No parameter schema in public metadata yet.
get_taxIncome tax, income tax before credits, total tax liability, total tax payments, and average total tax per return.
Income tax, income tax before credits, total tax liability, total tax payments, and average total tax per return.
No parameter schema in public metadata yet.
get_creditsEITC take-up (overall and split by number of qualifying children) and the additional (refundable) child tax credit.
EITC take-up (overall and split by number of qualifying children) and the additional (refundable) child tax credit.
No parameter schema in public metadata yet.
get_deductionsStandard vs. itemized deductions (count and amount), the taxes-paid (SALT) deduction, and the percent of returns that itemized.
Standard vs. itemized deductions (count and amount), the taxes-paid (SALT) deduction, and the percent of returns that itemized.
No parameter schema in public metadata yet.
get_filing_statusSingle / married-filing-jointly / head-of-household return counts, elderly returns (age 65+), and the count and share of electronically filed returns.
Single / married-filing-jointly / head-of-household return counts, elderly returns (age 65+), and the count and share of electronically filed returns.
No parameter schema in public metadata yet.
compare_zipsRank several ZIPs by one metric, highest first.
Rank several ZIPs by one metric, highest first.
No parameter schema in public metadata yet.
get_state_totalsA whole state's totals and AGI-bracket mix, from the IRS state rollup.
A whole state's totals and AGI-bracket mix, from the IRS state rollup.
No parameter schema in public metadata yet.
get_soi_fieldThe raw value of one SOI field code for a ZIP, summed across brackets, with its label and unit.
The raw value of one SOI field code for a ZIP, summed across brackets, with its label and unit.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
SOI_MCP_STOREOptional path override for the local SQLite store (defaults to the OS cache dir).
Readme
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 asio.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 onerefresh <year>away. See the roadmap for what's next.
Tools
Details
- Repository
- github.com/mcpwright/soi-mcp
- Category
- AI & LLM Tools
- Package
mcpwright-soi- Transport
- STDIO
- Registry
- MCP registry, active
More from mcpwright
Related AI & LLM Tools MCP servers
View all
Relayzeromeltingpixelsai/relayzeroAgent economy on Solana — USDC via x402. Ships a BuyerAgent SDK + relayzero pay CLI.0stars
Meridianmeridianmcp/meridianPersistent memory, task coordination, and HITL queue for AI coding sessions.0stars
Anchorr Mcpmgthompo1/anchorr-mcpAgent-native CRM. 25 tools — contacts, deals, sequences, enrichment waterfall, audit log.0stars
Mcp Servermiddlebrick/mcp-serverScan APIs for OWASP Top 10, LLM, and GraphQL security vulnerabilities.0stars
Mifactory Logic Verifiermifactory-bot/mifactory-logic-verifierVerify AI agent reasoning and logic for errors and contradictions. Pay-per-use.0starsMifactory Spec Apimifactory-bot/mifactory-spec-apiConvert docs to agent-readable specs with criteria and constraints. $0.10/convert.0stars