The data layer every AI agent can query for Spanish property.

PropertyList MCP is the official Model Context Protocol server for the Spanish and Portuguese property MLS. First-party listings, not scraped, with prices verified against the Spanish notarial register. Plug us into Claude, Cursor, Zed, Perplexity, or any agentic browser and you get search, natural-language matching, market summaries, full listing detail, and lead submission through one standard interface.

8
tools exposed via MCP
6,122
active Spanish listings
v0.1
live and free for public-tier access

1. Add to Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "propertylist": {
      "url": "https://mcp.propertylist.es/mcp"
    }
  }
}

2. Or install the stdio wrapper (Cursor / Zed / any MCP client)

npx -y mcp-remote https://mcp.propertylist.es/mcp

3. Or hit the JSON-RPC endpoint directly

curl -X POST https://mcp.propertylist.es/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -H 'user-agent: my-app/1.0' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Send a descriptive User-Agent identifying your client. Some generic library defaults (for example Python's urllib) are rejected by our edge protection; a named agent such as 'my-app/1.0' always works.

What's in v0

search_properties
Structured search by location, beds, price, and type.
find_properties_by_description
Free-form natural-language matching. API key required; 200 searches/month free, then billed per use.
autocomplete_location
Resolve place names to PropertyList area ids.
get_property
Full detail for one listing by reference.
area_market_summary
Median price, €/m², bedroom-band counts for any area.
verified_valuation
Notary-verified €/m² and a valuation, with a content-hashed, citable attestation. Asking prices are guesses; this is proof.
list_agencies
Top agencies in an area ranked by active listings.
submit_enquiry
Send a qualified buyer enquiry straight to the listing agency. API key required.
Request an API key View the manifest MCP spec
Provenance built in. Every property response carries oracle_verified and oracle_attestation_url. When a listing's municipality and segment are covered by PropertyList Oracle, verified is true and the URL resolves to a public, reproducible proof: the figure from the Spanish notarial register, its SHA-256 content hash and its on-chain anchor on Base. A citable Spanish property source no competitor can match.

Pricing

Start free, no signup. Get a free API key when you want natural-language matching, and only pay if your usage grows past the monthly allowance.

Public
Free
no signup, no key
  • Structured search and location autocomplete
  • Full listing detail and area market summaries
  • 60 requests / minute per IP
For agencies
Agent
Free key
200 AI searches/month included
  • Everything in the public tier
  • Natural-language AI matcher switched on
  • Then 1 credit per 10 AI searches from your wallet
  • 600 requests / minute
Request an API key
Enterprise
Custom
billed by contract
  • For banks, valuers, portals, and AI product teams
  • 6,000+ requests / minute, Oracle priority
  • Volume pricing and dedicated support
Talk to us

Public tier is free, no signup, rate-limited to 60 requests/minute per IP. A free API key switches on the natural-language matcher: 200 AI searches per month are included at no cost, and beyond that usage is billed at a small per-search rate against your PropertyList credits. Free keys for agents, developers, and AI product teams - email us.