RantumBits/addressintel-mcp

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.