IRS SOI (Income By ZIP)
Inspect IRS Statistics of Income aggregates by ZIP—AGI distribution, tax, credits, and deductions—while defining who can afford your offer.
Overview
IRS SOI (income by ZIP) is an MCP server for the Idea phase that exposes IRS income and tax statistics by ZIP—AGI, tax, credits, and deductions—from a local store in your agent.
What is this MCP server?
- IRS SOI income and tax statistics aggregated by ZIP inside the agent
- Local SQLite store with optional SOI_MCP_STORE path override
- PyPI stdio package mcpwright-soi (version 0.1.1)
- AGI distribution, tax, credits, and deductions oriented fields
- Complements Census ACS with tax-return-based income pictures
- Server version 0.1.1; PyPI identifier mcpwright-soi
- Local SQLite store with optional SOI_MCP_STORE override
- Stat families: AGI distribution, tax, credits, deductions by ZIP
What problem does it solve?
You lack a fast way to compare ZIP-level income and tax aggregates while debating pricing and audience fit inside your coding agent.
Who is it for?
U.S.-focused indie builders pairing tax-return-based income signals with positioning, tier design, or geo expansion lists.
Skip if: Household-level tax prep, non-U.S. markets, or teams that require certified financial compliance outputs from the agent alone.
What do I get? / Deliverables
Once soi-mcp is registered, your agent can pull IRS SOI-style ZIP stats from the local SQLite store to sharpen who you are building for.
- ZIP-level AGI, tax, credit, and deduction aggregates reachable from agent chat
- Persistent local SQLite store for repeated SOI lookups
- Clearer affordability assumptions for ICP and pricing notes
Recommended MCP Servers
Journey fit
Idea is where income and tax posture shape ICP, pricing hypotheses, and geographic focus before you validate with landing tests. Audience subphase is the right shelf because SOI ZIP tables describe spending power and tax behavior, not product shipping or ops monitoring.
How it compares
IRS SOI ZIP aggregates MCP—not SEC EDGAR filings and not Census ACS survey demographics.
Common Questions / FAQ
Who is IRS SOI (Income By ZIP) for?
Solo builders researching U.S. ZIP-level income and tax aggregates inside Claude Code, Cursor, or similar agents during audience definition.
When should I use IRS SOI (Income By ZIP)?
Use it during Idea audience work when AGI distribution, deductions, or credits by ZIP inform whether your price and channel match reality.
How do I add IRS SOI (Income By ZIP) to my agent?
Install mcpwright-soi from PyPI, optionally set SOI_MCP_STORE for the SQLite path, add the stdio MCP server to your agent config, then query ZIP income and tax stats via MCP tools.