{"server":{"name":"org.mercantry/registry","title":"Mercantry Registry","$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","remotes":[{"url":"https://mercantry.org/mcp","type":"streamable-http"}],"version":"0.1.0","repository":{"url":"https://github.com/mercantry/registry","source":"github"},"websiteUrl":"https://mercantry.org","description":"Agent-native registry: 168k+ real restaurants in LA, Hong Kong & Tokyo. Unranked, honest signals."},"_meta":{"io.modelcontextprotocol.registry/official":{"status":"active","isLatest":true,"updatedAt":"2026-07-24T02:47:08.066947Z","publishedAt":"2026-07-24T02:47:08.066947Z","statusChangedAt":"2026-07-24T02:47:08.066947Z"},"dev.protogrid/connectability":{"class":"R0","autonomous":true,"human_steps":[],"preferred":{"kind":"remote","idx":0},"remotes":[{"idx":0,"url":"https://mercantry.org/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":227,"consecutive_failures":0,"last_probe_at":"2026-10-19T17:07:31.620Z","last_ok_at":"2026-10-19T17:07:31.620Z"}}],"packages":[]},"dev.protogrid/tools":[{"name":"cancel_booking","title":"Cancel a booking","description":"Cancel a booking in any non-terminal state, or a confirmed reservation (the registry notifies the merchant). Cancellation is mandatory when the human no longer wants the table — no-shows destroy merchant trust and are tracked per developer key.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"get_availability","title":"Get availability (honest v1 behavior)","description":"V1 does NOT hold live table availability — availability is checked on the phone call at booking time. This tool returns the merchant's reservation policy, structured hours, and holiday exceptions so you can pick a plausible time before calling place_booking.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"get_booking_status","title":"Get booking status","description":"State machine position for a booking: pending → queued → in_progress → confirmed | failed | needs_input (plus cancelled). Includes structured details on confirmation (confirmed_time, confirmation_code, merchant_instructions), structured failure reason (no_answer | fully_booked | closed | policy_mismatch | merchant_declined | bad_data), or needs_input options awaiting your decision. include_events=true returns the full audit log.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"get_merchant","title":"Get merchant (full signal dump)","description":"Every field the registry holds on one merchant: schema fields, structured hours, raw feedback history, platform-observed operational stats, and per-field provenance with timestamps. Maximal data, zero opinion — the registry never scores or ranks.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"get_registry_meta","title":"Get registry metadata","description":"Evaluate the registry itself: per-city coverage (with each city's IANA timezone), merchant/bookable counts, verification and freshness stats, feedback corpus size, schema version, and the documented deterministic ordering rule. Honest by design — including how stale the data is.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"modify_booking","title":"Modify a booking / resolve needs_input","description":"Amend a booking before or after the call. For a booking in needs_input: pass accept_option_index to take one of the merchant's offered times (confirms immediately), or pass a new datetime/party_size to re-queue an amended request. Modifying an already-confirmed booking cancels it and books the new request (new booking_id returned).","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"place_booking","title":"Place a booking (async)","description":"Request a table reservation. Returns booking_id with state 'queued' immediately; fulfillment is asynchronous (a call is placed to the merchant). Poll get_booking_status or supply callback_url for webhooks. RETRY SAFETY: pass a unique client_reference_id (recommended: always); if this call times out or errors ambiguously, retry with the SAME client_reference_id and the registry returns the already-created booking instead of double-booking the restaurant. Never re-call place_booking after a timeout without one. If the merchant counter-offers a time within window_minutes and accept_within_window=true, it is auto-accepted (recommended). Otherwise the booking pauses in needs_input for you to resolve via modify_booking. Merchants on the human_call channel are fulfilled by a human operator during the operator window published in get_registry_meta — those bookings queue until worked (up to the channel SLA), so book ahead rather than for the next hour.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"search_merchants","title":"Search merchants","description":"Filter-based search over the restaurant registry (coverage cities + timezones in get_registry_meta). NOT ranked: results come back in deterministic order (merchant_id ASC by default; distance ASC when lat/lng given and order_by=\"distance\"). Returns compact records with pagination. Use get_merchant for the full signal dump on a specific merchant. All filters are optional and combinable.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"},{"name":"submit_feedback","title":"Submit post-visit feedback","description":"Report how a confirmed reservation actually went. Accepted only against a confirmed booking_id, once per booking, within 14 days of confirmation. Structured fields first; optional free text ≤ 500 chars. This corpus is served raw to all agents via get_merchant — it is never editorialized or turned into a score.","annotations":null,"source":"probe","observed_at":"2026-10-19T17:07:31.620Z"}],"dev.protogrid/trust":{"score":97,"components":{"hygiene":100,"liveness":100,"freshness":85,"provenance":100},"drivers":["+repository","+namespace-matches-repo","+dns-namespace","+website","+reachable","+uptime-100%","~updated-88d-ago"],"flags":[],"blocked":false,"computed_at":"2026-10-19T17:48:51.225Z","disclaimer":"Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed."},"dev.protogrid/quality":{"score":79,"label":"good","components":{"auth":null,"hygiene":71,"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":"descriptions are concise","status":"pass","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: search_merchants (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_availability (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); cancel_booking (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …","status":"fail","category":"hygiene"},{"id":"tools.token_cost","detail":"about 2,316 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"],"flags":[],"tool_count":9,"token_estimate":2316,"tools_hash":"66b39dd020c1ff81d36f823684623f98","tools_changed_at":null,"computed_at":"2026-10-19T17:57:43.054Z","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":"org.mercantry/registry","aliases":[],"alias_count":0,"repository_key":"github:mercantry/registry","owner":{"verified":false,"method":null,"since":null}}},"next_actions":[{"action":"list_tools","description":"Every current tool with input schemas","href":"/v1/servers/org.mercantry%2Fregistry/tools","arguments":{"name":"org.mercantry/registry"}},{"action":"get_connection","description":"Minimal connection block for the preferred remote or package","href":"/v1/servers/org.mercantry%2Fregistry/connection?target=mcpServers","arguments":{"name":"org.mercantry/registry","target":"mcpServers"}},{"action":"search","description":"Find other servers by intent","href":"/v1/search?q={query}","arguments":{"q":"{query}"}}]}