Developers
MCP available

Quickstart: discover your first place

Choose either interface. The example flows below use Madrid and Museo Nacional del Prado from actual Evendo response samples.

Option A: MCP

  1. Connect an MCP-compatible client to https://mcp.evendo.com/mcp and initialize a session.
  2. Discover tools through tools/list.
  3. Call resolve_place with {"name":"Madrid","place_type":"Cities","country_code":"ES"}.
  4. The provided response resolves Madrid to id: "27799".
  5. Call find_venues with {"place_id":"27799","venue_type":"Attractions","limit":10}.
  6. Call get_venue with {"id":"3127593"} for Museo Nacional del Prado.

See the full MCP setup and tools reference.

Option B: GraphQL

bash
curl -sS 'https://evendo.com/api/locationSearchGraphQL' \
  -H 'Content-Type: application/json' \
  --data '{"query":"query { node(id: \"27799\") { id title node_type } }"}'

The endpoint accepts a JSON body with query and optional variables. Read GraphQL quickstart for JavaScript and Python examples.

Go beyond ratings with Place Score

The API supports place_score (0–100), filtering (min_place_score in MCP; place_score_gte / place_score_lte in GraphQL) and score-based sorting. See the Place Score guide.

Full GraphQL specification: Source-derived SDL · Argument catalog · Node field catalog · End-to-end recipes.