IRS SOI (income by ZIP)

Name: IRS SOI (income by ZIP)
Author: mcpwright

de mcpwrightversión 0.1.2i★ 0iSe ejecuta en tu computadora

Nombre en el registroio.github.mcpwright/soi-mcp

Cómo instalar

What it does

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

Connects Se ejecuta en tu computadora
Account or key No key needed
Category Contabilidad, finanzas e impuestos

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server IRS SOI (income by ZIP) para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "soi": { "command": "uvx", "args": [ "mcpwright-soi" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de IRS SOI (income by ZIP) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

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

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa IRS SOI (income by ZIP) y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando IRS SOI (income by ZIP) o muestra una herramienta de IRS SOI (income by ZIP) en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

SOI_MCP_STORE Optional path override for the local SQLite store (defaults to the OS cache dir).

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar IRS SOI (income by ZIP)

IRS SOI (income by ZIP) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar IRS SOI (income by ZIP)

Pasos para Claude →Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Pasos para Claude Code →Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para Cursor →Instala Python (uv) en tu computadora primero (una sola vez)
Pasos para VS Code →Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Finance Database✓ ChatGPT
Finance Toolkit✓ ChatGPT
SolidInvoice✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server IRS SOI (income by ZIP) para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user soi -- uvx mcpwright-soi 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de IRS SOI (income by ZIP) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho

Pega este comando y pulsa Enter

claude mcp add --scope user soi -- uvx mcpwright-soi

Hecho

Escribe /mcp en Claude Code
Deberías ver IRS SOI (income by ZIP) en la lista como conectado
Hecho
Pruébalo
Usa IRS SOI (income by ZIP) y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando IRS SOI (income by ZIP) o muestra una herramienta de IRS SOI (income by ZIP) en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

SOI_MCP_STORE Optional path override for the local SQLite store (defaults to the OS cache dir).

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server IRS SOI (income by ZIP) para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "soi": { "command": "uvx", "args": [ "mcpwright-soi" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de IRS SOI (income by ZIP) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa IRS SOI (income by ZIP) y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando IRS SOI (income by ZIP) o muestra una herramienta de IRS SOI (income by ZIP) en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

SOI_MCP_STORE Optional path override for the local SQLite store (defaults to the OS cache dir).

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server IRS SOI (income by ZIP) para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "soi": { "type": "stdio", "command": "uvx", "args": [ "mcpwright-soi" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de IRS SOI (income by ZIP) aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

1
Instala uv (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
uv --version
- Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita
Abrir la página de descarga de uv ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version
Se instala una vez y sirve para todo lo que usa uv
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa IRS SOI (income by ZIP) y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando IRS SOI (income by ZIP) o muestra una herramienta de IRS SOI (income by ZIP) en la respuesta, ya está conectado

1 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

SOI_MCP_STORE Optional path override for the local SQLite store (defaults to the OS cache dir).

Las descripciones siguen en el inglés original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa IRS SOI (income by ZIP)💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user soi -- uvx mcpwright-soi

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "soi": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcpwright-soi"
      ]
    }
  }
}

Valores que debes completar

SOI_MCP_STORE env
Optional path override for the local SQLite store (defaults to the OS cache dir).

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHub i: 0
Descargas por semanai: 21/sem
Licencia i: MIT
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 0.1.2
Categoríai: Contabilidad, finanzas e impuestos
Publicado en el registroi: 21 ago 2026
Último cambio de códigoi: 21 ago 2026
Creador: mcpwright
Paquetes: pypi: mcpwright-soi
Repo: mcpwright/soi-mcp
Estado en el registro: Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub mcpwright, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 3 meses
✓ Superada
Tiene licencia
Usa MIT
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo

Iniciar sesión

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

Más estrellas que el 0% de los otros 3255 servidores de esta categoría
Publicado en el registro más recientemente que el 25% de los otros 3255 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 3255 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro IRS SOI (income by ZIP)?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 3 meses, y la última versión (0.1.2) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Signal8, Journalit, Tapetide - Indian Stock Market MCP, Twelve Data

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 988Actualizado hace 6 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Cómo conectar

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

de signal8aiEn crecimiento↓ 109/sem★ 425Actualizado hace 6 días

Computadora o nube✓ del servicio · signal8.ai

Instalar

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

de CursivezEn crecimiento★ 257Actualizado hace 7 días

Se ejecuta en la nube✓ del servicio · journalit.co

Cómo conectar

Tapetide - Indian Stock Market MCP

48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options

de Tapetide-hqEn crecimiento↓ 139/sem★ 150Actualizado hace 18 días

Computadora o nube✓ del servicio · tapetide.com

Instalar

Twelve Data

Real-time and historical market data: stocks, forex, crypto, ETFs, fundamentals and 60+ indicators.

de twelvedataEn crecimiento★ 86Actualizado hace 11 días

Se ejecuta en la nube✓ del servicio · twelvedata.com

Cómo conectar

SolidInvoice — Funciona en la nube, sin instalar nada · Sin clave
Signal8 — En la nube o instalado en tu equipo · Necesita clave
Journalit — Funciona en la nube, sin instalar nada · Sin clave
Tapetide - Indian Stock Market MCP — En la nube o instalado en tu equipo · Necesita clave
Twelve Data — Funciona en la nube, sin instalar nada · Sin clave

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Tool	What it does
`lookup_zip(zip_code)`	Confirm a ZIP has SOI data → state, number of returns, number of individuals, tax year. A good first call.
`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.
`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.
`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.
`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.
`get_deductions(zip_code)`	Standard vs. itemized deductions (count and amount), the taxes-paid (SALT) deduction, and the percent of returns that itemized.
`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.
`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.
`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"`.
`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.

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 claude_desktop_config.json:

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

OpenAI Agents SDK (Python)

It's a standard MCP server, so it works with any MCP-capable client — not just Claude. With the OpenAI Agents SDK:

from agents import Agent, Runner

from agents.mcp import MCPServerStdio

async def main(): async with MCPServerStdio( name="soi", params={"command": "uvx", "args": ["mcpwright-soi"]}, ) as soi: agent = Agent( name="Analyst", instructions="Use the SOI tools for IRS income and tax data by ZIP.", mcp_servers=[soi], ) result = await Runner.run( agent, "What's the income distribution of ZIP 90210 vs 10001?" ) print(result.final_output)

Any other MCP client (Cursor, VS Code, Cline, Goose, Zed, …)

They all launch a stdio MCP server the same way — point yours at:

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

Hosted chat connectors (e.g. ChatGPT connectors) expect a remote MCP server over

Streamable HTTP; mcpwright-soi runs locally over stdio.

Storage: the dataset lives in a SQLite file under your OS cache dir (override with the

SOI_MCP_STORE env var). Delete it any time; setup / refresh rebuilds it.

A note on suppression: the IRS excludes ZIPs with fewer than 100 returns (folding them into

a "99999" bucket) and suppresses line items with fewer than 20 returns. Summed ZIP totals can

therefore slightly understate reality and won't exactly equal the state total. All figures are

aggregates of filed returns, not a population census.

Develop

git clone https://github.com/mcpwright/soi-mcp && cd soi-mcp

uv sync uv run pytest # tests (mocked download + seeded SQLite) uv run ruff check src/ && uv run ruff format --check src/ # lint + format uv run mypy # strict type checking uv run mcp dev src/soi_mcp/server.py # poke the tools in the MCP Inspector

Roadmap

lookup_zip / get_income / get_agi_distribution — the income backbone
get_tax / get_credits / get_deductions / get_filing_status — the tax side
compare_zips — rank ZIPs by a metric
get_state_totals — state rollups from the IRS 00000 row
get_soi_field — raw-field escape hatch
setup / refresh [year] — download once, re-pull or pick an older tax year
Publish to PyPI (mcpwright-soi) + the official MCP Registry (io.github.mcpwright/soi-mcp)
Multi-year queries in one call (trend a ZIP across tax years)

Privacy

soi-mcp runs entirely on your machine. It collects, stores, or transmits no personal data — no accounts, no tracking, no telemetry. Its only outbound requests go to the U.S. IRS static file host (www.irs.gov/pub/irs-soi) to download the public SOI ZIP-code CSV; no API key is needed and nothing about your queries leaves your machine. The downloaded dataset is cached on disk as a local SQLite file (under your OS cache dir, or SOI_MCP_STORE); delete it any time.

Full policy: https://mcpwright.com/privacy/

Questions & feedback

Questions, ideas, or "could it do X?" → Discussions
Bugs & concrete feature requests → Issues

Contributions welcome — and if you build something with it, I'd love to hear about it.

Part of mcpwright · built by Devender Gollapally

IRS SOI (income by ZIP)

What it does

Instalación

Instala uv (si no lo tienes)

Abre el archivo de configuración de la app de Claude de escritorio

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala uv (si no lo tienes)

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala uv (si no lo tienes)

Pulsa este botón para abrir Cursor

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala uv (si no lo tienes)

Pulsa este botón para abrir VS Code

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

Valores que debes completar

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Vulnerabilidades publicadas (OSV.dev)

Conversación

Reseñas de usuarios

Comparado con otros en Contabilidad, finanzas e impuestosi

Preguntas frecuentes

Alternativas parecidas

SolidInvoice

Signal8

Journalit

Tapetide - Indian Stock Market MCP

Twelve Data

README del creador

soi-mcp

Tools

Install

Claude Code

Claude Desktop

OpenAI Agents SDK (Python)

Any other MCP client (Cursor, VS Code, Cline, Goose, Zed, …)

Develop

Roadmap

Privacy

Questions & feedback