# Mercantry Registry

Gives an agent filtered lookup across a restaurant registry for Los Angeles, Hong Kong and Tokyo, plus a sandbox booking loop to exercise end to end.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: mercantry
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/mercantry/registry
- Updated: 2026-07-26
- HTML: https://affpapa.org/en/nevibecode/mcp/mercantry-registry

## What it does

The server returns structured merchant records drawn from openly licensed sources: 168,000+ restaurants in Los Angeles, Hong Kong and Tokyo, with provenance and timestamps on each field. Search is filter-based with a deterministic documented order, and the schema carries no score fields at all. `get_registry_meta` reports how stale the registry is.

Bookings stay honest about their state. Against a real merchant, `place_booking` answers with the rejection `fulfillment_not_live` because human phone fulfillment has not launched. To walk the whole flow, use records marked `sandbox: true`: fictional places with fixed outcomes whose phone numbers must not be dialled. Modification and cancellation tools exist, and a merchant opt-out removes it from discovery the same day.

Keys are optional. Reads are free and need no auth; `POST /v1/keys` only exists for abuse control, and no-shows are counted per developer key. To run your own copy, `npm install` then `npm run dev` serves MCP at `http://localhost:4100/mcp` and seeds a sandbox corpus on first boot.

## Requirements
- Remote server: `https://mercantry.org/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http registry https://mercantry.org/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mercantry-registry --url https://mercantry.org/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mercantry-registry": {
            "url": "https://mercantry.org/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mercantry-registry": {
            "type": "http",
            "url": "https://mercantry.org/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mercantry-registry https://mercantry.org/mcp
```

## When to use it
- find venues across three cities with filters instead of manual map browsing
- exercise the booking flow before live fulfillment exists
- inspect per-field provenance for a single merchant
- judge how fresh the registry is before relying on it
- pull the whole corpus as NDJSON for caching or embeddings

## Example prompts
- Look up Tokyo restaurants in the registry with filters and show the result order
- Book a table at a merchant with `sandbox: true` and track the status through
- Check `get_registry_meta` and tell me how stale the data is

## Similar
- [metagraphed — Bittensor subnet operational registry](https://affpapa.org/en/nevibecode/mcp/metagraphed-bittensor-subnet-operational-registry.md) — MCP server · ★ 11
- [Cellarion Wine Registry](https://affpapa.org/en/nevibecode/mcp/cellarion-wine-registry.md) — MCP server · ★ 28
- [nordic-registry-mcp-server](https://affpapa.org/en/nevibecode/mcp/nordic-registry-mcp-server.md) — MCP server · ★ 14
- [offer-claims-registry](https://affpapa.org/en/nevibecode/skills/offer-claims-registry.md) — skill · 1000 installs
- [channel-registry](https://affpapa.org/en/nevibecode/skills/channel-registry.md) — skill · 1000 installs
- [mcp-registry-navigator](https://affpapa.org/en/nevibecode/agents/mcp-registry-navigator.md) — subagent · 628 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md