Use Waypoint from Claude, ChatGPT and any AI agent
Waypoint is a community map of anonymous travel reviews. Its whole read surface is open to agents: every place, its 1–5 star rating, its 10 most recent reviews, and an AI summary. Free, anonymous, no signup, no key.
MCP? You do not need one here
MCP (Model Context Protocol) is the standard that lets AI assistants call external tools. Waypoint does not run an MCP server — its read API is plain, anonymous HTTP, so any agent with a fetch tool already has full access. Three standard files describe the site to machines. Point your agent at them and ask away.
Start here: the discovery files
llms.txt
A small markdown map of the site (llmstxt.org). Read this first: it links every page and endpoint.
openapi.json
OpenAPI 3.1 spec of the public read API. Import it as a tool, an Action, or a code generator input.
.well-known/api-catalog
RFC 9727 linkset. Machine-readable pointer from the API to its spec and its docs.
How to connect
Claude Code and coding agents
- Give the agent the llms.txt URL. It maps every page and endpoint.
- The agent then calls the read API directly with its fetch tool.
claude "Read http://localhost:3000/llms.txt and find the best-rated coffee shop in Florence"Claude, ChatGPT, and chat assistants
- Paste the llms.txt URL into your message and ask your question.
- Assistants with web access fetch the pages and the API on their own.
Read http://localhost:3000/llms.txt, then compare the top 3 restaurants in Venice.Custom GPTs, tools, and SDKs
- Import the OpenAPI 3.1 spec as an Action or a tool definition.
- No auth. Three GET operations. Responses use a { data, meta } envelope.
http://localhost:3000/openapi.jsonAny HTTP client
- Call the API base URL directly. Errors follow RFC 9457 problem details.
- Watch the RateLimit headers; back off on 429 + Retry-After.
curl http://localhost:3000/api/backend/api/v1/pois/directory
What your agent can read
Base URL: http://localhost:3000/api/backend
| Endpoint | What it returns |
|---|---|
GET /api/v1/pois/directory | Every place, with id, name, category, rating, and lastModified. |
GET /api/v1/pois/{id} | One place in full: average rating, 10 most recent reviews, and the AI summary. |
GET /api/v1/pois?bbox=west,south,east,north | Places inside a bounding box. Filter with categories and limit. |
Things to ask
- “Read the Waypoint llms.txt, then find the best-rated coffee shop in Florence.”
- “Which coworkings in Venice have an average rating above 4 stars?”
- “Compare the top 3 restaurants near the Rialto bridge and quote their newest reviews.”
- “Summarize what reviewers dislike about hotels in Florence.”
Fair use
The read API is free for trip research. Each IP has a request budget; the current policy travels in the IETF RateLimit headers of every response, and an exhausted budget answers 429 with Retry-After. It is not a bulk-export API. When you publish anything based on the data, link back to the place page (/place/<id>).