- name
- ikuzo
- description
- Manage maps, spots, and travel plans on Ikuzo (ikuzo.app) — a location-based exploration app. Use when creating/editing maps, adding/searching spots, planning trips with day-by-day itineraries, finding nearby places, or managing travel logistics. Triggers on map management, spot tracking, trip planning, location discovery, and "where should I go" questions.
Ikuzo
Ikuzo is a map & travel planning app. Access via MCP (JSON-RPC 2.0 over HTTP POST).
Connection
Endpoint: https://ikuzo.app/api/mcp
Auth: Bearer token (from TOOLS.md or user config)
Protocol: JSON-RPC 2.0 — POST with {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"<tool>","arguments":{...}}}Tools
Maps
maps_list— list all maps (owned + shared)maps_get(mapId)— get map detailsmaps_create(title)— create a new empty map, returns map with ID
Spots
spots_list(mapId, ...)— list/filter spots in a map. Filters:status[],type[],period[],momentFrom/To,text,limit,offset,fields[]spots_get(spotId)— get spot detailsspots_create(mapId, title, gps{lat,lng}, ...)— create spot. Optional:description,type,status,period[],moment{date, repeat, reminder[]}spots_update(spotId, ...)— update any field (includingmoment,rating)spots_delete(spotId)— soft delete (recoverable)spots_nearby(lat, lng, ...)— find spots near a point across ALL accessible maps. Optional:radius(km, default 10, max 500),mapIds[], all spot filters. Returns sorted by distance.spots_box(north, south, east, west, ...)— find spots in bounding box. Same filters as nearby.
Travel Plans
travels_list— list all travel planstravels_get(travelId)— get plan with stepstravels_create(title)— create plantravels_update(travelId, title)— rename plantravels_delete(travelId)— delete plan
Steps (within a travel plan)
steps_add(travelId, type, ...)— add step.type="spot"requiresspotId,type="day"requirestitle. Optional:orderKeysteps_update(stepId, ...)— update position or titlesteps_delete(stepId)— remove step
Utility
ping— test connectionschema— get valid values fortype,status,periodquota— check API usage (doesn't count against quota)
Schema Reference
See references/schema.md for valid spot types, statuses, and periods. Call schema tool at runtime if unsure.
Key Patterns
Find spots to visit nearby
spots_nearby(lat, lng, radius=20, status=["a","b"])Status a = "Ikuzo!" (priority), b = "To Visit"
Seasonal spots with upcoming moments
spots_list(mapId, momentFrom="2026-03-01", momentTo="2026-04-30")Create a trip itinerary
travels_create(title)→ get travelIdsteps_add(travelId, type="day", title="Day 1 - Arrival")steps_add(travelId, type="spot", spotId="...")for each spot- Repeat day dividers + spots for each day
Efficient listing (reduce tokens)
Use fields to request only what you need:
spots_list(mapId, fields=["_id","title","gps","status","type"])Image URLs
Spot images use Ikuzo's CDN:
https://ik.offbeatjapan.org/ikuzo/{imageId}.{ext}?tr=h-{height},w-{width}Where imageId and ext come from the spot's image[] array.