Sample Shop MCP server
Sample shop MCP server: paginated search, idempotent orders, guarded cancellation. Four languages.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"sample-shop-mcp": {
"command": "npx",
"args": [
"@apitoagents/sample-shop-mcp"
]
}
}
}Paquetes ejecutables
1.0.1stdioPuntos de conexión remotos
https://demo.apitoagents.com/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (4)
🟢search_products(query, category, limit, cursor)
Search the shop catalogue by phrase and optional category. Returns one page of up to `limit` products and a `nextCursor`; when nextCursor is not null, more results exist and you must say so rather than claiming the list is complete. Use get_product for full details of one item. This tool does not place orders.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Words to match against product names and descriptions.",
"type": "string",
"maxLength": 100
},
"category": {
"description": "Restrict results to one category.",
"type": "string",
"enum": [
"lighting",
"furniture",
"kitchen"
]
},
"limit": {
"default": 5,
"description": "Page size.",
"type": "integer",
"minimum": 1,
"maximum": 20
},
"cursor": {
"description": "Opaque token from a previous page's nextCursor. Never invent one.",
"type": "string"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢get_product(productId)
Return the full details of one product by its id (for example p-1001). Use search_products first if you only know a name.
Esquema de entrada
{
"type": "object",
"properties": {
"productId": {
"type": "string",
"description": "The product id from search_products."
}
},
"required": [
"productId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡create_order(productId, quantity, idempotencyKey)
Place an order for one product. Generate one random idempotencyKey per user request and reuse the same key if you retry after an error or timeout; the shop returns the original order instead of creating a duplicate. Confirm product and quantity with the user before calling. Returns the order with its id, status and total.
Esquema de entrada
{
"type": "object",
"properties": {
"productId": {
"type": "string",
"description": "Product id from search_products or get_product."
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Units to order, 1 to 10."
},
"idempotencyKey": {
"type": "string",
"minLength": 8,
"maxLength": 128,
"description": "A unique key you generate for this order attempt and reuse on retry."
}
},
"required": [
"productId",
"quantity",
"idempotencyKey"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴cancel_order(orderId, confirm)
Cancel an order that has not shipped. This cannot be undone. Call it first with confirm=false to get the order details, show them to the user, and only after the user explicitly agrees call again with confirm=true.
Esquema de entrada
{
"type": "object",
"properties": {
"orderId": {
"type": "string",
"description": "The order id, for example o-5001."
},
"confirm": {
"default": false,
"description": "Set true only after the user has explicitly confirmed the cancellation.",
"type": "boolean"
}
},
"required": [
"orderId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Comunidad
Evidencia