MCP examples: complete discovery recipes

These are tool argument objects, to be passed to the named MCP tools by your client or SDK, not HTTP POST bodies for the GraphQL endpoint.

Find the best attractions in Madrid

resolve_place:

{"name":"Madrid","place_type":"Cities","country_code":"ES"}

find_venues:

{"place_id":"27799","venue_type":"Attractions","sort_by":"best","limit":10}

get_venue for Museo Nacional del Prado:

{"id":"3127593"}

High Place Score attractions

find_venues:

{"place_id":"27799","venue_type":"Attractions","min_place_score":85,"sort_by":"place_score","limit":10}

Find rooftop bars in Madrid

search_venues:

{"text":"rooftop bar","within_place_id":"27799","venue_type":"Bars","limit":10}

Do not place “Madrid” inside the text argument when already restricting the search to Madrid.

Family-friendly outdoor attractions

find_venues:

{"place_id":"27799","venue_type":"Attractions","environment":"Outdoor","audience":["Family Friendly"],"limit":20}

A specific kind of food

find_venues for precisely categorized sushi:

{"place_id":"27799","venue_type":"Restaurants","category":"Sushi","min_rating":4.2,"min_reviews":20}

Alternatively, use search_venues with text: "sushi" when exact category coverage is uncertain.

Explore neighbourhoods

list_subareas:

{"place_id":"27799","area_type":"Neighbourhoods","limit":30}

Find venues near a landmark

First obtain the landmark's coordinates using get_venue (or a place search). Then query:

{"place_id":"27799","venue_type":"Restaurants","near":{"lat":40.4137818,"lon":-3.6921271,"radius_km":1.5},"sort_by":"nearest","limit":10}

These coordinates are the Prado Museum location returned by get_venue.

Pagination

If the response includes next_cursor, call the same tool with unchanged arguments and add "cursor": "<exact cursor returned>". Do not reuse cursors across different sorts, search terms or filters.