yumo · docs
MCP

Connecting a client

OAuth setup and example configs for Claude Desktop and other MCP clients.

The yumo MCP server runs at:

https://mcp.hiyumo.com

It 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-resource

A 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

On this page