For AI assistants
Ask your assistant about Okinawa with Ride Okinawa behind it
Ride Okinawa runs a read-only Model Context Protocol server. Add it to Claude, ChatGPT or any MCP client and the assistant can search the towns, stays, eat & drink, sights, culture, food, operators, getting around, events, climate, routes, ride days, islands and beaches in this guide, then link you to the page it used.
Endpoint
https://rideokinawa.com/api/mcp
Streamable HTTP, POST, no authentication.
Add it
In Claude, open Settings, then Connectors, add a custom connector and paste the endpoint. In ChatGPT, add it as a connector from the apps settings. Other clients take the same URL as a remote MCP server.
Tools
- search_places: Find anything in Ride Okinawa by free text, type and region: towns, stays, eat & drink, sights, culture, food, operators, getting around, events, climate, routes, ride days, islands and beaches. Returns the name, local name, region, a one-line summary and the page URL for each match.
- get_place: The full record for one entry by type and slug: every fact the site holds, the editorial text, quick answers, sources and when they were checked.
- find_nearby: Entries of one type within a radius of any place in the guide, nearest first, with the distance in km.
- get_climate: Monthly climate normals for the weather stations in the guide: average daily high and low, rain and rain days, sunshine, prevailing wind, humidity and any extra series (sea or lake temperature, snow depth). Give a month from 1 to 12, and a station slug or region slug to narrow it.
- get_connections: Every flight, ferry, train, tram, cable car or bus in the guide that touches a place, matched on the place's name or slug and on the ports, stations and airports at each end. Returns the operator, journey time, how often it runs, fares with their year, what weather cancels it and the timetable and page URLs.
- find_routes: Cycling routes in the guide, filtered by region, area, bike type, level and distance. Each result gives the distance (km), climbing (m), the share on quiet roads, the longest gap between resupply stops (km), the page URL and the GPX download URL. Every figure comes from routing the route over OpenStreetMap and sampling an elevation model.
- get_route: One cycling route in full: the computed numbers with their units, which direction leaves less headwind in each month, the riding notes (surface, traffic, shade, safety), the stops along the line from OpenStreetMap and from the guide, the ride days built on it, quick answers, the page URL and the GPX URL.
- get_crossings: Every ferry and flight in the guide that touches a given port, airport or island name, with duration, adult fare, whether bikes are carried and the winter weather pattern.
Try asking
- Find towns and neighbourhoods in Naha & Shuri.
- Tell me about Aharen, with the sources Ride Okinawa used.
- Which places to stay are within 5 km of Aharen?
- What should I know before visiting Abyan Yonaguni Guesthouse Kubura?
Plain text
An assistant without MCP can read /llms.txt, a map of every page, or /llms-full.txt, which holds the full text and data in one file.