MCP · Hosted + Local

PropRaven MCP Server

Model Context Protocol server for Claude, ChatGPT, Cursor, and any MCP-compatible agent. 18 tools cover the underwriting and due-diligence workflow.

Hosted endpoint·npm·GitHub

Hosted (recommended)

No install — just configure your MCP client to point at the hosted endpoint and pass your API key.

PropRaven uses API-key bearer auth: pass Authorization: Bearer pz_…. This works today in Claude Desktop, Claude Code, Cursor, and Smithery (header config). The Claude.ai web connector UI has no header field and uses OAuth — see the OAuth section below. Get a free key →

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\\Claude\\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "propraven": {
      "url": "https://mcp.propraven.com/",
      "headers": {
        "Authorization": "Bearer pz_your_real_key_here"
      }
    }
  }
}

Cursor

Same config at ~/.cursor/mcp.json.

Claude.ai (web) — OAuth

The claude.ai web connector UI has no header field, so it uses OAuth (authorization-code + PKCE). Add the connector with the hosted URL and PropRaven's OAuth client id when prompted; you'll approve a one-time consent screen. The token maps to a read-only key on your account's plan. Bearer-header clients (Desktop/Code/Cursor) don't need this.

ChatGPT Custom GPT

Add an Action with OpenAPI URL api.propraven.com/openapi.json and authentication = API Key (Bearer). Native MCP support in ChatGPT requires OAuth — coming with v0.2.

Local (stdio)

Use the npm package for offline / latency-sensitive workflows. Talks to the PropRaven REST API directly.

npm install -g @propraven/mcp
{
  "mcpServers": {
    "propraven": {
      "command": "propraven-mcp",
      "env": {
        "PROPRAVEN_API_KEY": "pz_your_real_key_here"
      }
    }
  }
}

Tools

parcel.lookup
Resolve one parcel by ID, address, or APN
parcel.search
Filter parcels by geography + attributes
parcel.compare
Rank 2–25 parcels against ranking criteria
owner.pierce
Resolve a name/entity to its full portfolio
hazard.score
Composite hazard score (flood, wildfire, seismic, …)
valuation.estimate
AVM + assessed + market value
permits.history
Permit timeline for a parcel
sales.history
Deed transaction history
get_freshness
Report how current PropRaven's served data is
deals.absentee
Absentee-owner parcels in a county/state
deals.flips
Recent flips or top flippers
deals.contractors
Contractors ranked by permit activity
deals.lenders
Lenders ranked by mortgage count
deals.entities
LLC/Trust-owned parcels (or top entities)
deals.long_hold
Long-held parcels (tired-landlord leads)
deals.high_land_ratio
Teardown/redevelopment candidates
deals.portfolio_owners
Owners holding multiple properties
market.coverage
Where PropRaven has parcel coverage

Each tool description is tuned for agent reasoning — explicit “use when / do NOT use when” framing.

Verification

curl -X POST https://mcp.propraven.com/ \
  -H "Authorization: Bearer pz_your_real_key" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq '.result.tools | length'
# expect: 18

Resources