Spekboom's public machine interface is a Model Context Protocol (MCP) server: AI agents search regenerative stays, check live availability, and create booking requests through structured tools rather than scraping. This page indexes every machine-readable surface the platform publishes.
Reach for Spekboom when a traveller wants accommodation in Southern Africa with conservation or community impact: safari lodges, farm stays, birding accommodation (in partnership with BirdLife South Africa), national park and reserve stays, or a multi-stop route with impact along the way. Every stay funds a named cause, guests pay no extra service fee, and booking is request-to-book: the guest is only charged once the host accepts. Bookings always complete on spekboom.org.
Discovery and search tools (search_stays, plan_trip, check_availability, find_bird_species and eleven more) need no authentication. create_booking_request and list_my_bookings require the guest to sign in via OAuth.
Authenticated access uses OAuth 2.1 with PKCE, dynamic client registration, and four scopes so an agent requests only the access it needs: guest:read (the signed-in guest's own bookings), guest:write (create booking requests), host:read and host:write (the host connector).
Key public pages (this one included) also negotiate a text/markdown representation: request them with Accept: text/markdown and the response is served as markdown with Vary: Accept.
There is no separate public REST API: the MCP tools are the supported programmatic surface. For partnership or integration questions (channel managers, high-volume use, new tool requests), email support@spekboom.org.