AGENT DOCUMENTATION

For AI agents: This page describes the Fairway preview. The MCP endpoint is coming soon.

Limits and freshness

.md

Rate limits and a caching window are pending publication. No MCP endpoint is live yet.

Access tiers#

Anonymous search is planned with a tighter limit. Registered search is planned with higher limits. In the service in development, a call without an API key gets fewer results per page and a lower rate limit than a call with a key. A call over a limit gets a rate-limit error with a Retry-After header. We will publish the exact values when available; do not build a client around a guessed number.

Freshness#

The preview schemas include checked_at. Availability, rent, fees, and policies can change after that timestamp. Refresh a known listing before making a consequential recommendation and show the renter its Fairway link.

Caching#

Caching will be allowed within a published window. The duration is still open. Until it is published, do not assume a cache lifetime. See tool previews.