1stdibs

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

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
100%
Naming quality
90%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~520Tokens (tool definitions)
~774 BTypical response size
Minimal attention impact (0.41% of 128k context)

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

What it can do

Tool inventory

Tools (4)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

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

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded4 tools
verifiedversion not recorded4 tools