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": {
      "type": "string",
      "minLength": 1,
      "description": "Category to read taxonomy for"
    }
  },
  "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": {
      "type": "string",
      "minLength": 1,
      "description": "Category to browse"
    },
    "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": {
      "type": "string",
      "minLength": 1,
      "description": "Search Query"
    },
    "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": {
      "type": "string",
      "minLength": 1,
      "description": "Item ID to get details for"
    }
  },
  "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
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools