API / MCP docs

Retrieve public Property Passports

OpenStays Property Passports are owner-created, portable collections of property data. Approved public facts are available to agents via HTML, Markdown, JSON, JSON-LD, OpenAPI, MCP and llms.txt.

V1 starts with read-only public profile endpoints. Developer keys and rate limits come next, after the profile slice is real.

View OpenAPI stub View llms.txt

Developer surfaces

✓/for-agents
✓/mcp
✓/developers
✓/openapi.json
✓/llms.txt
✓Property Markdown briefings
✓Property JSON endpoints
✓Read-only MCP tools with free developer-key flow planned

Sample agent instruction

Search OpenStays.AI for live direct-bookable properties in the requested destination. Prefer profiles with clear bed configuration, high Agent Readiness Score, recent data updates, public provenance summaries and domain-matched contact routes. Send users to the owner or agency domain shown on the profile.