What is the 3Dsellers MCP server?
MCP (Model Context Protocol) is an open standard that lets AI assistants connect to external tools and data sources. The 3Dsellers MCP server gives AI agents access to your 3Dsellers account — so you can ask things like "show me my unshipped eBay orders" or "update the price on this product" and get real results from your live data.
What can the AI do with 3Dsellers?
Once connected, an AI agent has access to tools across 6 areas:
Products (read + write)
List your products — filter by SKU, segment, paginate, and include variants
Create a new product — with variants, pricing, inventory, images, dimensions, and identifiers (UPC, ASIN, EAN, and more)
Fully replace a product's data
Partially update a product — change title, price, inventory, or images without affecting other fields
Listings (read only)
Get product listings — the per-channel, per-seller view of a product (as opposed to the channel-agnostic catalog product). Filter by channel (eBay, Amazon, Etsy), seller, SKU, linked product, status (Active, Library, Ended), or segment. Optionally include variations. Follow a listing's product ID back to the catalog product.
Product categories (read + write)
List your categories — optionally filter by name
Create a new category
Orders (read only)
List orders for a seller — filter by status, channel (eBay, Amazon, Shopify...), SKU, or marketplace order ID
Sellers (read only)
List all connected marketplace accounts — filter by channel
Get details for a specific seller account
Segments (read only)
Get your saved segments — saved filter sets, optionally filtered by module type (products, listings, or orders). Use a segment's ID as a filter on product or listing queries to scope results to that saved segment.
CSV imports (read only)
List import jobs and their status (pending, processing, done, error)
Get the details of a specific import, including row-level errors
Search for validation errors by SKU or item ID
Step 1: Get your MCP token
1. Go to Settings > Integrations
Log in to your 3Dsellers account. In the left sidebar, click in your account's username, then open Integrations and choose All Integrations.
2. Find the MCP 3Dsellers tile
Scroll down until you see the tile labelled MCP 3Dsellers (marked as NEW). Click it to open the connection dialog.
3. Copy your token
The dialog shows your personal bearer token. Click Copy next to the token field and keep it somewhere safe — you will need it in the next step.
Keep your token private. Anyone with it can read and write to your 3Dsellers data. Do not commit it to code or share it in public channels.
Step 2: Connect to your AI tool
The dialog gives you a ready-to-run command and a JSON config block. Pick the one that matches your setup.
Option A - Claude Code (CLI)
Run this command in your terminal. Paste in your actual token where shown:
claude mcp add --transport http 3dsellers https://api.3dsellers.com/mcp --header "Authorization: Bearer YOUR_TOKEN_HERE"
That registers the server globally with Claude Code. Next time you open a session, the tools are available automatically.
New to Claude Code? See the official setup guide: docs.anthropic.com/en/docs/claude-code/mcp
Option B - Claude Desktop or Cursor (JSON config)
Open your MCP settings file and add this block:
{
"mcpServers": {
"3dsellers": {
"type": "http",
"url": "https://api.3dsellers.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
Save the file, restart your AI tool, and the 3Dsellers server will appear in the connected tools list.
Claude Desktop — config file location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Official guide: modelcontextprotocol.io/quickstart/user
Cursor — config file location:
Global (all projects):
~/.cursor/mcp.jsonProject only:
.cursor/mcp.jsonin your project root
Or go to Cursor Settings > Tools & MCP and add your server there.
Step 3: Ask the AI what it can do
Once connected, the fastest way to get started is to ask the AI to describe what tools are available. Try one of these opening prompts:
What 3Dsellers tools do you have access to?
What can you help me with in 3Dsellers?
List the available 3Dsellers MCP tools
The AI will read the tool manifest and explain each capability in plain English. From there you can start asking real questions about your store.
Example things to try
Show me my unshipped eBay orders from the last 7 days
Which of my listings are out of stock?
What orders came in today on Shopify?
Find orders with the status "awaiting payment"
Show me all active eBay listings for seller 123
Get products in my "Summer Sale" segment
Create a new product with SKU ABC-123, price $19.99, quantity 50
Update the title and description on product ID 456
Show me any CSV import jobs that failed this week
Frequently asked questions
Can the AI make changes to my store?
Partly. The AI can create and update products and categories. Orders, listings, sellers, segments, and CSV imports are read-only — the AI can query and display that data but cannot modify it.
Which AI tools are compatible?
Any tool that supports the MCP standard over HTTP. This includes Claude Code, Claude Desktop, Cursor, and other MCP-compatible agents. The JSON config format is the same across all of them.
Is my data secure?
Yes. Your token authenticates requests directly to the 3Dsellers API over HTTPS. The AI tool only sees the data returned by the specific tool it calls. Regenerate your token any time from the same settings page.
Where do I find the full API documentation?
Full endpoint documentation is available at api.3dsellers.com/docs.
Something is not working. Who do I contact?
Use the "Need more MCP tools?" button in the integration dialog to send feedback directly to the 3Dsellers team, or reach out through your normal support channel.
Need more MCP tools?
The 3Dsellers MCP server is growing. If there is a resource or action you wish the AI could access — such as inventory updates, shipping management, or feedback — you can request it directly from inside the app.
Go to Settings > Integrations > MCP 3Dsellers and click "Need more MCP tools?". Your request goes straight to the 3Dsellers team and helps prioritize what gets built next.