Search the public Nafafy catalog and create firm checkout quotes.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Create a firm 5-minute checkout quote for a set of items. Returns quote_id (pass it to /api/ucp/authorize with a signed agent mandate to complete checkout).
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http storefront https://nafafy.com/api/mcp/storefront
Create a firm 5-minute checkout quote for a set of items. Returns quote_id (pass it to /api/ucp/authorize with a signed agent mandate to complete checkout).
| Argument | Type | Description |
|---|---|---|
| items* | array |
{
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"qty"
],
"properties": {
"qty": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"product_id": {
"type": "string"
}
}
}
}
},
"additionalProperties": false
}Fetch one product by its Nafafy product id.
| Argument | Type | Description |
|---|---|---|
| id* | string | Nafafy product id (uuid). |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Nafafy product id (uuid)."
}
},
"additionalProperties": false
}Search the public Nafafy catalog. Returns in-stock products with price, availability, URL, and merchant.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default 20). |
| query | string | Free-text search over product titles. |
| category | string | Optional category breadcrumb prefix. |
| max_price_cents | integer | Optional max unit price in minor units. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)."
},
"query": {
"type": "string",
"description": "Free-text search over product titles."
},
"category": {
"type": "string",
"description": "Optional category breadcrumb prefix."
},
"max_price_cents": {
"type": "integer",
"description": "Optional max unit price in minor units."
}
},
"additionalProperties": false
}Semantic + keyword search over Nafafy's commerce knowledge: a merchant's product details, policies and FAQs (when `host` is given) plus platform buying guides. Use this to answer questions like sizing, materials, returns, or shipping before recommending a product.
| Argument | Type | Description |
|---|---|---|
| k | integer | Max passages (default 6). |
| host | string | Optional merchant slug to include that store's docs. |
| query* | string | The shopper's question. |
{
"type": "object",
"required": [
"query"
],
"properties": {
"k": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "Max passages (default 6)."
},
"host": {
"type": "string",
"description": "Optional merchant slug to include that store's docs."
},
"query": {
"type": "string",
"description": "The shopper's question."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 3, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.