1stDibs is a marketplace for vintage and contemporary luxury goods, and it exposes a public MCP server over its listings: a category taxonomy, item search and browse, and per-item detail. Connecting it to clariBI lets you study what is listed, how it is priced, and how the marketplace is organized, with no account or key.
Why connect 1stDibs
The 1stDibs catalogue is huge and filter-driven, so questions about price ranges, category mix, or seller geography mean a lot of manual clicking through facets.
With 1stDibs connected, you can ask "What is the price range for mid-century lounge chairs listed right now?", "Which jewelry categories have the most listings?", or "Show the filters available under the art category" and the AI engine reads the public marketplace live.
How the connection works
clariBI talks to 1stDibs through its hosted MCP server at https://www.1stdibs.com/soa/mcp/. Authentication uses no authentication, because this is a public read-only endpoint. No credentials are sent or stored.
sequenceDiagram
actor U as You
participant C as clariBI
participant V as 1stDibs
U->>C: Click Authorize with 1stDibs
C->>V: Open OAuth authorization
V-->>U: Grant read access?
U->>V: Approve
V-->>C: Authorization code
C->>V: Exchange code for tokens
V-->>C: Access + refresh tokens
C->>C: Encrypt and store credentials
C-->>U: Connection ready
Available tools
clariBI exposes the read-only 1stDibs tools that the vendor's MCP server publishes at connection time. Write operations (create, update, delete, send, refund) are filtered out by a name-pattern blocklist before any tool reaches the analysis engine, so connecting 1stDibs cannot modify data on the vendor side.
The exact tool inventory depends on the 1stDibs features your account has access to. After connecting, try a few natural-language questions to see what 1stDibs data clariBI can pull.
Data flow during analysis
When you ask a question that maps to 1stDibs, the AI engine routes to the right tool, reads the result, and pairs the answer with a chart you can pin to a dashboard.
sequenceDiagram
actor U as You
participant C as clariBI
participant AI as AI engine
participant V as 1stDibs
U->>C: Ask a question about public marketplace listing data
C->>AI: Plan the analysis
AI->>V: Call the right tool
V-->>AI: Tool result
AI->>AI: Summarize and chart
C-->>U: Answer plus visual
Setting up the connection
- Open Data Sources in the clariBI sidebar.
- Click Add data source.
- Open the MCP Servers tab.
- Click the 1stDibs card.
- Click Authorize with 1stDibs.
- Sign in to 1stDibs in the popup window and grant the requested read scopes.
- Back in clariBI, give your data source a name.
- Click Finish.
Permissions and data access
This is a public, read-only MCP endpoint. No credentials are sent or stored: clariBI sends no login, token, or key, and 1stDibs asks for none. The connector reads public marketplace data only (taxonomy, item search and browse, and item detail); it sees nothing about a buyer or seller account and cannot list, bid on, or buy anything. Disconnect anytime from Settings → Integrations in clariBI.
Troubleshooting
| Error | Cause | Fix |
|---|---|---|
| "Browse returns nothing for a category" | The category string does not match the 1stDibs taxonomy, or the filter query string is malformed. | Read the taxonomy first to get valid category names and filter facets, then pass them exactly. |
| "Filters seem to be ignored" | Filters use a query-string format like category=furniture&location=usa-north-america and must come from the taxonomy facets. | Read the taxonomy to discover the available facets, then build the filter string from those names. |