Propraven

io.github.jdw2111Published by GitHub account jdw2111v0.2.0Updated Nov 7, 2026

Property intelligence: 180M+ US parcels — lookup, search, owners, hazards, permits, deeds.

VerifiedStreamable HTTPWeb executableLocation & LifestyleFinanceData & Analytics

Overview

AI-generated overview

PropRaven MCP gives an assistant read-only lookup of US parcel records: owners, valuations, hazards, permits and deeds.

What you can do
  • Look up a single parcel by ID, address or APN and get its canonical parcel card
  • Search parcels by owner name, address fragment, APN or city with state and city filters
  • Compare 2–25 parcels side by side, including hazard blocks, for ranking
  • Trace ownership: parcels titled under an owner name, with an optional state filter
  • Retrieve risk, valuation, permit and deed timelines for a parcel
When to use it
Useful when a workflow needs authoritative US property data — due diligence on a parcel, owner or portfolio research, hazard and valuation checks, or permit and sale history — inside Claude, ChatGPT, Cursor or another MCP client.
Requirements
Either the hosted endpoint with the API key as a bearer Authorization header (OAuth for the claude.ai web connector), or the local npm package on Node 18 or newer. A PropRaven API key in PROPRAVEN_API_KEY or the Authorization header is required; optional PROPRAVEN_BASE_URL and PROPRAVEN_TIMEOUT_MS. Network access to the PropRaven API.
Before you install
The API key is a secret sent as a bearer token; keep it out of shared configs. Calls count against the plan's monthly quota. The local server only issues GETs to read endpoints and never pays, but the hosted server exposes separate buy tools that can spend money. Data comes from a third-party property database.

Installation

In SourceWeft

  1. Open Propraven in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jdw2111%2Fpropraven/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "propraven": {
      "type": "http",
      "url": "https://propraven.com/mcp"
    }
  }
}

README

@propraven/mcp

Model Context Protocol server for PropRaven — gives Claude, ChatGPT, Cursor, and any MCP-compatible agent canonical access to 191.3M US parcels (110.0M mapped) with ownership, valuation, permits, deeds, hazard, and market data.

Hosted endpoint: https://propraven.com/mcp (Streamable HTTP, no install — docs: https://propraven.com/docs/mcp · agents + x402: https://propraven.com/docs/agents). Or run the stdio server locally (below).

Hosted (no install)

Point any HTTP-transport MCP client at https://propraven.com/mcp with your API key as a bearer header. Claude Desktop / Cursor (claude_desktop_config.json, ~/.cursor/mcp.json):

json
{  "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". The claude.ai web connector uses OAuth instead — add a custom connector with the same URL and sign in.

Local stdio server (npx @propraven/mcp)

Requirements: Node ≥18, a PropRaven API key (pz_…) from https://propraven.com/settings/api-keys (free, no card).

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

json
{  "mcpServers": {    "propraven": {      "command": "npx",      "args": ["-y", "@propraven/mcp"],      "env": { "PROPRAVEN_API_KEY": "pz_your_real_key_here" }    }  }}

Cursor (~/.cursor/mcp.json) takes the same block. Claude Code: claude mcp add propraven --env PROPRAVEN_API_KEY=pz_your_real_key_here -- npx -y @propraven/mcp.

Restart the client. The 8 PropRaven tools appear in the tool list.

Quick test

Look up parcel 37:119:12104406 and tell me the owner.

The agent should pick parcel_lookup and return the canonical parcel card with the owner.

ChatGPT: Custom GPT → Actions → OpenAPI URL https://api.propraven.com/openapi.json with API-key (Bearer) auth; native MCP-in-ChatGPT can use the hosted endpoint https://propraven.com/mcp (OAuth 2.1 + PKCE).

Tools

Names match the hosted server (^[a-zA-Z0-9_-]{1,64}$, as MCP clients and the Anthropic API require).

ToolPurposeBacked by
parcel_lookupResolve one parcel by ID, address, or APNGET /api/v1/parcels/{id} (ID) or GET /api/v1/search/full (address / APN)
parcel_searchText search by owner, address fragment, APN or city (+ state/city filters, keyset cursor)GET /api/v1/search/full
parcel_compareFree card (+ hazards) for 2–25 parcels, for agent-side rankingGET /api/v1/parcels/{id} (+ /risks) × N
owner_pierceParcels titled under an owner name (optional state filter, best-effort ticker)GET /api/v1/owners/{name}/portfolio (+ /owners/search for ticker)
hazard_scoreFlood / wildfire / seismic / windstorm / air-quality / crime blocksGET /api/v1/parcels/{id}/risks
valuation_estimateMarket value, AVM, assessed values, last sale, $/sqftGET /api/v1/parcels/{id}
permits_historyPermit timeline (≤100 newest, with true-count basis)GET /api/v1/parcels/{id}/permits?shape=envelope
sales_historyDeed / transfer timelineGET /api/v1/parcels/{id}/deeds?shape=envelope

Parcel IDs. The canonical form is state_fips:county_fips:parcel_id, e.g. 37:119:12104406. The legacy 5-digit form (37119:12104406) and PropRaven parcel UUIDs are also accepted. parcel_search and parcel_lookup's address search add a lookup_id to every result (search rows carry the PropRaven UUID in parcel_id), which parcel_lookup / parcel_compare accept.

No tool spends money. The client only issues GETs to the seven free / metered read endpoints above, refuses every other path before a request is sent (the paid parcel report, comp pack, risk score, owner report, leads, storefront, …), and never sends a payment header. If the API ever answers with an x402 402 Payment Required, the tool returns 402 payment required — this tool never pays. Calls still count against your plan's monthly quota. To buy a dossier, use the hosted server's explicit buy_* tools or propraven.com.

Errors are RFC 7807 problem details, surfaced as <status> <code>: <detail> (e.g. 404 not_found: …). A 429 or 503 is retried once when Retry-After is ≤ 10 s.

Tool descriptions call out when not to use each tool, which is the biggest determinant of agent selection accuracy.

Environment

VariableDefaultPurpose
PROPRAVEN_API_KEY(required)Bearer token, format pz_...
PROPRAVEN_BASE_URLhttps://propraven.comAPI host (every path starts with /api/v1).
PROPRAVEN_TIMEOUT_MS30000Per-request timeout in ms.

Requests carry User-Agent: @propraven/mcp/<version>.

Develop / inspect

bash
npm cinpm run buildnpm test          # node:test suite — no network, no API key needed
# Live-reloading dev (TypeScript, no build step):PROPRAVEN_API_KEY=pz_test... npm run dev
# Or open the MCP Inspector UI:PROPRAVEN_API_KEY=pz_test... npm run inspect

The inspector at https://modelcontextprotocol.io/legacy/tools/inspector lets you call each tool manually and see request/response payloads.

Why this exists

Every Claude / ChatGPT / Cursor workflow that touches property data needs an authoritative parcel-lookup tool. There is no canonical property-data MCP today. PropRaven aims to be it before the first-mover window closes (~12–18 months).

License

Apache-2.0

Source: README.md at commit a90bc28

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

2
  1. v0.2.0LatestOct 2, 2026
  2. v0.1.2Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.