Goyondo + Grok
Last verified
In the xAI API, add Goyondo to the tools of a request as a remote MCP server: {"type": "mcp", "server_url": "https://goyondo.run/mcp", "server_label": "goyondo", "authorization": "<your gyd_ key>"}. Your assistant can then use create_trip, save_itinerary, add_activity and get_trip to plan and edit trips that persist in Goyondo.
Connect Grok to Goyondo
- Create a Goyondo API key. In your Goyondo profile, open API keys and create a key. It starts with gyd_. Keep it secret: it gives access to your trips.
- Add Goyondo as a remote MCP tool. In a request to the xAI API, add a tool with type mcp, server_url https://goyondo.run/mcp, a server_label such as goyondo, and your key as authorization. Goyondo accepts the key with or without the Bearer prefix.
- Ask Grok to plan. Grok lists Goyondo's tools and calls them from xAI's servers. Ask it to plan a trip and save it to Goyondo.
- Keep editing. Open goyondo.run to see the trip, edit it yourself or invite your group.
Example prompts
Plan a 3-day trip to Lisbon from 12 to 14 May for two people who love food, and save it to Goyondo.List my Goyondo trips and tell me which days of the Lisbon trip still have free afternoons.In my Goyondo Lisbon trip, move the Belém visit to the second morning, then check the trip for alerts.Tools your assistant can use
| Tool | What it does |
|---|---|
list_trips | List trips for the authenticated user, newest first. Returns trip id, destination, dates and status. Pages with limit and offset: when has_more is true, call again with offset set to next_offset. |
get_trip | Get a single trip by id including full itinerary (days and activities). trip.origin is where the trip starts and trip.journey the estimated flight hours and time difference (estimates; say "about"). |
create_trip | Create a new trip and optionally generate an AI itinerary, which can take up to a few minutes. Returns the created trip and itinerary. Pass fixed_plans for tickets, reservations and must-sees. To write the itinerary yourself, pass skip_ai_generation: true and then call save_itinerary with all the days in one call. |
update_trip | Update trip metadata such as dates, title, traveler count, budget, or status. When start_date or end_date changes, the response includes itinerary_dates showing the first and last day dates after the shift — verify these match your intended dates before proceeding. |
add_activity | Add an activity to a trip. To assign to a specific day use itinerary_id (UUID from get_trip itinerary days — most reliable), date (YYYY-MM-DD), or day_number (1-based). If none are provided the activity lands on Day 1. The result includes warnings (duplicates, time overlaps) for the new activity; fix them or tell the user. To add several activities, use save_itinerary. |
update_activity | Update an existing activity. All fields except trip_id and activity_id are optional. The result includes warnings (duplicates, time overlaps) involving the activity. Changing anything other than status marks the activity as the user's, so regenerate_itinerary keeps it. |
delete_activity | Delete an activity from a trip. Regeneration will not suggest it again. If the activity belongs to a fixed plan, that day is removed from the plan, or the whole plan if it was the last day. |
regenerate_itinerary | Regenerate the AI itinerary for an existing trip. Replaces AI suggestions only: fixed plans and activities the user or an agent added or edited are kept, and removed activities are not suggested again. |
Frequently asked questions
- Does this work in the Grok app?
- This page covers the xAI API, where remote MCP tools are documented. Use the same endpoint and key wherever Grok lets you add a remote MCP server.
- Can I limit which tools Grok sees?
- Yes. The xAI API lets you pass a list of allowed tools for the MCP server, for example only list_trips and get_trip for read-only use.
- How do I remove access?
- Revoke the key under API keys in your Goyondo profile. Every change Grok makes shows in the trip's edit log.
- Do I need to pay?
- No. Self-authored trips have no trip-count cap. The free plan includes 3 active Goyondo AI-planned trips, creating an API key raises that allowance to 10, and Pro removes the AI trip-count cap.