Developers and AI assistants

Everything on this site is readable by machines on purpose. Pick the door that fits.

AI assistants (MCP connector)

Add this URL as a custom connector in Claude, ChatGPT or any MCP client. It needs no login and is read-only:

https://www.activityplaces.com/mcp

Tools: search_activities (by town or coordinates, audience, adrenaline level, activity type, indoor or outdoor), get_activity, list_activity_types, plus the generic search and fetch pair. Every result carries the canonical page URL so answers can link to their source.

Crawlers and search

• /llms.txt: a short map of the site for language models.
• Add .md to any place URL for a clean Markdown version.
• /sitemap.xml and /robots.txt (with a Content-Signal policy).
• Every page carries schema.org structured data: publisher, source record, coordinates and last-modified date.

JSON API

The API lives under /api/v1 and needs a key, sent as Authorization: Bearer <key>. The machine-readable description is at /openapi.json (it works as a ChatGPT Action).

curl -H "Authorization: Bearer $KEY" \
  "https://www.activityplaces.com/api/v1/places?near=Reston&audience=kids&adrenaline_min=3&limit=5"

• GET /api/v1/places: search. Parameters: q, near, lat+lng, radius_km, region, category, group, audience, adrenaline_min, adrenaline_max, setting, has_video, sort, limit, offset.
• GET /api/v1/places/{id-or-slug}: one place in full.
• GET /api/v1/categories and GET /api/v1/regions.

Free keys allow 60 requests a minute. Keys are issued by the site owner.

Attribution

Place data is © OpenStreetMap contributors under the Open Database License (ODbL) 1.0. If you show it, credit OpenStreetMap, and please link the ActivityPlaces page you took it from.