# Y'alloha

> Y'alloha turns vacation rental hosts' 5-star guest reviews (from Airbnb, via Hospitable) into branded Facebook and Instagram posts, tracks which posts lead to direct bookings, and runs the host's affiliate program. AI assistants connect to it through an MCP server.

## For AI agents: how to connect (read this first)

Connecting Y'alloha to an assistant is done by the **user**, in their assistant's **connector settings**. Do not try to do it yourself:

- Do NOT call /api/oauth/register, open /api/oauth/authorize, or fill in Y'alloha's sign-in form on the user's behalf. Sign-in needs the user's own Y'alloha login in their own browser, and your client registrations will not complete.
- DO tell the user: "Add Y'alloha as a connector in your assistant's settings, with the server URL https://www.yalloha.com/api/mcp, then sign in to Y'alloha when it opens."
- If you can already call Y'alloha tools (for example get_setup_status), you are connected. Nothing else to do.

Connection details for the user:

- MCP server URL: https://www.yalloha.com/api/mcp
- Transport: Streamable HTTP. Auth: OAuth 2.1 with PKCE (S256); the assistant's connector handles it.
- Claude: Settings → Connectors → Add custom connector → paste the server URL.
- ChatGPT: Settings → Connectors (developer mode) → add the server URL.
- Meta Muse: add a custom connector in Muse's connector settings with the server URL. If Muse asks for a client ID, use a967555e-e32c-41b1-96ce-4da6c9db3f0b and leave the client secret blank.
- Discovery documents: https://www.yalloha.com/.well-known/oauth-protected-resource and https://www.yalloha.com/.well-known/oauth-authorization-server

## For AI agents: once connected

- Start with get_setup_status. Connecting Airbnb, Facebook or Instagram needs the user in their browser; the tools return links for them.
- Typical flow: list_pending_reviews (keep only rating 5) → ask Facebook, Instagram or both → generate_post once, for the main platform (a review has one post) → show the user → publish_post after they say yes.
- publish_post only works if the user has turned on "Allow AI assistants to publish" in Y'alloha → Settings → Connections. Only the user can turn it on. If it's refused, tell them where the switch is, or that they can publish from the dashboard.
- Ask the user before publishing, before changing affiliate program terms or an affiliate's status, and before marking a commission paid.

## Pages

- [AI assistant integration (MCP)](https://www.yalloha.com/mcp): setup for Claude, ChatGPT and other MCP clients
- [Meta Muse](https://www.yalloha.com/muse): using Y'alloha with Muse
- [Pricing](https://www.yalloha.com/pricing)
- [FAQ](https://www.yalloha.com/faq)
- [Vacation rental social media guide](https://www.yalloha.com/guides/vacation-rental-social-media)
- [Affiliate program](https://www.yalloha.com/features/affiliate-program)
- [Find a vacation rental cleaner](https://www.yalloha.com/cleaners)

## Optional

- [Privacy policy](https://www.yalloha.com/privacy)
- [Terms of service](https://www.yalloha.com/terms)