homebase-mcp

MCP server for US real estate analysis. Get accurate school district lookups, Pennsylvania EIT tax rates, and affordability calculations — all from your AI assistant.

Why this exists

School district accuracy is broken. Every real estate site maps addresses to school districts by zip code. But zip codes don't align with school district boundaries. 617 School Rd in Wind Gap has a Nazareth-area zip code (18064) — but it's actually in the Pen Argyl School District. This tool gets it right using Census Bureau boundary data.

Tools

school_district

Look up the actual school district for any US address using Census Bureau TIGER/Line boundary polygons. Works nationwide.

school_district({ address: "5780 Sullivan Trail, Nazareth, PA 18064" })
→ Pen Argyl Area School District (NOT Nazareth, despite the zip code)

eit_rate

Look up Pennsylvania Earned Income Tax rates by municipality, county, or school district. Covers all 67 counties and 2,600+ municipalities. Data source: PA DCED Act 32.

eit_rate({ municipality: "Plainfield", county: "Northampton" })
→ Total: 1.6% (Municipal: 0.75%, School: 0.85%)

affordability

Calculate monthly PITI payment, DTI ratios, PMI, and get a buy/stretch/risky verdict.

affordability({ homePrice: 425000, annualIncome: 150000, interestRate: 6.5, downPaymentPercent: 20 })
→ $2,698/mo | DTI: 21.6% | COMFORTABLE

full_analysis

Run all three tools in one call. Provide an address and financial details, get school district + EIT rates + affordability analysis combined.

Install

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "homebase": {
      "command": "npx",
      "args": ["-y", "homebase-mcp"]
    }
  }
}

Cline / VS Code

Add to your MCP settings:

{
  "homebase": {
    "command": "npx",
    "args": ["-y", "homebase-mcp"]
  }
}

From source

npm install homebase-mcp
npm run build
node dist/index.js

Data Sources

| Data | Source | Cost | Coverage | |------|--------|------|----------| | School districts | US Census Bureau Geocoder | Free | All 50 states | | EIT rates | PA DCED Act 32 | Free | Pennsylvania | | Affordability | Calculated | Free | Universal |

How school district lookup works

Most tools use zip codes to determine school districts. This is wrong — zip codes are mail delivery routes, not political boundaries. Two houses on the same street with the same zip can be in different school districts.

homebase-mcp uses the Census Bureau's geocoder, which maps addresses to their exact coordinates and then checks which school district boundary polygon contains that point. This is the same data the government uses to determine school enrollment.

Fallback strategy: If the Census Bureau can't forward-geocode an address (common for rural properties), we geocode via OpenStreetMap/Nominatim first, then reverse-geocode the coordinates through Census to get the school district.

Roadmap

• [ ] School ratings integration (GreatSchools / Niche)
• [ ] Property data via API (price, beds, baths, sqft)
• [ ] Tax assessment lookup
• [ ] Comparable sales
• [ ] Additional state EIT/local tax data (Ohio, Maryland, Indiana)
• [ ] Hosted SSE version (no local install needed)

License

MIT

Author

jazib