Mercantry

Name: Mercantry
Author: Mercantry

AgentA2AMCP

Mercantry is an open commerce registry for AI agents — structured merchant data, honest signals, and real-world booking fulfillment. Interoperability, honestly: this service speaks MCP (streamable-http) and REST/OpenAPI — it does NOT implement the A2A JSON-RPC protocol. This card is published for d…

by Mercantryrepository ↗homepage ↗v1.0.0

Is this yours?

This record is unclaimed

Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.

Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"mercantry-registry","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.

Claim this record

Observed by Wellknown

Evidence

Everything here was measured by our prober or read from a registry. Nothing is self-reported.

30-day availability104/104 checks ok

when	check	result	http	latency	detail
6 h ago	mcp initialize	ok	200	172 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
15 h ago	mcp initialize	ok	200	174 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
24 h ago	mcp initialize	ok	200	174 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
32 h ago	mcp initialize	ok	200	332 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
2 d ago	mcp initialize	ok	200	355 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
2 d ago	mcp initialize	ok	200	181 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
2 d ago	mcp initialize	ok	200	335 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
3 d ago	mcp initialize	ok	200	176 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
3 d ago	mcp initialize	ok	200	347 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools
3 d ago	mcp initialize	ok	200	164 ms	server registry 1.0.0 · protocol 2025-06-18 · 9 tools

Tools observed via MCP handshake

search_merchants — Filter-based search over the restaurant registry (coverage cities + timezones in get_registry_meta). NOT ranked: results come back in deterministic order (merch
get_merchant — Every field the registry holds on one merchant: schema fields, structured hours, raw feedback history, platform-observed operational stats, and per-field proven
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, struc
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_bookin
get_booking_status — State machine position for a booking: pending → queued → in_progress → confirmed | failed | needs_input (plus cancelled). Includes structured details on confirm
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 immediate
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
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 fie
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 si

Hidden text

No hidden text found in the tool definitions.

Text a person reading a tool definition does not see and a model does. Invisible characters can be pasted in by accident; this says what is there, not why. Covers tools only, not prompts or resources.

Declared by sources

What the publisher says

Attributed to the source that supplied each field. Treated as claims, not facts.

searchrestaurantsmerchant-dataprovenanceno-rankingopen-databookingreservationsasyncsandboxfeedbackverifiedtrust

Declared skills

Merchant discovery — Filter-based search over the restaurant registry (search_merchants), full per-merchant signal dumps with per-field provenance and raw transaction-verified feedback (get_merchant), and honest registry self-description including staleness (get_registry_meta). Never ranked: deterministic, documented ordering only. Reads are free and keyless. Current coverage: 168,524 real merchants across Hong Kong (31,676), Los Angeles, CA (26,754), Tokyo (110,094), plus 500 sandbox test merchants.
Reservation booking (async) — Async table reservations: get_availability (honest v1 — availability is confirmed at booking time, not held live), place_booking, get_booking_status (poll or callback_url webhooks), modify_booking, cancel_booking. Bookings are accepted only for phone-verified bookable merchants. Real-merchant fulfillment is NOT live yet: place_booking on a real merchant returns the structured rejection 'fulfillment_not_live'. The full booking loop is testable end-to-end against sandbox merchants (deterministic …
Transaction-verified feedback — submit_feedback: report how a confirmed reservation actually went — accepted only against a confirmed booking_id, once per booking, within 14 days. Served raw to all agents via get_merchant; never editorialized, never scored.

kind A2A Agent Card

name A2A Agent Card

repoUrl Official MCP Registry

summary A2A Agent Card

version A2A Agent Card

description A2A Agent Card

homepageUrl A2A Agent Card

publisherUrl A2A Agent Card

publisherName A2A Agent Card

Derived by Wellknown

Capabilities

Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.

commerce.ecommerceE-commerce Operations100%commerce.travelTravel & Bookingdeclared code.executionCode Executiondeclared dev.terminalTerminal & Shell53%

Provenance

Where this record came from

Every source is kept verbatim. Field changes are logged as events.

A2A Agent Cardhttps://mercantry.org/.well-known/agent-card.json

first seen 2 mo ago · fetched 4 d agoopen ↗

Official MCP Registryorg.mercantry/registry

first seen 2 mo ago · fetched 3 d agoopen ↗

Field history (12 recent events)

2 mo ago · declared · protocols → ["a2a","mcp"]
2 mo ago · declared · name → "Mercantry"
2 mo ago · declared · summary → "Mercantry is an open commerce registry for AI agents — structured merchant data, honest signals, and real-world booking
2 mo ago · declared · description → "Mercantry is an open commerce registry for AI agents — structured merchant data, honest signals, and real-world booking
2 mo ago · declared · publisherName → "Mercantry"
2 mo ago · declared · publisherUrl → "https://mercantry.org"
2 mo ago · declared · homepageUrl → "https://github.com/mercantry/registry"
2 mo ago · declared · version → "1.0.0"
2 mo ago · declared · kind → "agent"
2 mo ago · declared · description → "Agent-native registry: 168k+ real restaurants in LA, Hong Kong & Tokyo. Unranked, honest signals."
2 mo ago · declared · publisherName → "org.mercantry"
2 mo ago · declared · homepageUrl → "https://mercantry.org"