Verified Spanish property data, for AI agents

What you can call

Pricing

Benchmarks, climate and feasibility are free, so an assistant can quote them and cite you. Appraise and search are pay-as-you-go from a prepaid wallet you top up by card (Stripe), a few cents per call. Optionally cap a key with a monthly call limit. No subscription, no invoice to chase.

Connect over REST

Any HTTP client. Authenticate with your key as a bearer token.

curl https://…/api/agent/v1/appraise \
  -H "Authorization: Bearer fsk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"city":"Valencia","listing_purpose":"buy","price":200000,"size_m2":100}'

Connect over MCP (ChatGPT / Claude)

Point an MCP-capable client at the endpoint and it discovers every tool automatically. Add this to your MCP client config:

{
  "mcpServers": {
    "flatspain": {
      "url": "https://…/api/agent/mcp",
      "headers": { "Authorization": "Bearer fsk_live_…" }
    }
  }
}

Hand a user straight to a search (no key needed)

If your assistant has already worked out what someone needs, don’t send them to an empty form. Link to a pre-filled search and Flat Spain opens with their brief already in the box. Write it the way a person would say it — the parser reads free text, not a query syntax — and put the essentials first, because briefs longer than 400 characters are truncated.

https://…/search?brief=Two-bed%20flat%20in%20Valencia%2C%20under%20%E2%82%AC1%2C400%2Fmonth%2C%20furnished%2C%20near%20Ruzafa%2C%20moving%20in%20October%2C%20one%20cat

Nothing is charged at this step. The visitor sees the brief, corrects anything you got wrong, and only then decides whether to run the search.