Mercantry Registry

Working · 703 ms

org.mercantry/registryv0.1.0 Domain verified

Agent-native registry: 168k+ real restaurants in LA, Hong Kong & Tokyo. Unranked, honest signals.

Local Services

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mercantry.org/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_booking

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.

booking_idstring, required

reasonstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

cancel_booking

Argument	Type	Description
reason	string
booking_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "booking_id"
  ],
  "properties": {
    "reason": {
      "type": "string"
    },
    "booking_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_availability

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.

Argument	Type	Description
merchant_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_id"
  ],
  "properties": {
    "merchant_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_booking_status

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.

Argument	Type	Description
booking_id*	string
include_events	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "booking_id"
  ],
  "properties": {
    "booking_id": {
      "type": "string"
    },
    "include_events": {
      "type": "boolean"
    }
  },
  "additionalProperties": false
}

get_merchant

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.

Argument	Type	Description
merchant_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "merchant_id"
  ],
  "properties": {
    "merchant_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_registry_meta

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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

modify_booking

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).

Argument	Type	Description
datetime	string	New requested time, ISO-8601; naive means the merchant's local wall time
booking_id*	string
party_size	integer
window_minutes	integer
accept_option_index	integer	Index into needs_input_options to accept

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "booking_id"
  ],
  "properties": {
    "datetime": {
      "type": "string",
      "description": "New requested time, ISO-8601; naive means the merchant's local wall time"
    },
    "booking_id": {
      "type": "string"
    },
    "party_size": {
      "type": "integer",
      "minimum": 1
    },
    "window_minutes": {
      "type": "integer",
      "maximum": 240,
      "minimum": 0
    },
    "accept_option_index": {
      "type": "integer",
      "minimum": 0,
      "description": "Index into needs_input_options to accept"
    }
  },
  "additionalProperties": false
}

place_booking

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.

Argument	Type	Description
contact	string	Optional phone/email for confirmation relay to the end human
datetime*	string	Requested time, ISO-8601. Naive ('2026-07-18T19:00') means the merchant's LOCAL wall time (see the merchant's timezone field); an explicit offset ('2026-07-18T19:00:00+09:00') is also accepted
party_size*	integer
merchant_id*	string
callback_url	string	Webhook URL for booking state-change events

search_merchants

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.

Argument	Type	Description
lat	number	Latitude for geo-radius filter (requires lng and radius_km)
lng	number
limit	integer
offset	integer
open_at	string	ISO-8601 datetime; only merchants open at this time. With an explicit offset ('2026-07-18T19:00:00+09:00' or trailing Z) the instant is evaluated in each merchant's own timezone; without one it means each merchant's local wall clock
sandbox	boolean	Filter by merchant kind. true = sandbox test merchants only (safe integration targets: they book end-to-end and return a SIMULATED confirmation, never dialing a real venue). false = real merchants only — use this for any booking a human will act on. Omitted = both. Every result carries `sandbox`; never present a sandbox confirmation to a user as a real reservation.
order_by	string

submit_feedback

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.

Argument	Type	Description
free_text	string
booking_id*	string
would_repeat	boolean
seated_on_time	boolean
matched_description	boolean	Did the merchant match the registry's description?
reservation_honored*	boolean	Did the merchant honor the reservation?

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "booking_id",
    "reservation_honored"
  ],
  "properties": {
    "free_text": {
      "type": "string",
      "maxLength": 500
    },
    "booking_id": {
      "type": "string"
    },
    "would_repeat": {
      "type": "boolean"
    },
    "seated_on_time": {
      "type": "boolean"
    },
    "matched_description": {
      "type": "boolean",
      "description": "Did the merchant match the registry's description?"
    },
    "reservation_honored": {
      "type": "boolean",
      "description": "Did the merchant honor the reservation?"
    }
  },
  "additionalProperties": false
}

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "required": [ "merchant_id", "party_size", "datetime", "reservation_name" ], "properties": { "contact": { "type": "string", "description": "Optional phone/email for confirmation relay to the end human" }, "datetime": { "type": "string", "description": "Requested time, ISO-8601. Naive ('2026-07-18T19:00') means the merchant's LOCAL wall time (see the merchant's timezone field); an explicit offset ('2026-07-18T19:00:00+09:00') is also accepted" }, "party_size": { "type": "integer", "minimum": 1 }, "merchant_id": { "type": "string" }, "callback_url": { "type": "string", "format": "uri", "description": "Webhook URL for booking state-change events" }, "window_minutes": { "type": "integer", "maximum": 240, "minimum": 0, "description": "Acceptable +/- window around datetime" }, "sandbox_outcome": { "enum": [ "confirmed", "no_answer", "counter_offer", "fully_booked", "merchant_declined", "bad_data" ], "type": "string", "description": "TEST ONLY, sandbox merchants (sandbox: true): force the simulated call's result so you can exercise a specific branch on demand — confirmed, no_answer (retries then fails), counter_offer (pauses in needs_input), fully_booked, merchant_declined, bad_data. Rejected for real merchants; omit it in production" }, "reservation_name": { "type": "string", "description": "Name for the reservation" }, "special_requests": { "type": "string", "maxLength": 280 }, "client_reference_id": { "type": "string", "maxLength": 128, "minLength": 1, "description": "Your unique ID for this booking request (a UUID is ideal). Retrying with the same value returns the existing booking (idempotent_replay: true) instead of creating a duplicate; the same value with different parameters is rejected as client_reference_conflict" }, "accept_within_window": { "type": "boolean", "description": "Auto-accept merchant counter-offers inside the window (recommended: true)" } }, "additionalProperties": false }

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "lat": { "type": "number", "description": "Latitude for geo-radius filter (requires lng and radius_km)" }, "lng": { "type": "number" }, "limit": { "type": "integer", "maximum": 100, "minimum": 1 }, "offset": { "type": "integer", "minimum": 0 }, "open_at": { "type": "string", "description": "ISO-8601 datetime; only merchants open at this time. With an explicit offset ('2026-07-18T19:00:00+09:00' or trailing Z) the instant is evaluated in each merchant's own timezone; without one it means each merchant's local wall clock" }, "sandbox": { "type": "boolean", "description": "Filter by merchant kind. true = sandbox test merchants only (safe integration targets: they book end-to-end and return a SIMULATED confirmation, never dialing a real venue). false = real merchants only — use this for any booking a human will act on. Omitted = both. Every result carries `sandbox`; never present a sandbox confirmation to a user as a real reservation." }, "order_by": { "enum": [ "merchant_id", "distance" ], "type": "string" }, "radius_km": { "type": "number", "description": "Radius in km around lat/lng" }, "party_size": { "type": "integer", "minimum": 1, "description": "Only merchants that can seat this party size" }, "cuisine_tags": { "type": "array", "items": { "type": "string" }, "description": "Match ANY of these cuisines, e.g. ['japanese','korean']" }, "neighborhood": { "type": "string", "description": "Exact neighborhood name, e.g. 'Mission'" }, "bookable_only": { "type": "boolean", "description": "Only merchants the registry can book right now (phone-verified, accepts reservations, not opted out)" }, "attribute_tags": { "type": "array", "items": { "type": "string" }, "description": "Match ALL of these attributes, e.g. ['outdoor_seating','vegetarian_friendly']" }, "price_band_max": { "type": "integer", "maximum": 4, "minimum": 1 }, "price_band_min": { "type": "integer", "maximum": 4, "minimum": 1 } }, "additionalProperties": false }