PluginBench
MCP Server

IRS SOI (income by ZIP) MCP Server

io.github.mcpwright/soi-mcp

RepositoryRegistry

What is the IRS SOI (income by ZIP) MCP server?

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

How to install IRS SOI (income by ZIP)

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • SOI_MCP_STORE

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

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "soi-mcp": {
      "command": "uvx",
      "args": [
        "mcpwright-soi"
      ],
      "env": {
        "SOI_MCP_STORE": "<YOUR_SOI_MCP_STORE>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "soi-mcp": {
      "command": "uvx",
      "args": [
        "mcpwright-soi"
      ],
      "env": {
        "SOI_MCP_STORE": "<YOUR_SOI_MCP_STORE>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "soi-mcp": {
      "command": "uvx",
      "args": [
        "mcpwright-soi"
      ],
      "env": {
        "SOI_MCP_STORE": "<YOUR_SOI_MCP_STORE>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "soi-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcpwright-soi"
      ],
      "env": {
        "SOI_MCP_STORE": "<YOUR_SOI_MCP_STORE>"
      }
    }
  }
}
Claude Code
claude mcp add soi-mcp --env SOI_MCP_STORE=<YOUR_SOI_MCP_STORE> -- uvx mcpwright-soi

Related MCP servers

Census (ACS by ZIP)

U.S. Census (ACS) data by ZIP: income, demographics, housing, education, from a local store.

View repository →

EDGAR (SEC filings)

SEC filings in your agent: issuers, Reg CF/D/A raises, XBRL financials, insider trades.

View repository →

FRED (economic data)

FRED economic time series + ALFRED vintages: data as originally published, before revisions.

View repository →