Secrets.RealEstate

Secrets.RealEstate

Property intelligence for your AI agent

Connect Claude Code, Cursor and any MCP client to a full, verified report on any French address — up to 36 building insights across energy, risks, market, neighbourhood and regulation, each with advice and its source — in plain language.

What it is

An MCP (Model Context Protocol) server so your AI assistant pulls real, verified property facts instead of guessing. Ask about an address and get building energy ratings, risk exposure, sold comparables and neighbourhood data — grounded in official French sources.

Why grounded data

Your agent pulls verified facts from official French registries instead of guessing. Every answer traces back to a public record — building energy, risk and market data — so the model reports what is on file rather than inventing it.

Our research on AI-grounded real-estate analysis holds a certificate (Bescheinigung) from the Bescheinigungsstelle Forschungszulage (BSFZ) confirming it as eligible R&D under the German Research Allowance Act (Forschungszulagengesetz).

8

official public datasets

96

départements — all of France

36

insights per address

0

guesses — every fact traces to a public record

Connect in seconds

Add the server to your MCP client, then ask in plain language.

# Add the server with your API key
claude mcp add secrets-realestate \
  --transport http https://secrets.realestate/mcp \
  --header "X-API-Key: sk_live_…"

Works with Claude Code, Cursor and any MCP-compatible client.

Every tool needs an API key — request one in the developer console (PRO or SELLER plan plus a one-time approval).

Tools

Paid access

Grouped by domain. Every tool needs an API key, available on PRO and SELLER plans after a one-time approval.

Search & data

search_properties

Find listings by location, price, size and more.

geocode_address

Turn an address into coordinates.

get_listing

Full facts for a single listing.

get_my_listings

Retrieve the properties saved to your own account.

Market

get_comparable_sales

Recent sales with price, size and a liquidity score.

get_price_trends

Price-per-square-metre trend history.

Location & environment

get_air_quality

Air-quality index and grade.

get_seasonal_climate

Seasonal temperature profile.

get_neighborhood

Amenities, schools, leisure, safety and water quality.

get_noise

Road, rail and industry noise exposure with direction.

Insights

get_building_insights

Full report: up to 36 categorised insights with detail and advice.

get_risk_assessment

Natural and technological risks: flood, seismic, clay, radon.

get_short_term_rental

Airbnb rules of the commune: permit, quota, compensation, day cap.

get_renovation_advice

Renovation plan: energy and insulation fixes, most urgent first.

get_property_report

One-call bundle: insights, comparables, market, risks and environment.

Deep coverage spans every French département, joined from eight official public datasets — BDNB, IRIS, SSMSI, GeoRisques, Hub'Eau, Éducation IVAL, OpenStreetMap and DVF. More markets later.

Every tool is read-only and idempotent, returns typed JSON, and accepts an address, coordinates or a listing id.

View the full tool reference

Request and response

Every tool takes an address, coordinates or a listing id and returns structured JSON.

Analyse 12 rue de Rivoli, Paris — energy, risks and recent sales.

Request

get_risk_assessment({
  address: "12 rue de Rivoli, Paris",
  lang: "en"
})

Response

{
  "address": "12 rue de Rivoli, Paris",
  "latitude": 48.856614,
  "longitude": 2.358980,
  "risks": {
    "flood": "low",
    "seismic": "very low",
    "clay": "medium",
    "radon": "low"
  }
}

Pass an address and the tool returns typed JSON your agent reads directly — here, the natural-risk grades on file for that building.

What you can build

Due diligence

Surface energy, risk and regulatory flags for any address in one prompt.

Powered by

get_building_insightsget_risk_assessment

Valuation grounding

Ground your pricing model in verified comparables and trends, not guesses.

Powered by

get_comparable_salesget_price_trends

Agent enrichment

Give your copilot real building facts, so answers are grounded, not invented.

Powered by

get_building_insightsget_neighborhood

Underwriting and insurance

Score natural and technological risk per address for lending and insurance.

Powered by

get_risk_assessmentget_building_insights

Search and shortlist

Filter listings by location, price and size, then rank the shortlist by location quality.

Powered by

search_propertiesget_location_rating

Livability scoring

Combine air quality and noise exposure into a livability profile for any address.

Powered by

get_air_qualityget_noise

Access & pricing

Membership

A PRO or SELLER plan unlocks every tool from your editor once your developer access is approved.

Developer

Pay-as-you-go per-call pricing for high-volume integrations is planned. Today, all access runs through PRO and SELLER plans.

Questions

MCP

Start building

Request developer access, generate an API key and connect your MCP client.