1stdibs
MCP server for browsing and searching items on 1stDibs marketplace.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"1stdibs": {
"url": "https://www.1stdibs.com/soa/mcp/"
}
}
}Remote endpoints
https://www.1stdibs.com/soa/mcp/streamable-httpWhat it can do
Tool inventory
Tools (4)
🟢read_taxonomy(category)
Discover how items on 1stDibs are categorized. We have a taxonomy with furniture, art, jewelry, and fashion categories at the top level. This will return a list of next level categories as well as facets with their appropriate filters. You need to specify a category.
Input Schema
{
"type": "object",
"properties": {
"category": {
"description": "Category to read taxonomy for",
"type": "string",
"minLength": 1
}
},
"required": [
"category"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢browse_items(category, page, filters)
Browse 1stDibs with the given category and optional page number and filters. Filters are in the format of a query string like category=furniture&location=usa-north-america. Read the taxonomy to discover facets and filters.
Input Schema
{
"type": "object",
"properties": {
"category": {
"description": "Category to browse",
"type": "string",
"minLength": 1
},
"page": {
"description": "Page number to browse",
"type": "number"
},
"filters": {
"description": "Filters to apply to the browse",
"type": "string"
}
},
"required": [
"category"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_items(query, page, filters)
Search 1stDibs with the given query and optional page number and filters. Filters are in the format of a query string like category=furniture&location=usa-north-america. Read the taxonomy to discover categories, facets and filters.
Input Schema
{
"type": "object",
"properties": {
"query": {
"description": "Search Query",
"type": "string",
"minLength": 1
},
"page": {
"description": "Jump to a specific page number",
"type": "number"
},
"filters": {
"description": "Filters to apply to the search",
"type": "string"
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢item_details(itemId)
Get details on a specific item on 1stDibs. You'll need to input the item ID. You can search for an item or browse for an item to find an item ID.
Input Schema
{
"type": "object",
"properties": {
"itemId": {
"description": "Item ID to get details for",
"type": "string",
"minLength": 1
}
},
"required": [
"itemId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Recommended Prompts
search_itemssearch_itemsread_taxonomysearch_itemsread_taxonomyread_taxonomyCommunity
Evidence