The Koko connector

Last updated: August 13, 2026

Koko connects to Claude and ChatGPT as an app, so a trip you plan in a conversation can be saved to your Koko account, opened on a map, shared with the people coming with you, and edited later from the same conversation. This page covers setup, what each tool does, what the assistant can and cannot reach, and the limits.

Setting it up

You need a free Koko account. Sign up at kokotravel.ai first, or create one during the connection flow.

Server details

MCP endpoint: https://kokotravel.ai/mcp
Transport: streamable HTTP (stateless JSON-RPC)
Authentication: OAuth 2.1 with PKCE and dynamic client registration. There is no client ID or API key to paste in.

In Claude

Open Settings → Connectors and add Koko, either from the directory or as a custom connector using the endpoint above.
Click Connect. Koko's sign-in page opens.
Sign in with Google, or with your email and a six digit code, or with your Koko username and password. Then grant access.

In ChatGPT

Add Koko from the app directory, or as a connector using the endpoint above.
Click Connect and sign in to Koko the same way.

In Claude Code or another MCP client

claude mcp add --transport http koko https://kokotravel.ai/mcp

Then run /mcp and complete the sign-in in the browser.

What the connector can do

Six tools, all scoped to the account you signed in with. Read tools can run without a prompt each time; the write tools change your saved content, and update_koko replaces a list in full, so Claude asks before running it.

send_to_koko Save a list or plan to Koko Write

Creates a new list or plan in your account from places described in the conversation. A flat set of places becomes a list; places with times grouped into days become a plan. Koko geocodes each place, then fills in ratings, opening hours and photos in the background. Returns a view link straight away.

my_koko My lists & plans Read only

Lists what is already in your account: title, kind, place count and id. Nothing else in your account is exposed.

get_koko Open a list or plan for editing Read only

Returns one list or plan as an editable structure so the assistant can change it and push the new version back.

check_koko_status Check build progress Read only

Reports how far along a build is: received, locating, enriching, ready. Useful right after a save, since pins appear first and photos follow.

update_koko Update a list or plan Full replace

Replaces the contents of an existing list or plan with a new version. Anything left out of the replacement is removed, which is why it counts as destructive and prompts you first. The id and the share link stay the same, so anyone you already shared it with sees the update.

refresh_details Refresh ratings & photos Write

Re-pulls ratings, reviews, hours and photos for an existing list. This one costs Koko money per place, so it estimates first and only spends when you confirm.

Partner tools (certified creators)

Eight more tools switch on for certified creators, the partner program members who publish on Discover. On any other account they answer “not a certified creator” and change nothing. Every one is scoped to your own storefront.

creator_profile My creator profile Read only

Reads your storefront profile: name, pills, tagline, bio, location, links, socials, default price and whether you are discoverable.

update_creator_profile Update my creator profile Write

Changes those same fields. Send only what should change; the pills are replaced as a set. The handle can never change, since it is your public URL.

my_listings My listings Read only

Every list and plan you own, with whether it is on Discover, its price tier, the share link, 30-day views and all-time purchases and revenue.

set_listing List on Discover / take off Discover Write

Puts one of your lists or plans on the public Discover shelf at a price from the standard ladder (Free, $1, $2, $5, $10), or takes it off. Taking it off always clears the price.

creator_stats Creator stats Read only

Views, unique viewers, purchases and revenue over 7, 30 or 90 days, for the whole storefront or one listing, as totals plus a daily series.

create_coupons Make coupon codes Write

Mints codes for a paid listing: one code or fifty, single-use or one code with many uses. A coupon names the lower tier the buyer pays (free by default), never a percentage.

coupons Coupons on a listing Read only

Every code on one of your listings, live and deactivated, with how many times it was used and by whom.

disable_coupon Deactivate a coupon Write

Stops a code from redeeming. Its history stays.

Example prompts

“Make me a list of three famous ramen shops in Shibuya, Tokyo: Ichiran Shibuya, Nagi Golden Gai and Hakata Ippudo Shibuya. Save it to Koko as ‘Shibuya Ramen’.”

Uses send_to_koko. You get a view link back.

“Plan one day in Asakusa, Tokyo: Senso-ji at 09:00, lunch at Daikokuya Tempura at 12:00, Tokyo Skytree at 14:00. Save it to Koko as ‘Asakusa Day’.”

Uses send_to_koko and saves a plan rather than a list, because the stops have times.

“What do I have saved in Koko?”

Uses my_koko.

“Is my Shibuya Ramen list ready yet?”

Uses check_koko_status.

“In my Shibuya Ramen list, drop Hakata Ippudo and add Afuri Ebisu instead.”

Uses get_koko then update_koko. Same link, updated contents.

What the assistant can and cannot reach

Can: create, read and update the lists and plans in the Koko account you signed in with.
Cannot: see any other user's content, delete your account, change your sign-in details, or make anything public. Publishing to Koko's public Discover shelf is restricted to Koko's own operator accounts; on a normal account that request is saved privately instead and the reply tells you so.
Privacy of what gets saved: lists and plans created through the connector are private. The view link renders only for you, signed in on the Koko web app. Sharing is a separate, deliberate step you take in the app.
What Koko receives: only the requests the assistant makes on your behalf, for example a list of place names to save. Your conversation stays with the assistant's provider. Full detail in the privacy policy.

Limits

Tool calls are rate limited to about 30 per minute per user. Over that you get a 429 with a Retry-After header.
Saves are built in the background and queue under load. A large plan takes around a minute for photos and ratings to finish landing.
The connector is free, and nothing it does can spend money. Koko's core is free too; some creators sell their lists in the app's Discover shelf as App Store purchases, but payment details never touch Koko either way. Standard account limits are in the Terms.
Koko is an early-access preview built by a small team. Place details come from third parties and can be out of date; check anything that matters before you travel for it.

Disconnecting

Disconnect Koko from your assistant's own connector settings. That revokes its access token immediately, and Koko stops accepting requests made on your behalf. Your lists and plans stay in your Koko account. To remove those too, delete your account from the account deletion section of the FAQ.

Support

A human reads every message. Email [email protected] with what you asked the assistant and what came back. See also the FAQ, privacy policy and terms.