pifini-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_eventsA | Search upcoming events (festivals, carnivals, concerts, food + cultural events) across the Caribbean, Latin America, and beyond. Returns event names, dates, locations, category, price (when known), and page URLs. Strongest coverage: Barbados, Trinidad, Jamaica, Bahamas, Mexico. |
| get_eventA | Full details for one event by slug: description, venue, date/time, and available ticket types with prices and remaining stock. Use the slug from search_events. |
| search_placesA | Search Pifini's places directory across the Caribbean and Latin America — restaurants, bars, beaches, attractions, venues, hotels, tour operators, professionals, and services. Every result carries listing_type: 'curated' is a small, editorially reviewed set of flagship entries; 'directory' is the much larger set sourced from open map data (name, category, location, contact info) that has no reviews yet — say so rather than implying a recommendation the data doesn't back up. Category is a specific Overture taxonomy value (e.g. caribbean_restaurant, church_cathedral), not a broad bucket — call list_categories first if unsure of the exact value. Results marked is_sponsored are paid placements — disclose that when recommending. |
| get_placeA | Full details for one place by slug, including its most recent published reviews if any exist. listing_type distinguishes a curated entry from an unreviewed directory listing (see search_places) — recent_reviews is often an empty array, which means no reviews yet, not a low-quality place. Use the slug from search_places. |
| list_categoriesA | Discover valid category values for search_places. Pifini's places directory uses Overture Maps' taxonomy — over 1,000 specific values like caribbean_restaurant, church_cathedral, landmark_and_historical_building — rather than broad buckets, so guessing a category string will usually miss. Call this first with a rough query (e.g. 'coffee' or 'beach') to find the exact value, then pass it to search_places' category parameter. |
| create_ticket_checkoutA | Create a secure Stripe-hosted payment link for event tickets. Returns a checkout URL — give it to the human to complete payment themselves; tickets with QR codes are emailed after payment. Get ticket_type_id values from get_event. Always confirm the exact tickets and total with the human before calling this. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| plan_trip | Build a trip itinerary for a Caribbean or Latin American destination, anchored on real events happening while you're there. |
| whats_on | Find events happening in a place over a given period, with prices and entry details. |
| find_places | Find restaurants, bars, beaches, venues, or services in a place — using Pifini's category vocabulary correctly. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| coverage | Upcoming event and place counts per country — read this to judge whether Pifini can usefully answer a question about a destination before searching. |
| solo-personal | You're going somewhere just for you. This list leans into self-reliance: redundant contacts, offline maps, a stash for the bad day, and enough comfort items that you don't cave on day 3. |
| solo-business | Minimum friction, maximum performance. Print copies, a backup outlet, and one nice-restaurant reservation so you don't default to the hotel bar. |
| family | Twice the packing, three times the patience. The decisive wins: kid-specific meds, snacks that don't melt, and a plan for the 4-hour transit gap. |
| couples | One of you plans, the other relaxes. Either way: one unscheduled day, one nice reservation, and a shared playlist. |
| friends-group | The best group trips have one obsessive planner + a shared spending kitty. Here's what to lock in. |
| group | Once you cross 8 people, logistics is the product. Name-tags, a single coordinator, and pre-negotiated rates matter more than which restaurant. |
| adventure-outdoor | Wild places punish under-preparation. The physical stuff matters — and so does telling someone where you are. |
| festival | Heat, crowds, dehydration, and the question of where to pee at 2am. Pack for the party but plan for the next morning. |
| safety-destination-basics | The non-negotiables, in one place. If you only read one guide before a trip, make it this one. |
TDQS
Scored across 6 tools
Each tool targets a distinct function: searching vs. getting details for events and places, listing categories, and creating a checkout. There is no overlap or ambiguity between any pair of tools.
All tool names follow a consistent verb_noun pattern in snake_case: search_events, get_event, search_places, get_place, list_categories, create_ticket_checkout. This makes the surface predictable and easy to navigate.
With 6 tools, the set is well-scoped for the server's purpose—covering both events and places with search, detail retrieval, and a checkout action. It is neither too sparse nor overly dense.
The tools cover the full consumer workflow: discover events/places, get full details, and purchase tickets. The supporting list_categories tool fills a potential gap in place search. No obvious missing operations for the stated domain.