AddressIntel MCP server

A read-only Model Context Protocol server that puts SF Peninsula building-permit and parcel-buildability data inside Claude, ChatGPT, or any other MCP-capable agent.

It is a thin client over the public AddressIntel API, so it inherits that API's auth, rate limits and tier ceilings. Every tool is a GET. Nothing here can write.

Tools

| Tool | What it answers | |---|---| | search_permits | What construction has actually been permitted at an address or in a city? Filters on city, keyword (address, project type, scope description, contractor, architect, permit number) and minimum valuation. | | list_sb9_inventory | Which active listings can be split or duplexed under SB 9, and what blocks the ones that can't? | | list_adu_leads | Which parcels have room for an ADU, and how many units / how much square footage? | | list_redevelopment_leads | Which parcels are underbuilt against their allowable envelope (scrape-and-rebuild or expansion)? | | list_market_signals | Which listings score highest for teardown or flip potential? | | get_property_intelligence | Full scores and comparable sales for one property id. |

The permit and parcel tools are the differentiated half: permit-level detail and parcel-level buildability for the Peninsula, rather than a nationwide owner list.

Install

No install step: npx fetches it on demand.

Claude Code

claude mcp add addressintel \
  -e ADDRESSINTEL_API_KEY=your_key \
  -- npx -y addressintel-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "addressintel": {
      "command": "npx",
      "args": ["-y", "addressintel-mcp"],
      "env": {
        "ADDRESSINTEL_API_KEY": "your_key"
      }
    }
  }
}

From source

For working on the server itself:

git clone https://github.com/RantumBits/addressintel-mcp.git
cd addressintel-mcp
npm install
npm run build     # emits dist/index.js

Then point the client at node /absolute/path/to/addressintel-mcp/dist/index.js instead of the npx command above.

Restart the client, then ask it something like "what demolition permits were issued in Menlo Park this year?" or "which Palo Alto listings are SB 9 eligible?"

Configuration

| Variable | Default | Notes | |---|---|---| | ADDRESSINTEL_API_KEY | demo | Without a key the server uses the public demo tier: 10 requests/minute, 5 rows per call. Grab a free key at https://addressintel.co/developers for 30/min and 25 rows; the key is emailed to the address you enter. | | ADDRESSINTEL_API_BASE | https://addressintel.co/api | Point at a local dev server (http://localhost:3000/api) when working on the API. |

Development

npm run dev       # run from source over stdio
node test_mcp.mjs # smoke test: connect, list tools, call one

Tools are declared in one table in src/index.ts. Each entry carries its zod schema and its advertised JSON Schema side by side, so adding a tool means adding one entry, and the two shapes cannot drift apart.