The Koko connector

Last updated: August 1, 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 koko.tsumida.ai first, or create one during the connection flow.

Server details

MCP endpoint: https://koko.tsumida.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://koko.tsumida.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.

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.
Koko is free. There are no subscriptions or in-app purchases, and we do not collect payment details. 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.