1stdibs
MCP server for browsing and searching items on 1stDibs marketplace.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (1)
- LOWen browse_items
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": {
"1stdibs": {
"url": "https://www.1stdibs.com/soa/mcp/"
}
}
}Puntos de conexión remotos
https://www.1stdibs.com/soa/mcp/streamable-httpQué puede hacer
Inventario de herramientas
Herramientas (5)
🟢read_taxonomy(category)
Get how items in a 1stDibs category are organized. The top-level categories are furniture, art, jewelry, and fashion. Returns the next-level categories and the facets for the category, each with its filter values and item counts. Use it to find valid filters for search_items and browse_items.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"type": "string",
"minLength": 1,
"description": "Category path, such as \"furniture\", \"art\", \"jewelry\", or \"furniture/seating\""
}
},
"required": [
"category"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"facets": {
"type": "array",
"items": {
"type": "string"
}
},
"filters": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "string"
},
"count": {
"type": "number"
}
},
"required": [
"value",
"count"
],
"additionalProperties": false
}
}
},
"required": [
"key",
"values"
],
"additionalProperties": false
}
}
},
"required": [
"facets",
"filters"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢browse_items(category, page, filters)
List 1stDibs items in a category, optionally narrowed by filters. Use it when the user wants items of a kind rather than a keyword match. Returns 20 items per page with price, availability, photos, and product page links; descriptions are shortened. Pass nextPage as page for more. Filters are a query string like category=furniture&location=usa-north-america; get them from read_taxonomy.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"type": "string",
"minLength": 1,
"description": "Category path, such as \"furniture\" or \"furniture/seating\""
},
"page": {
"description": "Page number, starting at 1. Use nextPage from the previous result.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"filters": {
"description": "Filters from read_taxonomy as a query string, such as \"category=furniture&location=usa-north-america\"",
"type": "string"
}
},
"required": [
"category"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"category": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string",
"const": "USD"
},
"available": {
"type": "boolean"
},
"primaryImage": {
"type": "string"
},
"additionalImages": {
"type": "array",
"items": {
"type": "string"
}
},
"productDetailUrl": {
"type": "string"
},
"checkoutUrl": {
"type": "string"
}
},
"required": [
"itemId",
"title",
"description",
"category",
"price",
"currency",
"available",
"primaryImage",
"additionalImages",
"productDetailUrl",
"checkoutUrl"
],
"additionalProperties": false
}
},
"filters": {
"type": "string"
},
"page": {
"type": "number"
},
"nextPage": {
"type": [
"number",
"null"
]
}
},
"required": [
"items",
"filters",
"page",
"nextPage"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢search_items(query, page, filters)
Search 1stDibs items by keyword, optionally narrowed by filters. Use it when the user describes what they want in words. Returns 20 items per page with price, availability, photos, and product page links; descriptions are shortened. Pass nextPage as page for more. Filters are a query string like category=furniture&location=usa-north-america; get them from read_taxonomy.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Search terms, such as \"mid-century walnut credenza\""
},
"page": {
"description": "Page number, starting at 1. Use nextPage from the previous result.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"filters": {
"description": "Filters from read_taxonomy as a query string, such as \"category=furniture&location=usa-north-america\"",
"type": "string"
}
},
"required": [
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"category": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string",
"const": "USD"
},
"available": {
"type": "boolean"
},
"primaryImage": {
"type": "string"
},
"additionalImages": {
"type": "array",
"items": {
"type": "string"
}
},
"productDetailUrl": {
"type": "string"
},
"checkoutUrl": {
"type": "string"
}
},
"required": [
"itemId",
"title",
"description",
"category",
"price",
"currency",
"available",
"primaryImage",
"additionalImages",
"productDetailUrl",
"checkoutUrl"
],
"additionalProperties": false
}
},
"filters": {
"type": "string"
},
"page": {
"type": "number"
},
"nextPage": {
"type": [
"number",
"null"
]
},
"query": {
"type": "string"
}
},
"required": [
"items",
"filters",
"page",
"nextPage",
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢item_details(itemId)
Get the full details of one 1stDibs item: description, price, availability, photos, product page and checkout links, specifications, and up to 6 you may also like items. Use it when the user asks about a specific item. Takes an item ID from search_items or browse_items.
Esquema de entrada
{
"type": "object",
"properties": {
"itemId": {
"type": "string",
"minLength": 1,
"description": "Item ID returned by search_items or browse_items"
}
},
"required": [
"itemId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"itemId": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"category": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string",
"const": "USD"
},
"available": {
"type": "boolean"
},
"primaryImage": {
"type": "string"
},
"additionalImages": {
"type": "array",
"items": {
"type": "string"
}
},
"productDetailUrl": {
"type": "string"
},
"checkoutUrl": {
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
},
"similarItems": {
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"category": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string",
"const": "USD"
},
"available": {
"type": "boolean"
},
"primaryImage": {
"type": "string"
},
"additionalImages": {
"type": "array",
"items": {
"type": "string"
}
},
"productDetailUrl": {
"type": "string"
},
"checkoutUrl": {
"type": "string"
}
},
"required": [
"itemId",
"title",
"description",
"category",
"price",
"currency",
"available",
"primaryImage",
"additionalImages",
"productDetailUrl",
"checkoutUrl"
],
"additionalProperties": false
}
}
},
"required": [
"itemId",
"title",
"description",
"category",
"price",
"currency",
"available",
"primaryImage",
"additionalImages",
"productDetailUrl",
"checkoutUrl",
"details",
"similarItems"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢show_items(itemIds)
Show up to 8 1stDibs items to the user as visual cards with a photo, price, and a link to each product page. Use item IDs returned by search_items or browse_items, best match first.
Esquema de entrada
{
"type": "object",
"properties": {
"itemIds": {
"minItems": 1,
"maxItems": 8,
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"description": "1-8 item IDs from search_items or browse_items, in display order"
}
},
"required": [
"itemIds"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Esquema de salida
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"itemId": {
"type": "string"
},
"title": {
"type": "string"
},
"price": {
"type": "number"
},
"currency": {
"type": "string",
"const": "USD"
},
"available": {
"type": "boolean"
},
"category": {
"type": "string"
},
"facts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"values"
],
"additionalProperties": false
}
}
},
"required": [
"itemId",
"title",
"price",
"currency",
"available",
"category",
"facts"
],
"additionalProperties": false
}
},
"notFound": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"items",
"notFound"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Prompts recomendados
search_itemssearch_itemsread_taxonomysearch_itemsread_taxonomyread_taxonomyComunidad
Evidencia