{"server":{"name":"com.joinplexa/plexa","title":"Plexa","$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","remotes":[{"url":"https://api.joinplexa.com/mcp/","type":"streamable-http"},{"url":"https://api.joinplexa.com/mcp/sse","type":"sse"}],"version":"1.0.0","repository":{"url":"https://github.com/incrematica/plexa-mcp","source":"github"},"description":"Agentic directory of real businesses in Mexico & LATAM. Search by vertical and city."},"_meta":{"io.modelcontextprotocol.registry/official":{"status":"active","isLatest":true,"updatedAt":"2026-06-17T00:41:44.327265Z","publishedAt":"2026-06-17T00:41:44.327265Z","statusChangedAt":"2026-06-17T00:41:44.327265Z"},"dev.protogrid/connectability":{"class":"R0","autonomous":true,"human_steps":[],"preferred":{"kind":"remote","idx":0},"remotes":[{"idx":0,"url":"https://api.joinplexa.com/mcp/","transport":"streamable-http","templated":false,"headers":[],"auth":{"type":"none","location":null,"secret_name":null,"oauth":null},"protocol":{"supported_versions":["2025-11-25"],"stateless":true},"health":{"reachable":true,"uptime_30d":1,"latency_ms_p50":228,"consecutive_failures":0,"last_probe_at":"2026-10-20T08:56:39.798Z","last_ok_at":"2026-10-20T08:56:39.798Z"}},{"idx":1,"url":"https://api.joinplexa.com/mcp/sse","transport":"sse","templated":false,"headers":[],"auth":{"type":"none","location":null,"secret_name":null,"oauth":null},"protocol":{"supported_versions":["2025-11-25"],"stateless":true},"health":{"reachable":true,"uptime_30d":0.982906,"latency_ms_p50":207,"consecutive_failures":0,"last_probe_at":"2026-10-20T04:51:11.447Z","last_ok_at":"2026-10-20T04:51:11.447Z"}}],"packages":[]},"dev.protogrid/tools":[{"name":"contact_business","title":null,"description":"Get all contact information and actionable capabilities for a business. Best way to help a user reach out to a business.\n\nUSE WHEN:\n- User wants to contact, call, message, or book with a business\n- User says \"how do I reach them?\", \"can I WhatsApp them?\"\n- You need the direct action URLs (WhatsApp links, phone, email)\n- User is ready to take action (book, reserve, inquire)\n\nDO NOT USE WHEN:\n- User is still browsing/comparing (use search_businesses)\n- User needs full business details (use get_business)\n\nRETURNS: Phone number, WhatsApp URL (pre-filled message), email, website, and all capabilities with executable action_urls. Each capability has action_type (whatsapp/phone/url/email) and a ready-to-use action_url.\n\nBEST PRACTICES:\n- capabilities.action_url contains ready-to-use links — present these directly to the user\n- WhatsApp links (wa.me/...) include a pre-filled message mentioning Plexa for tracking\n- Prefer WhatsApp over phone for Mexican businesses — most prefer messaging over calls\n- If the business has a booking_url, present it as the primary action for reservations\n\nEXAMPLES:\n- contact_business(slug=\"harmony-dental-studio-tijuana\") -> returns whatsapp_url, phone, capabilities with action_urls","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"},{"name":"get_business","title":null,"description":"Retrieve the complete profile of a specific business by its slug.\n\nUSE WHEN:\n- You already know the business slug from a previous search result\n- User asks for details about a specific business: hours, services, prices, contact info\n- You need the full profile including services, specialties, description, and all capabilities with action URLs\n\nDO NOT USE WHEN:\n- You don't know the slug (use search_businesses first to find it)\n- You only need contact info (use contact_business — lighter response)\n- You need to compare multiple businesses (use search_businesses)\n\nRETURNS: Complete business profile with all fields: name, description, hours, services with prices, specialties, capabilities with action_urls, trust_score, profile_completeness, languages, payment_methods, insurance_accepted, social_media, areas_served, agent_instructions, and faqs (owner-approved question/answer pairs — authoritative answers to common questions about this business).\n\nBEST PRACTICES:\n- The slug comes from search_businesses results (field: slug)\n- agent_instructions contains business-owner notes for agents — follow these when presenting the business\n- capabilities have action_type (whatsapp/phone/url/email) and action_url ready to use — pass directly to user\n- profile_completeness > 70% means reliable, complete data\n\nEXAMPLES:\n- get_business(slug=\"harmony-dental-studio-tijuana\")\n- get_business(slug=\"cabo-nature-cabo-san-lucas\")","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"},{"name":"get_business_faqs","title":null,"description":"Get the owner-approved FAQs (frequently asked questions with answers) for a business.\n\nUSE WHEN:\n- User asks a specific question about a business that an FAQ might answer (\"do they take walk-ins?\", \"is parking available?\", \"do they speak English?\")\n- You want authoritative, business-approved answers rather than inferring from other fields\n- User asks \"what do people usually ask about this place?\"\n\nDO NOT USE WHEN:\n- You already have faqs from get_business (it includes them)\n- The business has no FAQs (the answer will be an empty list — fall back to get_business fields)\n\nRETURNS: List of FAQs, each with question and answer (in the business's language). These are written/approved by the business owner and grounded in real ficha data — safe to quote directly.\n\nBEST PRACTICES:\n- If you already called get_business, faqs are included — don't call this separately\n- Quote the answer directly; it's the owner's authoritative wording\n- If the list is empty, the business hasn't published FAQs yet — use other profile fields\n\nEXAMPLES:\n- get_business_faqs(slug=\"clinica-dental-costa-azul-cabo-san-lucas\")","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"},{"name":"get_business_hours","title":null,"description":"Get opening hours for a specific business by day of the week.\n\nUSE WHEN:\n- User asks \"are they open right now?\", \"what time do they close?\"\n- User needs to know hours for a specific day: \"open on Sunday?\"\n- Planning a visit and needs schedule info\n\nDO NOT USE WHEN:\n- You already have hours from get_business (it includes them)\n- You need more than just hours (use get_business for full profile)\n\nRETURNS: Opening hours organized by day, with open/close times. Includes today's hours highlighted.\n\nBEST PRACTICES:\n- If you already called get_business, hours are included — don't call this separately\n- Hours are in 24h format (09:00-18:00)\n- Some businesses have different weekend hours\n\nEXAMPLES:\n- get_business_hours(slug=\"california-s-dental-clinic-tijuana\")\n- get_business_hours(slug=\"cabo-nature-cabo-san-lucas\", day=\"sunday\")","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"},{"name":"get_business_services","title":null,"description":"Get the list of services offered by a business, with prices and duration when available.\n\nUSE WHEN:\n- User asks \"how much does X cost?\", \"what services do they offer?\"\n- Comparing prices between businesses\n- User needs to know duration of a service\n\nDO NOT USE WHEN:\n- You already have services from get_business (it includes them)\n- You need more than just services (use get_business for full profile)\n\nRETURNS: List of services with name, price (in local currency), and duration_minutes when available.\n\nBEST PRACTICES:\n- If you already called get_business, services are included — don't call this separately\n- Prices are in the local currency (usually MXN or USD)\n- Not all businesses have prices listed — recommend contacting for a quote if prices are missing\n\nEXAMPLES:\n- get_business_services(slug=\"harmony-dental-studio-tijuana\")","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"},{"name":"list_verticals","title":null,"description":"List all available business verticals (categories) with the count of businesses in each.\n\nUSE WHEN:\n- User asks \"what types of businesses do you have?\"\n- User is exploring: \"what can I find on Plexa?\"\n- You need to know which verticals are available before searching\n- User uses a category you're not sure maps to a vertical\n\nDO NOT USE WHEN:\n- You already know the vertical (go straight to search_businesses)\n- User named a specific service (search_businesses with that vertical)\n\nRETURNS: List of verticals with key (for search) and count of active businesses in each.\n\nCURRENT VERTICALS: dental, medical, veterinary, restaurant, realestate, professional, insurance, tourism, wellness, events, automotive, hospitality, other\n\nBEST PRACTICES:\n- Use the vertical key (not display name) in search_businesses\n- \"dentist\" -> dental, \"hotel\" -> hospitality, \"spa\" -> wellness\n- Call this once at the start if you'll do multiple searches\n\nEXAMPLES:\n- list_verticals() -> [{key: \"dental\", count: 430}, {key: \"restaurant\", count: 801}, ...]","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"},{"name":"search_businesses","title":null,"description":"Find real local businesses in Mexico and Latin America by location, vertical, and capabilities.\n\nUSE WHEN:\n- User asks for a service: \"find me a dentist\", \"best restaurant\", \"tour in Cabo\"\n- Location-based queries: \"near me\", \"in Tijuana\", \"Cancun area\"\n- Comparing multiple options: \"top 3 dentists\", \"best rated hotels\"\n- Travel planning: \"things to do in Merida\", \"where to eat in CDMX\"\n- Medical tourism: \"affordable dental work near the border\"\n\nDO NOT USE WHEN:\n- User asks about a specific named business (use get_business instead)\n- User needs contact info for a known business (use contact_business)\n- User asks what types of businesses are available (use list_verticals)\n\nRETURNS: List of businesses ordered by tier (Connected/claimed first), then trust_score, then recency. Each result includes name, city, rating, vertical, trust_score, profile_completeness, and actionable capabilities with WhatsApp deep links. If no results, returns a message with alternative cities for that vertical.\n\nBEST PRACTICES:\n- Always include vertical for better results\n- Use city name in Spanish: \"Ciudad de Mexico\" not \"Mexico City\"\n- Combine vertical + city for best precision\n- The registry spans Mexico and Latin America: by default the search covers EVERY country it holds.\n  Pass `country` (ISO 3166-1 alpha-2, e.g. 'MX', 'CO') only to restrict it on purpose.\n- Results include capabilities with action_urls — pass these directly to the user for booking/contact\n\nEXAMPLES:\n- \"dentist in Tijuana\" -> vertical=dental, city=Tijuana\n- \"restaurants in Cancun\" -> vertical=restaurant, city=Cancún\n- \"spa near Cabo\" -> vertical=wellness, city=Cabo San Lucas\n- \"hotel in Medellin Colombia\" -> vertical=hospitality, city=Medellín","annotations":null,"source":"probe","observed_at":"2026-10-20T08:56:39.798Z"}],"dev.protogrid/trust":{"score":86,"components":{"hygiene":100,"liveness":100,"freshness":65,"provenance":75},"drivers":["+repository","+dns-namespace","+reachable","+uptime-100%","~updated-125d-ago"],"flags":[],"blocked":false,"computed_at":"2026-10-20T08:47:06.002Z","disclaimer":"Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed."},"dev.protogrid/quality":{"score":76,"label":"good","components":{"auth":null,"hygiene":64,"protocol":75,"stability":100,"dependencies":null},"checks":[{"id":"protocol.modern","detail":"newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28","status":"warn","category":"protocol"},{"id":"protocol.stateless","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"protocol.transport","detail":"streamable HTTP","status":"pass","category":"protocol"},{"id":"protocol.list_ttl","detail":"only applies to 2026-07-28 servers","status":"na","category":"protocol"},{"id":"auth.prm","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.as_metadata","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.cimd","detail":"no remote uses OAuth","status":"na","category":"auth"},{"id":"auth.secret_in_url","detail":"no templated URL","status":"na","category":"auth"},{"id":"tools.descriptions","detail":"every tool has a description","status":"pass","category":"hygiene"},{"id":"tools.description_length","detail":"5 tools have descriptions over 1,024 characters, which crowds the context","status":"warn","category":"hygiene"},{"id":"tools.schemas","detail":"every tool has an object input schema","status":"pass","category":"hygiene"},{"id":"tools.annotations","detail":"no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones","status":"fail","category":"hygiene"},{"id":"tools.directory_hints","detail":"no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_business (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_business_hours (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_business_services (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …","status":"fail","category":"hygiene"},{"id":"tools.token_cost","detail":"about 2,626 tokens to load every tool","status":"pass","category":"hygiene"},{"id":"tools.api_dump","detail":"tools are not a one-to-one API dump","status":"pass","category":"hygiene"},{"id":"stability.changes","detail":"no tool changes in 30 days","status":"pass","category":"stability"},{"id":"stability.rug_pull","detail":"no tool changed its meaning under the same name","status":"pass","category":"stability"},{"id":"deps.known_vulns","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.mcp_sdk_version","detail":"no npm or PyPI package","status":"na","category":"dependencies"},{"id":"deps.resolvable","detail":"no npm or PyPI package","status":"na","category":"dependencies"}],"drivers":["-tools.annotations","-tools.directory_hints","~protocol.modern","~tools.description_length"],"flags":[],"tool_count":7,"token_estimate":2626,"tools_hash":"542c86e3c8158e16808bf2d34e003422","tools_changed_at":null,"computed_at":"2026-10-20T08:58:21.337Z","disclaimer":"Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed."},"dev.protogrid/identity":{"canonical_id":"com.joinplexa/plexa","aliases":[],"alias_count":0,"repository_key":"github:incrematica/plexa-mcp","owner":{"verified":false,"method":null,"since":null}}},"next_actions":[{"action":"list_tools","description":"Every current tool with input schemas","href":"/v1/servers/com.joinplexa%2Fplexa/tools","arguments":{"name":"com.joinplexa/plexa"}},{"action":"get_connection","description":"Minimal connection block for the preferred remote or package","href":"/v1/servers/com.joinplexa%2Fplexa/connection?target=mcpServers","arguments":{"name":"com.joinplexa/plexa","target":"mcpServers"}},{"action":"search","description":"Find other servers by intent","href":"/v1/search?q={query}","arguments":{"q":"{query}"}}]}