get_merchant
Get the full profile for a specific merchant by ID or slug. Returns all details including description, pricing, delivery, reputation, contact info, and machine-readable manifest URLs (llms.txt, MPP, x402).
LABSCO SUMMARY
Category counts alongside the category names is the small thing that stops an agent searching an empty bucket.
A bare category list invites a model to pick a plausible-sounding one and report that nothing matched, which reads as an absence of businesses rather than an absence of that category. Returning the count with the name makes the choice informed. Accepting either an id or a slug on the detail call is the other practical touch — the reference someone pastes is almost always a slug. Three tools, read-only, and the value depends entirely on how complete the registry behind it is.
What it is
A three-tool client over the MOTE merchant registry: search businesses with filters, open one in full, and list the categories with how many merchants sit in each.
What you get
- search_merchants filters by text query and category, so a search narrows rather than returning everything that matched a word.
- get_merchant returns the complete profile by id or by slug — a slug being what you have when the reference came from a URL.
- list_categories returns each category with its merchant count, which is what tells you whether a category is worth searching before you search it.
Requirements
Nothing to supply.
Setup effort
One command — npx -y mote-registry
USE CASES
01
Finding businesses of a particular kind
Check which categories actually have merchants in them, then search within the one that does.
02
Looking up a business someone linked you to
Open the full profile from the slug in the URL, without needing an internal id.
3 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
list_categories
List all business categories in the MOTE registry with the number of merchants in each. Use this to discover what types of businesses are available before searching.
search_merchants
Search the MOTE merchant registry for businesses. Filter by text query, category, and location. Returns matching merchants with name, category, description, location, pricing, and contact info.
BEFORE YOU INSTALL
What to know first
Tools you get
3 tools when we connected.
Requires
npx on PATH
Where it runs
All 3 documented setups run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 3 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y mote-registryMCP Clients
Claude Desktop — npx
CLAUDE DESKTOP — NPX · JSON
{
"mcpServers": {
"mote-registry": {
"command": "npx",
"args": [
"tsx",
"<YOUR_PATH_TO_MOTE>/mcp/src/index.ts"
]
}
}
}Claude Desktop — local build
CLAUDE DESKTOP — LOCAL BUILD · JSON
{
"mcpServers": {
"mote-registry": {
"command": "node",
"args": [
"<YOUR_PATH_TO_MOTE>/mcp/dist/index.js"
]
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add mote-registry -- npx tsx <YOUR_PATH_TO_MOTE>/mcp/src/index.ts
