Valpp.io

Get search schema

Enumerates the filters accepted by `search_entities`, grouped by faceta (location, acceptance, facilities, services, policy, availability). When `type` is supplied, also returns the attribute keys, services and trust signals defined for that entity type. Use this before crafting a `search_entities` call so you know which params exist and which values enums accept.

Search entities

Search Valpp's directory of pet services in Spain. Coverage: SPAIN ONLY. Currently searchable entity types: boarding, veterinarian, restaurant. Planned but not yet available (do NOT use for these): groomer, trainer, shelter, transportation, breeder, daycare, beach, camping, hotel, insurance, food_provider, toy_shop, snack_shop. Supports geographic filters at multiple granularities (neighborhood, city, county/province, autonomous region, natural region) in addition to type, geolocation, opening h

Check availability

Check real availability for the requested dates among Valpp centers (boarding today). Returns only centers with a declared availability window covering the whole range, with capacity and notes when published. `managed: true` means the center is registered in Valpp and keeps its own calendar up to date; `managed: false` means the window comes from catalog data. If there is no availability, or the user wants centers to get back to them, use `request_service` next.

Request service (send to matching centers)

Send the user's service request to Valpp centers that match the location, dates and criteria. Registered centers see it in their Valpp inbox and contact the user directly. IMPORTANT: contact details are REQUIRED (name plus email or phone) and are shared with the matching centers — you MUST tell the user this and get their explicit agreement BEFORE calling this tool. Use `check_availability` first; this tool is for when the user wants centers to get back to them.

Get entity by slug

Fetch full details of a single Valpp entity by slug: contact, opening hours, services, attributes, trust signals, reviews, and schema.org JSON-LD. Response also includes `external_refs` (e.g. `google_place_id`, `apple_maps_id`, `tripadvisor_id`) for dedup/cross-linking with other catalogs, and `social` (Instagram, Facebook, TikTok, WhatsApp, booking/menu URLs).

Compare entities

Return 2-4 Valpp entities side by side for comparison (rating, price, services, trust signals).

List entities (paginated index)

Return a lightweight paginated index of entities in the Valpp directory (id, slug, type, name, city). Use for enumeration and cataloging. Results are capped at 200 per page — pass `offset` to paginate. Response includes `total` and `next_offset` (null when there are no more results).