1. Conduid
  2. Files
  3. IRS SOI (income by ZIP)
MCP server · Files

IRS SOI (income by ZIP)

by · github.com/mcpwright/soi-mcp

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

Unclaimed files
InstallView source
37Low

Scored 4 months ago · breakdown

About IRS SOI (income by ZIP)

IRS SOI (income by ZIP) is an MCP server published by mcpwright in the Files category: iRS income & tax stats by ZIP in your agent: AGI distribution, tax, credits, deductions.

Recent commit activity is the strongest signal that reported issues will get attention.

Install

uvx
uvx mcpwright-soi
pip
pip install mcpwright-soi

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (10)

compare_zips(zips, metric)Rank several ZIPs by one metric (e.g. `avg_agi_per_return`, `pct_returns_200k_plus`, `total_tax_liability`, `eitc_amount`), highest first.

Parameters not published.

get_agi_distribution(zip_code)**The distinctive one.** The ZIP's returns and AGI split across the six IRS AGI brackets (<$25k, $25–50k, $50–75k, $75–100k, $100–200k, $200k+), with each bracket's share — the income *shape* of a ZIP, not just an average.

Parameters not published.

get_credits(zip_code)EITC take-up (overall and split by number of qualifying children: none / one / two / three or more) and the additional (refundable) child tax credit.

Parameters not published.

get_deductions(zip_code)Standard vs. itemized deductions (count and amount), the taxes-paid (SALT) deduction, and the percent of returns that itemized.

Parameters not published.

get_filing_status(zip_code)Single / married-filing-jointly / head-of-household return counts, elderly returns (age 65+), and the count and share of electronically filed returns.

Parameters not published.

get_income(zip_code)Adjusted gross income (AGI), average AGI per return, and income components: salaries/wages, taxable interest, ordinary dividends, business net income, net capital gain.

Parameters not published.

get_soi_field(zip_code, field)Escape hatch: the raw value of one SOI field code (e.g. `A00100` for AGI, `N1` for returns) for a ZIP, summed across brackets, with its label and unit. Limited to the fields in the store.

Parameters not published.

get_state_totals(state)A whole state's totals and AGI-bracket mix (returns, individuals, AGI, average AGI per return, income tax, total tax liability), from the IRS state rollup. Accepts `"CA"` or `"California"`.

Parameters not published.

get_tax(zip_code)Income tax, income tax before credits, total tax liability (broader — includes self-employment tax, etc.), total tax payments, and average total tax per return.

Parameters not published.

lookup_zip(zip_code)Confirm a ZIP has SOI data → state, number of returns, number of individuals, tax year. A good first call.

Parameters not published.

Ask AI

✦

Ask AI about IRS SOI (income by ZIP)

Powered by Claude · Grounded in docs

I know everything about IRS SOI (income by ZIP). Ask me about installation, configuration, usage, or troubleshooting.

Security checks

6 checks have not been run yet.

Questions

About IRS SOI (income by ZIP)

How do I install IRS SOI (income by ZIP)?

Run uvx mcpwright-soi, then add the server to your MCP client's configuration.

Is IRS SOI (income by ZIP) safe to use with an AI agent?

Its trust score is 37 out of 100 (low). Conduid hasn't run static security checks on this repository yet, so review the source yourself before granting it credentials. It has no ConduID identity yet, so agent calls to it are not receipted.

Is IRS SOI (income by ZIP) still maintained?

Yes — the last commit was 2 months ago. The repository has 0 stars and 0 forks.