Summary
DSers runs a hosted MCP server that connects AI clients to their dropshipping platform via OAuth 2.1. You get tools to import products from AliExpress, Alibaba, and other suppliers, then edit variants, apply pricing rules, and push directly to Shopify or Wix stores. It handles supplier replacement with SKU matching and lets you preview drafts before publishing. The server is remote only over streamable HTTP, so no local setup. Verified working with Claude Desktop, Cursor, and ChatGPT Developer Mode. Reach for this if you're already using DSers and want to script product imports or automate store publishing workflows without clicking through their web interface.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
11 tools
dsers_store_discoverRetrieve available stores and supported rules for the connected DSers account. Call this first — the response contains store IDs and configuration needed by all subsequent operations. Returns: stores (each with id, name, platform, ship[]), rules (pricing modes, content, images...1 params
Retrieve available stores and supported rules for the connected DSers account. Call this first — the response contains store IDs and configuration needed by all subsequent operations. Returns: stores (each with id, name, platform, ship[]), rules (pricing modes, content, images...
Parameters* required
target_storestringStore ID or name to filter capabilities for a specific store. Omit to see all linked stores. Use the id or name from this response in later calls.
dsers_rules_validateCheck and normalize a rules object against the provider's capabilities before importing. Use this to verify pricing, content, and image rules are valid and see exactly which ones will be applied. Returns: effective_rules_snapshot (what will actually be applied), warnings (adju...2 params
Check and normalize a rules object against the provider's capabilities before importing. Use this to verify pricing, content, and image rules are valid and see exactly which ones will be applied. Returns: effective_rules_snapshot (what will actually be applied), warnings (adju...
Parameters* required
rulesstringRules as a JSON string. Top-level keys: pricing, content, images, variant_overrides, option_edits. Pricing modes: fixed_price (exact dollar amount for all), multiplier (cost × ratio), fixed_markup (cost + dollars). Example: {"pricing": {"mode": "fixed_price", "fixed_price": 9.99}, "content": {"title_prefix": "[US] "}, "images": {"keep_first_n": 5}}
target_storestringStore ID or display name from dsers_store_discover. Some rule capabilities vary by store.
dsers_product_importImport product(s) from supplier URL(s) into the DSers import list and return a preview. Supports AliExpress, Alibaba, and Accio.com URLs. Provide source_url (single) or source_urls_json (batch). Optionally apply rules at import time via rules_json or flat params. The response...17 params
Import product(s) from supplier URL(s) into the DSers import list and return a preview. Supports AliExpress, Alibaba, and Accio.com URLs. Provide source_url (single) or source_urls_json (batch). Optionally apply rules at import time via rules_json or flat params. The response...
Parameters* required
countrystringTarget country code for shipping and pricing lookup. Examples: US, GB, DE, FR, AU.default: US
rules_jsonstringRules as JSON string. Keys: pricing, content, images, variant_overrides, option_edits. PRICING: {mode:'fixed_price',fixed_price:9.99} | {mode:'multiplier',multiplier:2} | {mode:'fixed_markup',fixed_markup:5}. VARIANT_OVERRIDES: [{match:'Red',sell_price:9.99,compare_at_price:19.99}]. CONTENT: {title_override, title_prefix, title_suffix, description_override_html, description_append_html, tags_add:['tag']}. title_prefix / title_suffix / description_append_html are SLOT-based — each call's value is the desired end state for that slot, and strips any prior value we placed. Pass '' to clear a slot. Absent key leaves the slot unchanged. IMAGES: {drop_indexes, reorder, add_urls, keep_first_n}. OPTION_EDITS (always full replacement): [{action:'rename_option',option_name:'Color',new_name:'Style'},{action:'rename_value',option_name:'Color',value_name:'Red',new_name:'Crimson'},{action:'remove_value',option_name:'Color',value_name:'Gray'},{action:'remove_option',option_name:'Size'}]. Only include families you want to change. Others are preserved automatically.
source_urlstringSingle supplier product URL. Supports AliExpress (aliexpress.com/item/xxx.html), Alibaba (alibaba.com/product-detail/xxx.html), and Accio.com product links (accio.com/c/...?productId=xxx&ds=aliexpress.com).
source_hintstringSupplier platform hint. Valid values: auto, aliexpress, alibaba, accio. Default: auto (detected from URL).default: auto
batch_detailstringBatch response detail level. summary (default): import_item_id + title + sell_price + cost + variants_count + stock per product (~100 tokens each). full: complete preview per product (can be very large for 10+ products). Single imports always return full preview.one of
summary · fullpricing_modestringFlat param: pricing mode. Use instead of rules_json for simple pricing.one of
multiplier · fixed_markup · fixed_pricetarget_storestringStore ID or display name from dsers_store_discover. Required when the account has multiple stores.
title_prefixstringFlat param: REPLACE the title-prefix slot. Each call sets the desired prefix outright — passing a new value strips any prior prefix we put there. Empty string '' clears the slot.
title_suffixstringFlat param: REPLACE the title-suffix slot. Each call sets the desired suffix outright. Empty string '' clears the slot.
title_overridestringFlat param: replace entire product title. Clears any title_prefix/suffix slot applied earlier.
visibility_modestringProduct visibility after push. backend_only (default): saved as draft, not visible to shoppers — SAFE, no financial risk. sell_immediately: published and LIVE on the storefront — RISK: verify pricing and inventory first.
source_urls_jsonstringBatch import: JSON array of URL strings or objects with {url, rules?, source_hint?, country?, target_store?, visibility_mode?}. Example: ["https://aliexpress.com/item/123.html", {"url": "https://aliexpress.com/item/456.html", "rules": {"pricing": {"mode": "multiplier", "multiplier": 3}}}]
pricing_multipliernumberFlat param: multiplier value when pricing_mode='multiplier'.
pricing_fixed_pricenumberFlat param: exact price in dollars when pricing_mode='fixed_price'.
pricing_fixed_markupnumberFlat param: markup in dollars when pricing_mode='fixed_markup'.
description_append_htmlstringFlat param: REPLACE the description-append slot. Each call sets the appended HTML outright — the prior append (if any) is stripped first. Empty string '' clears the slot.
description_override_htmlstringFlat param: replace full description (HTML).
dsers_product_previewReload the preview for an already-imported product (by import_item_id). Two modes: compact (default) returns [name, sell, qty] for ALL variants — lightweight. full returns [name, sell, compare_at, cost, qty, supplier_qty] for 3 variants by default. Always includes price_summar...6 params
Reload the preview for an already-imported product (by import_item_id). Two modes: compact (default) returns [name, sell, qty] for ALL variants — lightweight. full returns [name, sell, compare_at, cost, qty, supplier_qty] for 3 variants by default. Always includes price_summar...
Parameters* required
variant_limitnumberMax variants in skus table. Compact default: all. Full default: 3. Hard cap: 200.
import_item_idstringImport-item ID returned by dsers_product_import (DSers's persistent handle).
include_imagesvalueInclude per-variant image_url and per-option-value imgUrl in the response. Useful for visual SKU matching when comparing suppliers. Off by default to keep responses compact.
variant_detailstringcompact (default): columns [name, sell, qty], shows ALL variants. full: columns [name, sell, compare_at, cost, qty, supplier_qty], shows 3 by default.one of
compact · fullvariant_offsetnumberStart index for variant/SKU listing (0-based). Default: 0.
show_all_optionsvalueShow all option values instead of truncating to 10. Use before applying option_edits.
dsers_product_update_rulesUpdate pricing, content, images, or variant rules on an already-imported product. Rules are merged incrementally: pricing / images / variant_overrides replace by family. CONTENT slots (title_prefix, title_suffix, description_append_html) behave like named slots — each call REP...13 params
Update pricing, content, images, or variant rules on an already-imported product. Rules are merged incrementally: pricing / images / variant_overrides replace by family. CONTENT slots (title_prefix, title_suffix, description_append_html) behave like named slots — each call REP...
Parameters* required
rules_jsonstringRules as JSON string. Keys: pricing, content, images, variant_overrides, option_edits. PRICING: {mode:'fixed_price',fixed_price:9.99} | {mode:'multiplier',multiplier:2} | {mode:'fixed_markup',fixed_markup:5}. VARIANT_OVERRIDES: [{match:'Red',sell_price:9.99,compare_at_price:19.99}]. CONTENT: {title_override, title_prefix, title_suffix, description_override_html, description_append_html, tags_add:['tag']}. title_prefix / title_suffix / description_append_html are SLOT-based — each call's value is the desired end state for that slot, and strips any prior value we placed. Pass '' to clear a slot. Absent key leaves the slot unchanged. IMAGES: {drop_indexes, reorder, add_urls, keep_first_n}. OPTION_EDITS (always full replacement): [{action:'rename_option',option_name:'Color',new_name:'Style'},{action:'rename_value',option_name:'Color',value_name:'Red',new_name:'Crimson'},{action:'remove_value',option_name:'Color',value_name:'Gray'},{action:'remove_option',option_name:'Size'}]. Only include families you want to change. Others are preserved automatically.
pricing_modestringFlat param: pricing mode. Use instead of rules_json for simple pricing.one of
multiplier · fixed_markup · fixed_pricetarget_storestringStore ID or name from dsers_store_discover.
title_prefixstringFlat param: REPLACE the title-prefix slot. Each call sets the desired prefix outright — passing a new value strips any prior prefix we put there. Empty string '' clears the slot.
title_suffixstringFlat param: REPLACE the title-suffix slot. Each call sets the desired suffix outright. Empty string '' clears the slot.
import_item_idstringImport-item ID from a previous dsers_product_import call.
title_overridestringFlat param: replace entire product title. Clears any title_prefix/suffix slot applied earlier.
visibility_modestringbackend_only (default, safe) or sell_immediately (live — confirm with user).
pricing_multipliernumberFlat param: multiplier value when pricing_mode='multiplier'.
pricing_fixed_pricenumberFlat param: exact price in dollars when pricing_mode='fixed_price'.
pricing_fixed_markupnumberFlat param: markup in dollars when pricing_mode='fixed_markup'.
description_append_htmlstringFlat param: REPLACE the description-append slot. Each call sets the appended HTML outright — the prior append (if any) is stripped first. Empty string '' clears the slot.
description_override_htmlstringFlat param: replace full description (HTML).
dsers_store_pushPush one or more prepared import drafts to the connected Shopify or Wix store(s). SAFETY: Automatic pre-push validation checks pricing (blocks if sell price < cost or $0) and stock (blocks if all variants have zero inventory). Warnings are raised for low margin (<10%), low sto...7 params
Push one or more prepared import drafts to the connected Shopify or Wix store(s). SAFETY: Automatic pre-push validation checks pricing (blocks if sell price < cost or $0) and stock (blocks if all variants have zero inventory). Warnings are raised for low margin (<10%), low sto...
Parameters* required
force_pushvalueOverride pre-push safety checks. ONLY set true after you have shown the user the specific risk (e.g., 'This product is priced below cost — you will lose $X per sale') and they explicitly confirmed. Never set this silently.
target_storestringTarget store ID or display name from dsers_store_discover. Required when the account has multiple stores.
import_item_idstringSingle import-item ID from dsers_product_import. Used for single-push or multi-store mode.
visibility_modestringVisibility mode for the push. backend_only: draft — SAFE. sell_immediately: published and LIVE — RISK: confirm pricing/inventory with user first.
push_options_jsonstringPush configuration as JSON string. Keys: publish_to_online_store (bool), image_strategy ('selected_only' or 'all_available'), pricing_rule_behavior ('keep_manual' or 'apply_store_pricing_rule'), shipping_profile_name (string — Shopify delivery profile name), auto_inventory_update (bool), auto_price_update (bool), sales_channels (string[]), only_push_specifications (bool). Example: {"image_strategy": "all_available", "shipping_profile_name": "DSers Shipping Profile"}
target_stores_jsonstringMulti-store: JSON array of store IDs or display names. Pushes the same import_item to each listed store. Example: ["Store A", "Store B"]
import_item_ids_jsonstringBatch push: JSON array of import_item_id strings or objects {import_item_id, target_store?, target_stores?, push_options?, visibility_mode?}. Example: ["68fabc123", {"import_item_id": "68fdef456", "target_store": "My Store"}]. When provided, this takes priority over import_item_id.
dsers_product_deletePermanently delete a product from the DSers import list. IRREVERSIBLE — the product cannot be recovered after deletion. Requires explicit confirmation (confirm=true) to execute. If called without confirm=true, returns a confirmation prompt — show this to the user. SCOPE: Only...2 params
Permanently delete a product from the DSers import list. IRREVERSIBLE — the product cannot be recovered after deletion. Requires explicit confirmation (confirm=true) to execute. If called without confirm=true, returns a confirmation prompt — show this to the user. SCOPE: Only...
Parameters* required
confirmvalueSet to true to confirm deletion. First call without this to get a confirmation prompt, then call again with confirm=true after user approves.
import_item_idstringThe import list item ID to delete. Obtain from dsers_product_preview (provider_state.import_item_id) or from searchImportList results.
dsers_import_listBrowse the DSers import list with enriched variant data. Returns per item: import_item_id, title, image, sell_price_range, cost_range, currency, variant_count, total_stock, push_status, supplier, source_url, tags. no_markup=true when sell equals cost (no pricing rule applied)....2 params
Browse the DSers import list with enriched variant data. Returns per item: import_item_id, title, image, sell_price_range, cost_range, currency, variant_count, total_stock, push_status, supplier, source_url, tags. no_markup=true when sell equals cost (no pricing rule applied)....
Parameters* required
pageintegerPage number (1-based). Default: 1.
page_sizeintegerItems per page. Default: 20. Max: 100.
dsers_my_productsBrowse products already pushed to a store. Requires store_id (from dsers_store_discover). Returns compact items with: dsers_product_id, title, image, sell_price (min/max in $), cost (min/max in $), status (Draft/Active), supplier, supplier_url. Prices are in dollars (converted...3 params
Browse products already pushed to a store. Requires store_id (from dsers_store_discover). Returns compact items with: dsers_product_id, title, image, sell_price (min/max in $), cost (min/max in $), status (Draft/Active), supplier, supplier_url. Prices are in dollars (converted...
Parameters* required
pageintegerPage number (1-based). Default: 1.
store_idstringStore ID from dsers_store_discover. Required.
page_sizeintegerItems per page. Default: 20. Max: 100.
dsers_find_productSearch the DSers product pool for products to import by keyword or by image URL (visual search). Covers three supplier catalogs — AliExpress (default), Alibaba, and 1688 Dropshipping — select via the `supplier` param. Returns products that can be directly imported via dsers_pr...9 params
Search the DSers product pool for products to import by keyword or by image URL (visual search). Covers three supplier catalogs — AliExpress (default), Alibaba, and 1688 Dropshipping — select via the `supplier` param. Returns products that can be directly imported via dsers_pr...
Parameters* required
sortstringSort orderone of
relevance · newest · pricelimitnumberResults per page (max 50)default: 20
keywordstringSearch keyword. Omit when using image_url.
ship_tostringDestination country codedefault: US
supplierstringWhich supplier catalog to search. Default: aliexpress. Use 'alibaba' for Alibaba.com dropshipping products (MOQ-1 items), or 'ali1688' for the 1688 Dropshipping catalog.one of
aliexpress · alibaba · ali1688image_urlstringImage URL for visual search. Mutually exclusive with keyword — if both provided, image_url takes priority.
ship_fromstringOrigin country code (CN, US, FR, UK)
category_idstringCategory ID filter
search_afterstringCursor from previous response for pagination
dsers_sku_remapReplace the supplier on a store product with SKU-level variant matching. DEFAULTS TO mode='preview' which is read-only and safe to call without confirmation — only mode='apply' actually writes to DSers. TWO discovery paths: (A) STRICT — caller provides new_supplier_url and the...7 params
Replace the supplier on a store product with SKU-level variant matching. DEFAULTS TO mode='preview' which is read-only and safe to call without confirmation — only mode='apply' actually writes to DSers. TWO discovery paths: (A) STRICT — caller provides new_supplier_url and the...
Parameters* required
modestringpreview (default — read-only, no DSers writes, safe to call repeatedly) or apply (persist the swap; verify diffs in preview first).one of
preview · applydefault: previewcountrystringTarget country code for candidate fetch. Default US.default: US
store_idstringStore ID from dsers_store_discover. Required. Must be a string (DSers backend rejects integer storeId due to int64 precision). Must be a numeric string that fits in a signed int64 (max 9223372036854775807) — the schema's maxLength:19 + numeric pattern allow up to 19 digits but values above the int64 ceiling are rejected at the MCP boundary.
max_candidatesintegerDISCOVER mode only. Max candidates to fetch full variant detail for and rank. Default 5. Ignored in STRICT mode.default: 5
auto_confidencenumberMinimum sku-matcher confidence (0-100) for a variant to be auto-swapped. Default 70.default: 70
dsers_product_idstringDSers product ID of the store product whose supplier you want to replace. Get from dsers_my_products. Must be a numeric string that fits in a signed int64 (max 9223372036854775807) — the schema's maxLength:19 + numeric pattern allow up to 19 digits but values above the int64 ceiling are rejected at the MCP boundary.
new_supplier_urlstringOPTIONAL. AliExpress / Alibaba / 1688 URL of the replacement supplier. Provide to use STRICT mode (exact swap). Omit to use DISCOVER mode (reverse-image search to auto-find the best replacement). Must be a valid http/https URL — plain text / non-URL strings are rejected at the MCP boundary. URL scheme is normalized to lowercase (HTTPS:// → https://) per RFC 3986 before the candidate fetch.
DSers Official MCP Server
Official DSers MCP Server for AI-powered dropshipping automation.
This is the official DSers MCP Server, listed on the Official MCP Registry as io.github.dsers/dsers-mcp-server.
The DSers Official MCP Server is a hosted remote Model Context Protocol server that allows MCP-compatible AI clients and ChatGPT Apps to work with DSers dropshipping workflows, including product search, product import, product optimization, variant editing, pricing rules, store publishing, and supplier replacement.
This repository does not contain the DSers MCP server backend source code. It provides official public documentation, connection information, examples, and registry metadata for the DSers-hosted remote MCP server.
Remote MCP Endpoint
https://mcp.dsers.com/dropshipping/mcp
Transport
Remote HTTP / Streamable HTTP.
This server does not provide a local stdio server.
Authentication
DSers MCP uses OAuth 2.1 + PKCE.
Do not configure API keys.
Do not manually add an Authorization header.
Do not paste DSers backend API keys, store tokens, or browser cookies into an MCP client.
On first tool use, supported MCP clients open the DSers authorization page. After the user signs in and approves access, the client can call DSers MCP tools.
For details, see Authentication.
Requirements
You need:
- A DSers account
- At least one Shopify or Wix store connected in DSers
- An MCP client that supports remote HTTP MCP and OAuth 2.1 + PKCE
Verified clients (tested end to end): ChatGPT Developer Mode, Claude Desktop, Cursor, Claude Code, Codex CLI, OpenClaw.
Expected to work (any MCP client with remote HTTP + OAuth 2.1 + PKCE support): VS Code, Cline, Windsurf, Zed, Continue.
What You Can Do
- Import products from AliExpress, Alibaba, 1688, Accio, or supported supplier sources
- Apply pricing, title, description, image, and variant rules
- Preview DSers drafts before pushing to Shopify or Wix
- Search the DSers product pool
- Browse DSers import-list drafts and already pushed products
- Replace suppliers on existing store products with SKU-level matching
Quick Start
Claude Desktop
Add this to claude_desktop_config.json:
{
"mcpServers": {
"dsers": {
"type": "http",
"url": "https://mcp.dsers.com/dropshipping/mcp"
}
}
}
Restart Claude Desktop. On first tool use, the client starts OAuth and opens the DSers login page.
Claude Code
claude mcp add dsers https://mcp.dsers.com/dropshipping/mcp --transport http
claude mcp login dsers
Cursor
Open:
Settings → Tools & Integrations → MCP Tools → Add / Connect
Use this server URL:
https://mcp.dsers.com/dropshipping/mcp
Cursor should start the OAuth flow automatically.
Codex CLI
After adding the MCP server, run:
codex mcp login dsers
If the client asks for the server URL, use:
https://mcp.dsers.com/dropshipping/mcp
ChatGPT App
Use the remote endpoint in ChatGPT Developer Mode or the Apps dashboard:
https://mcp.dsers.com/dropshipping/mcp
The current ChatGPT submission target is data-only: DSers exposes normal MCP tools and does not require an iframe widget. See ChatGPT App submission notes.
OpenClaw
openclaw mcp set dsers '{"url":"https://mcp.dsers.com/dropshipping/mcp","transport":"streamable-http"}'
Transport and authorization support may vary by OpenClaw deployment. Follow the connection guide for your current environment.
Documentation
- Authentication
- Tools
- Privacy and Security
- ChatGPT App submission notes
- ChatGPT App E2E playbook
- Hosted deployment notes
- Examples
- 中文说明
Example MCP Client Configuration
{
"mcpServers": {
"dsers": {
"type": "http",
"url": "https://mcp.dsers.com/dropshipping/mcp"
}
}
}
A minimal example is also available at examples/remote-mcp.json.
Registry and Review Files
server.json- MCP registry metadata for the hosted remote servermanifest.json- public app metadata, tool list, prompts, and privacy URLchatgpt-app-submission.json- ChatGPT App review helper with tool hints and test prompts
License
This public documentation and metadata repository is licensed under the Apache License 2.0.
Support
For non-sensitive documentation, connection, client compatibility, or usage questions, open a GitHub issue:
https://github.com/dsers/dsers-mcp-server/issues
For vulnerabilities, tokens, or account-specific data, contact:
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
