Do I need an API key?

OAuth clients do not. Claude, Grok, Cursor, and Codex sign in with OAuth. A config file sends Authorization: Bearer pz_... from a free account.

What data is behind it?

U.S. parcel, owner, permit, sales, valuation, hazard, and zoning data. Measured coverage is on /coverage. Field definitions are in /docs/v1/data-dictionary.

Does it return owner names?

Yes, with an account. Owner names and mailing addresses require an account (an API key, an MCP OAuth token, or a signed-in session) or a settled paid call. On the paid products (the dossier, lead feeds, verifying owner_name, tax status, and watch polls), a wallet or an X-CREDIT-TOKEN receives them once the x402 payment settles or the credit debit succeeds. A verified but unsettled payment delivers nothing. An unpaid caller without an account gets no people data. Owner-name lookups, the owner card, and list exports require an account.

MCP · AI agents · U.S. property data

MCP server for U.S. real estate data

PropRaven is a hosted Model Context Protocol server that gives AI agents U.S. parcel, owner, permit, sales, valuation, hazard and zoning data. Connect Claude, ChatGPT, Grok, Cursor, Codex or any MCP client to https://propraven.com/mcp with OAuth or an API key. Nothing to install.

Free: 1,000 lookups a month with an API key, no card. Create a key · MCP setup

Connect in one step

The endpoint is https://propraven.com/mcp (Streamable HTTP). Connector UIs (Claude, Grok, Cursor, Codex) sign in with OAuth. A config file sends Authorization: Bearer pz_.... Claude Code:

claude mcp add --transport http propraven https://propraven.com/mcp --header "Authorization: Bearer pz_your_key"

Setup for every client

What agents can do

The hosted endpoint lists 47 tools. The groups below are the jobs buyers ask about. Each line is that tool's registry summary. The full list is on the MCP docs. Where a field is thin, see coverage.

Free tools

get_catalog · Free: Browse the data catalog — fields, coverage, freshness (free)
check_availability · Free: Preview a parcel/jurisdiction's field-fill before buying (free)
get_account · Free: Check this session's storefront entitlement before a buy_* call (free)

Parcels

parcel_lookup: Resolve one parcel by ID, address, or APN
parcel_search: Filter parcels by geography + attributes
parcel_lookup_batch: Resolve up to 25 parcels in one call
parcel_compare: Rank 2–25 parcels against ranking criteria

Owners

owner_card: Owner of record, best mailing address, owner phones / e-mails, people on permits and Secretary of State filings for one parcel or owner name (account required)
owner_pierce: List the parcels whose owner of record matches a name's spellings (candidate matches, not verified links)

Permits and licensees

permits_history: Permit timeline for a parcel, with each permit's inspections, fees, conditions and reviews, the owner, applicant and every published phone / e-mail (account)
deals_contractors: Contractors ranked by permit activity
licensee_firm_search: Firms licensed by state boards in one city or ZIP (FL, CA, NY, CT, VA, AZ, OH, OR, NJ, WV)

Sales and value

sales_history: Deed transaction history
comps: Comparable recent sales for one subject parcel, from the precomputed comp sets
valuation_estimate: County market value + PropRaven estimate + assessed value

Risk and zoning

hazard_score: Composite hazard score (flood, wildfire, seismic, …)
zoning_lookup: Zoning for ONE parcel, straight from the jurisdiction that issues it.
zoning_search: Screen parcels by zoning across markets.

Lead lists

deals_absentee: Absentee-owner parcels in a county/state
deals_entities: LLC/Trust-owned parcels (or top entities)
deals_long_hold: Long-held parcels (tired-landlord leads)
deals_portfolio_owners: Owners holding multiple properties

licensee_firm_search covers state-licensed firms (real estate, insurance, CPA, CAM) in the states named on that tool.

Example prompts

Who owns 123 Main St and what's their mailing address?
Show the permit history for this parcel
List absentee-owned single-family parcels in Mecklenburg County, NC
What is this parcel zoned, straight from the jurisdiction?
Pull comparable sales for this parcel.

How it's paid for

A free account includes an API key. Free: 1,000 lookups a month, no card. Metered tools count against the plan. Paid products are included with eligible plans, or paid per call over x402. Pricing

Hosted server or local package

The optional @propraven/mcp npm package (v0.2.0) exposes only 8 tools: parcel_lookup, parcel_search, parcel_compare, owner_pierce, hazard_score, valuation_estimate, permits_history, sales_history. The hosted endpoint has the full list of 47 tools.

Questions

Which AI clients work with it?: Claude, ChatGPT, Grok, Cursor, Codex, and any MCP client. Connector UIs (Claude, Grok, Cursor, Codex) sign in with OAuth. A config file sends an API key. Setup for every client is on /docs/mcp.
Do I need an API key?: OAuth clients do not. Claude, Grok, Cursor, and Codex sign in with OAuth. A config file sends Authorization: Bearer pz_... from a free account.
What data is behind it?: U.S. parcel, owner, permit, sales, valuation, hazard, and zoning data. Measured coverage is on /coverage. Field definitions are in /docs/v1/data-dictionary.
Does it return owner names?: Yes, with an account. Owner names and mailing addresses require an account (an API key, an MCP OAuth token, or a signed-in session) or a settled paid call. On the paid products (the dossier, lead feeds, verifying owner_name, tax status, and watch polls), a wallet or an X-CREDIT-TOKEN receives them once the x402 payment settles or the credit debit succeeds. A verified but unsettled payment delivers nothing. An unpaid caller without an account gets no people data. Owner-name lookups, the owner card, and list exports require an account.