1stdibs

MCP server for browsing and searching items on 1stDibs marketplace.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
100%
Calidad de los nombres
92%
Riesgo de envenenamiento
100%
Coincidencia de permisos
90%
Cumplimiento del protocolo
100%

Hallazgos (1)

  • LOWTool 'browse_items' suggests web access but openWorldHint=falseen browse_items

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~2,008Tokens (definiciones de herramientas)
~3.7 KBTamaño de respuesta típico
Impacto moderado en la atención (1.57% del contexto de 128k)

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-http

Qué puede hacer

Inventario de herramientas

Herramientas (5)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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

find_specific
Find [specific item] using 1stdibs
Herramientas esperadas: search_items
research_workflow
Search for [topic], then get detailed information about the top results using 1stdibs
Herramientas esperadas: search_itemsread_taxonomy
search_research
Search for information about [topic] using 1stdibs
Herramientas esperadas: search_items
retrieve_data
Get details about [item] from 1stdibs
Herramientas esperadas: read_taxonomy
fetch_info
Fetch [information type] using 1stdibs
Herramientas esperadas: read_taxonomy

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada5 herramientas
verificadoversión no registrada4 herramientas
verificadoversión no registrada4 herramientas
verificadoversión no registrada4 herramientas
verificadoversión no registrada4 herramientas
verificadoversión no registrada4 herramientas
verificadoversión no registrada4 herramientas