MCP · Hosted + Local

PropRaven MCP Server

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

Hosted endpoint·npm·GitHub

Hosted (recommended)

No install — point your MCP client at the hosted endpoint https://propraven.com/mcp and connect with OAuth or 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 →

Codex — OAuth

Add https://propraven.com/mcp as an HTTP MCP server in Codex and connect your PropRaven account. Codex registers its own OAuth client automatically; leave any client ID or client secret override empty. Sign in and approve access in the browser.

From the Codex CLI:

codex mcp add propraven --url https://propraven.com/mcp
codex mcp login propraven

Claude Desktop

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

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

Claude Code

claude mcp add --transport http propraven https://propraven.com/mcp \
  --header "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
get_catalog
Browse the data catalog — fields, coverage, freshness (free)
check_availability
Preview a parcel/jurisdiction's field-fill before buying (free)
buy_dossier
Buy the PropRaven dossier for ONE parcel at the route's delivered-data quote: a single payload with populated sellable fields (each carrying {value, source, as_of, confidence}) plus available deeds / comps / permits rows and section outcomes.
find_leads
Buy a LEAD FEED: the qualified target list for one signal in one state — absentee owners, long-hold owners, land-dominant redevelopment candidates, recent flips, entity-owned parcels, functionally distressed parcels, or multi-property portfolio owners.
buy_owner_report
Buy the OWNER INTELLIGENCE REPORT: pierce one owner name (or a public company `ticker`) to its FULL property portfolio across the country — every parcel it holds, with a per-state breakdown, the total assessed value, the entity type, and each property's identity, valuation and sale history.
buy_comp_pack
Buy the COMP PACK: a subject valuation INDICATED BY comparable sales, wrapped with the comps that prove it.
buy_risk_score
Buy the RISK SCORE: a multi-hazard risk assessment for ONE parcel, anchored on FEMA's National Risk Index COMPOSITE (nri_risk_score 0–100 + rating), with the flood (zone/SFHA/score), seismic (USGS design values), windstorm (NRI hurricane/tornado + NOAA storm history), wildfire (USFS ranks), air-quality and crime breakdown that supports it.
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
Lender profiles unavailable pending a qualified producer
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
occupant_lookup
Business occupants at a parcel
parcel_lookup_batch
Resolve up to 25 parcels in one call
parcel_report
Request the PAID dossier for ONE parcel through the same endpoint as buy_dossier.
market_snapshot
Market-intelligence snapshot for ONE geography: demographics (ACS), jobs (LODES), lending (HMDA), housing, hazard and healthcare roll-ups, plus county sale stats (median/avg price, YoY, days-on-market, cash-sale %) and a quarterly price history.
comps
Comparable recent sales for ONE subject parcel, read from PropRaven's PRECOMPUTED comp sets — each comp carries sale price and date, size, beds/baths, a similarity score, distance in miles, and rank.
cmbs_exposure
CMBS (commercial mortgage-backed securities) debt exposure, looked up by owner OR by parcel.

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

Verification

curl -X POST https://propraven.com/mcp \
  -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: 31

Resources