Travel Planning API for AI Agents
Last verified
Connect any AI agent to Goyondo and it gets scoped access to 37 trip, itinerary and group-planning tools, and the trips it makes persist in the user's Goyondo account, so the user, their group and their own AI assistant can keep planning and editing them. MCP clients such as claude.ai add the remote server at https://goyondo.run/mcp and the user signs in with OAuth; local agents run npx -y goyondo-mcp or call REST, starting an OAuth device flow with POST /api/agent-auth/device that the user approves with one link.
No custom skill is required; a Goyondo skill is an optional behavior layer on top of the published interfaces. Bookings are records the user keeps; Goyondo does not book travel or show live prices.
Start here
- Agent quickstart
- Copy-paste first-run scripts for curl, Python and TypeScript at /agent-quickstart.md.
- OpenAPI
- The REST contract is published at /api/openapi.json.
- Remote MCP
- Add https://goyondo.run/mcp as a connector (Streamable HTTP, OAuth with PKCE). In Claude Code: claude mcp add --transport http goyondo https://goyondo.run/mcp.
- MCP tools
- Tool definitions with JSON input schemas are published at /api/mcp/tools.
- Device authorization
- Agents start with POST /api/agent-auth/device; see /auth.md for the full flow.