Connecting a client
OAuth setup and example configs for Claude Desktop and other MCP clients.
The yumo MCP server runs at:
https://mcp.hiyumo.comIt speaks the standard MCP protocol over HTTP, with OAuth 2.0 for authentication. You'll authorize each client once — after that, it can act on your behalf until you revoke it from the Account page.
Claude Desktop
In Claude Desktop, open Settings → Connectors → Add custom connector and enter:
- Name:
yumo - URL:
https://mcp.hiyumo.com
Claude will open a browser tab to app.hiyumo.com, where you'll log in (if you aren't already) and approve access. Once you approve, the connector is live in Claude Desktop and you can ask it to plan trips.
Generic MCP client
If your client supports remote MCP servers with OAuth, point it at:
{
"mcpServers": {
"yumo": {
"url": "https://mcp.hiyumo.com",
"transport": "http"
}
}
}The server advertises its OAuth metadata at:
https://mcp.hiyumo.com/.well-known/oauth-protected-resourceA standards-compliant client will discover the authorization server from there and walk you through the consent flow.
What gets shared
When you authorize a client, you grant it the same access you have — no more, no less. Specifically:
- Read and write all trips you own or collaborate on.
- Read and write all vision boards you own or collaborate on.
- Read community places, place stats, and users' ranked lists.
- Cannot read or change your billing, password, or other account settings.
Revoking access
Open app.hiyumo.com/account, scroll to Connected MCP clients, and click Revoke next to any client. The token is invalidated immediately; the next request from that client will fail with a 401.
Troubleshooting
Token expired or 401 errors. Tokens auto-refresh; if your client lost its refresh token, simply remove and re-add the connector to re-authorize.
Rate limits. The server applies a per-user rate limit (60 requests per
minute). If you hit it, you'll get an HTTP 429 with Retry-After — your
client should back off automatically.
Need help or found a bug?
Join the yumo community on Discord. We answer questions, take feature requests, and triage bug reports there.
Join the Discord