Yenta Directory

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Anonymous, read-only cross-venue discovery of partner-approved venues, cities, destinations.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Yenta Directory": {
      "url": "https://yentaknows.ai/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (17)

• search read-only

  Search venues, travel destinations and places inside destinations by name or keyword. Returns results of id, title and url; pass an id to fetch for the full page. For filters use search_venues, search_menus or destination_listings.

  Parameters:

  • query (required) — string — A name or keywords, e.g. 'whale watching' or 'Acme Bistro'.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• fetch read-only

  Read a search result's full page: a restaurant's menu, dietary options, hours and events, or a destination's. Returns Markdown text with its citable url. Ids look like "venue:acme-bistro", "venue:acme-bistro:menu", "destination:los-cabos" or "listing:los-cabos:1234".

  Parameters:

  • id (required) — string — An id exactly as search returned it.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_venues read-only

  Find restaurants and bars by city, cuisine, opening time or features. Filters are HARD, prefer_* and avoid are SOFT (rank only), and query is a name, a keyword or a short description. Each result has slug, capabilities, open_now and distance_km; a place inside a destination is not here, use destination_listings.

  Parameters:

  • at — ['string', 'null'] — A local time (20:00 or 8pm); requires open_on.
  • city — ['string', 'null'] — HARD filter: only venues in this city (case-insensitive); call list_cities for the exact values this directory knows.
  • near — ['string', 'null'] — HARD filter: only venues within radius_km of this 'latitude,longitude' point, nearest first, each with a distance_km; venues with no coordinates are excluded.
  • avoid — array — SOFT: venues matching these cuisine/neighbourhood tokens rank LOWER; not dropped.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — A name, a cuisine word or a short description of the place (e.g. 'quiet seafood with a sea view'); a dish is in search_menus. Venues whose name, description, cuisine, neighbourhood, city or alternate names contain every word come first, then venues whose profile is closest in meaning, each with match.similarity; omit to list all.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • facets — array — HARD experiential-facet filter: each token is '<facet_type>:<value>' (e.g. 'dietary:vegetarian', 'vibe:romantic'); types are vibe, good_for, not_good_for, feature, noise_level, view, dress_code, meal_period, cuisine, dietary, accessibility. A venue must match every facet_type given (values OR within a type); a miss EXCLUDES it.
  • cuisine — ['string', 'null'] — HARD filter: only venues with this cuisine (case-insensitive exact match; a miss's reason lists the valid values).
  • open_on — HARD filter: only venues open on this weekday, or today/tomorrow in the venue's own timezone (optionally at 'at'); for tonight use open_on=today with at. Venues with no published hours are excluded.
  • open_now — ['boolean', 'null'] — Set true = open at this moment, not later today (venue local time); for tonight use open_on=today with at; omit otherwise.
  • radius_km — ['number', 'null'] — Search radius in km around 'near' (default applied when omitted).
  • price_band — ['string', 'null'] — HARD filter: only venues in this price band, e.g. '$$'.
  • neighbourhood — ['string', 'null'] — HARD filter: only venues in this neighbourhood (case-insensitive exact match; a miss's reason lists the valid values).
  • prefer_facets — array — SOFT experiential-facet preference, same '<facet_type>:<value>' tokens as facets: a venue that declares them ranks higher but is NEVER dropped.
  • prefer_cuisine — array — SOFT: venues of these cuisines rank higher; non-matches are NOT dropped.
  • accepts_reservations — ['boolean', 'null'] — Set true to require venues that take reservations (a booking link or a live booking tool); omit otherwise.
  • prefer_neighbourhood — array — SOFT: venues in these neighbourhoods rank higher; non-matches are NOT dropped.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_cities read-only

  List the cities that have published restaurants and bars. Travel destinations such as Los Cabos are not cities here; read one with destination_overview.

  Parameters:

  • limit — integer — Maximum number of items to return.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_menus read-only

  Find dishes across all venues by text, city, dietary tags or allergens to avoid. Each item is tagged with its venue, so one call compares venues; for one named venue use venue_menu.

  Parameters:

  • city — ['string', 'null'] — Only return items from venues in this city (case-insensitive); call list_cities for the exact values.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — Text matched in item name, description, section and menu names; every word must match; connector words (and, with, in) aren't required.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • allergens — array — Exclude items that declare any of these allergens (spelling-insensitive; synonyms match: milk, lactose and dairy all match dairy; pass one term).
  • max_price — ['number', 'null'] — Only items priced at or under this, in the menu's currency.
  • dietary_tags — array — Require ALL of these dietary tags (case- and separator-insensitive).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• send_feedback

  Send Yenta a report: data that is missing or looks wrong, a tool that was hard to use, or anything else. Stored for Yenta's team and never shown publicly; the answer carries a reference. Leave out personal details.

  Parameters:

  • kind (required) — string — What the report is about.
  • message (required) — string — The report itself, in plain words.
  • city — ['string', 'null'] — The city the question was about; a city name only, never an address.
  • tool — ['string', 'null'] — The Yenta tool the report is about, if any.
  • model — ['string', 'null'] — The model sending the report, e.g. its model id.
  • client — ['string', 'null'] — The app or agent the model runs in.
  • purpose — ['string', 'null'] — What the person was trying to do, in one short sentence.
  • subject — ['string', 'null'] — The venue, destination or city the report is about, if any.

  Hints: read-only no · destructive no · idempotent no · open-world no

• venue_profile read-only

  Get a venue's hours, address, map, phone, booking and links by name or slug, e.g. venue="Acme Bistro". It also holds cuisine, attributes, menu_summary and capabilities (the other venue_* tools that answer for it); hours_summary is ready to quote.

  Parameters:

  • venue (required) — string — Venue name or slug; call search_venues to discover one.
  • city — ['string', 'null'] — Disambiguate a name by city (call list_cities); ignored for a slug.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• venue_menu read-only

  Find dishes at a named venue, e.g. venue="Acme Bistro", dietary_tags=["vegan"], allergens=["milk"]. Filter by text, tags, allergens or max_price; unfiltered, item lists its dietary tags, example dishes and allergen counts. If not available, check the capabilities venue_profile lists; the venue may not publish this.

  Parameters:

  • venue (required) — string — Venue name or slug; call search_venues to discover one.
  • city — ['string', 'null'] — Disambiguate a name by city (call list_cities); ignored for a slug.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — Text matched in item name, description, section and menu names; every word must match; connector words (and, with, in) aren't required.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • allergens — array — Exclude items declaring any of these allergens (case- and separator-insensitive (gluten free = gluten-free); synonyms match: milk, lactose and dairy all match dairy; pass one term).
  • max_price — ['number', 'null'] — Only items priced at or under this, in the menu's currency.
  • dietary_tags — array — A JSON array, e.g. ["gluten-free"]: items must carry ALL of these tags; case- and separator-insensitive (gluten free = gluten-free).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• venue_faq read-only

  Answer a question about a named venue from its published FAQs; omit query to read them all. If not available, check the capabilities venue_profile lists; the venue may not publish this.

  Parameters:

  • venue (required) — string — Venue name or slug; call search_venues to discover one.
  • city — ['string', 'null'] — Disambiguate a name by city (call list_cities); ignored for a slug.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — Text to match against questions and answers.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• venue_events read-only

  Find what is on at a named venue: dated events from its local today onwards. Filter by exact event_type if you know it. If not available, check the capabilities venue_profile lists; the venue may not publish this.

  Parameters:

  • venue (required) — string — Venue name or slug; call search_venues to discover one.
  • city — ['string', 'null'] — Disambiguate a name by city (call list_cities); ignored for a slug.
  • limit — integer — Maximum number of items to return.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • to_date — ['string', 'null'] — ISO date; omit to_date for everything upcoming (recommended for "coming up").
  • from_date — ['string', 'null'] — ISO date; defaults to the venue's own local today, or to today UTC if it publishes no timezone.
  • event_type — ['string', 'null'] — Exact event_type spelling from published events.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_overview read-only

  One call answers what a destination offers and what's on: counts, a few places, next events and guide topics. It counts offers, seasonality and FAQs too, and names the categories and areas listings, events and offers filter by. preview.complete is false when destination_listings / destination_events hold more.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_listings read-only

  Find places to stay, eat and visit in a named destination by text, category, area or tags. Every query word matches, in any order; each business appears once (also_listed_as) with a snippet and map_url, so call it again with listing_id for the full text. An unknown filter value's reason lists the valid ones.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.
  • area — ['string', 'null'] — Area name or slug; destination_overview lists them.
  • tags — array — Tag slugs; only listings carrying ALL are returned.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — Words matched in any order against listing names, descriptions, tags and categories.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • category — ['string', 'null'] — Category name or slug; destination_overview lists them.
  • language — ['string', 'null'] — Language code (e.g. 'en', 'es'); defaults to the destination's.
  • radius_km — ['number', 'null'] — Search radius in km around near_listing_id; a larger value is reduced to the server maximum.
  • listing_id — ['string', 'null'] — One listing's id from a previous result: returns its full detail in item, ignoring the other filters; read a live linked_venue_slug with the venue_* tools, whose answer carries its booking link.
  • near_listing_id — ['string', 'null'] — A listing id; returns listings within radius_km, nearest first, each with distance_km.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_events read-only

  Find what is on in a named destination: events from today onwards. A recurring event's dates are its series span, so read its recurrence. Results carry booking_url, the partner's booking page when present, and canonical_url, the destination's page.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.
  • area — ['string', 'null'] — Area name or slug; destination_overview lists them.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — Words matched in any order against event names and descriptions.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • to_date — ['string', 'null'] — ISO date; omit to_date for everything upcoming (recommended for "coming up").
  • category — ['string', 'null'] — Category name or slug; destination_overview lists them.
  • from_date — ['string', 'null'] — ISO date; defaults to today.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_guide read-only

  Read a named destination's travel guides: weather, getting here, transport, entry requirements, safety and more. Pass topic (from destination_overview guide_topics) to read one subject; page with cursor.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.
  • limit — ['integer', 'null'] — Entries per page; omit for the server's short default.
  • query — ['string', 'null'] — Text to match in guide title/body.
  • topic — Guide topic; omit for all.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_faq read-only

  Answer a question about a named destination from its published FAQs; omit query to read them all.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.
  • limit — integer — Maximum number of items to return.
  • query — ['string', 'null'] — Text to match in question/answer.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_offers read-only

  Find a named destination's current deals and packages, with the partner booking link. Only offers valid on valid_on (today by default) are returned. Results carry booking_url, the partner's booking page when present, and canonical_url, the destination's page.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.
  • area — ['string', 'null'] — Area name or slug; destination_overview lists them.
  • limit — integer — Maximum number of items to return.
  • cursor — integer — Number of items to skip; pass `next_cursor` from the previous page.
  • category — ['string', 'null'] — Category name or slug; destination_overview lists them.
  • valid_on — ['string', 'null'] — ISO date an offer must be valid on (valid_from to valid_through, inclusive); defaults to today.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• destination_seasonality read-only

  Get a named destination's best time to visit, weather and wildlife seasons (e.g. whale watching), month by month.

  Parameters:

  • destination (required) — string — Destination name or slug, e.g. 'Los Cabos'; list_cities names them.
  • month — ['integer', 'null'] — 1-12; omit for all twelve.
  • interest — ['string', 'null'] — An activity or season, e.g. whales; keeps the months whose highlights or notes mention it.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.