1stdibs
MCP server for browsing and searching items on 1stDibs marketplace.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWbrowse_items에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"1stdibs": {
"url": "https://www.1stdibs.com/soa/mcp/"
}
}
}원격 엔드포인트
https://www.1stdibs.com/soa/mcp/streamable-http할 수 있는 일
도구 목록
도구 (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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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.
입력 스키마
{
"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"
}출력 스키마
{
"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
}권장 프롬프트
search_itemssearch_itemsread_taxonomysearch_itemsread_taxonomyread_taxonomy커뮤니티
증거