Amsterdam Experiences API
REST API and MCP server for private guided tours in Amsterdam and the Netherlands. Designed for AI agents and developers.
API Base URL
https://amsterdamexperiences.nl/wp-json/aex/v1
No authentication required. All endpoints are public.
Endpoints
GET /tours— List all available tours with pricingGET /tours/{slug}— Get tour details by URL slugPOST /inquiry— Submit a booking inquiry
OpenAPI Specification
Full machine-readable spec: /.well-known/openapi.json
MCP Server
Amsterdam Experiences is available as a Model Context Protocol (MCP) server for AI agents.
- Endpoint:
https://amsterdamexperiences.nl/mcp(Streamable HTTP) - Discovery: /.well-known/mcp.json
- Tools:
search_tours,get_tour_details,submit_inquiry - Interactive tour cards in MCP Apps clients such as Claude and ChatGPT
- Official MCP Registry:
nl.amsterdamexperiences/tours - Full MCP documentation: Amsterdam Experiences MCP Server
Agent Guide
See agents.md for the full integration guide, auth details and usage examples.
Example: List Tours
curl https://amsterdamexperiences.nl/wp-json/aex/v1/tours
Example: Submit Inquiry
curl -X POST https://amsterdamexperiences.nl/wp-json/aex/v1/inquiry -H "Content-Type: application/json" -d '{"tour_slug":"best-of-bruges-private-guided-tour","date":"2027-05-15","guests":2,"name":"John Smith","email":"john@example.com"}'
Pricing
Machine-readable pricing: /.well-known/ai-pricing.json
Private tours from EUR 245 per booking (whole group). Small-group tours from EUR 69 per person.