DS-Mate MCP serverRead only

Ask about your DS-Mate business from the AI app you already use

Connect Claude, ChatGPT or Codex to your DS-Mate account. Ask about your stores, orders, suppliers and buyer messages, and find products on AliExpress. It answers questions and changes nothing.

https://ai.ds-mate.com/mcp

14 tools in 5 areas
Sign in with DS-Mate, no API key
Disconnect any time

How it works

One sign-in between your AI app and your DS-Mate account

Your AI app talks to DS-Mate's server. It answers from the same records your dashboard shows, and only for the account you signed in with.

AI appClaude, ChatGPT, CodexYou ask in plain words.

DS-Mate MCP serverai.ds-mate.com/mcpLists 14 tools. Changes nothing.

Your DS-Mate accountStores, orders, suppliersThe data your dashboard shows.

Step 01

Add the server

Paste the server URL into your AI app. Steps for each app are below.

Step 02

Sign in and allow access

Step 03

Ask

The app picks the tools and shows you what it called.

Step 04

Disconnect any time

In DS-Mate, Settings, Connected apps. The app's next call is refused.

Connect your app

Add DS-Mate in about a minute

Pick your AI app, then follow three steps.

Open DS-Mate in the directory
DS-Mate is listed in Claude's connectors directory. Open its page while signed in to Claude.
Open DS-Mate in Claude
Connect to Claude
Choose Connect to Claude on the DS-Mate page.
Allow access
Sign in with your DS-Mate account and press Allow access.

What it can do

Your business, one connection

AccountConfirm which account is connected, and get the dashboard's overview: orders, sales, net revenue, returns and the orders waiting on you.dsmate_get_accountdsmate_get_dashboard_summary

StoresSee each connected store with its channel, status and last sync, list a store's products, and get the categories, collections and tags it accepts.dsmate_list_storesdsmate_list_store_productsdsmate_get_store_schema

OrdersList orders across your stores, see why one is stuck the way the dashboard explains it, and find variants with no supplier linked.dsmate_list_ordersdsmate_get_orderdsmate_list_unmapped_variants

SourcingSearch AliExpress by keyword or by an image link, get one product's full details and variants, and see your connected supplier accounts.dsmate_list_suppliersdsmate_search_productsdsmate_search_by_imagedsmate_get_product_by_url

MessagesRead buyer conversations from your eBay stores, newest first, on plans that include messaging. Your AI app cannot send a buyer a message.dsmate_list_messagesdsmate_get_message_thread

Catalogue changesNot available yetImporting a supplier product into your stores, and linking a store variant to a supplier variant. Each will be a preview you confirm. No app sees these tools today.dsmate_preview_import_productdsmate_confirm_import_productdsmate_preview_link_variantdsmate_confirm_link_variant

No changes yetToday every tool your app sees reads. Import and link come later, each a preview you confirm.

No messagesNo AI app gets a tool that sends a buyer a message.

No paymentsIt cannot place or pay for supplier orders.

No passwordsIt never sees your password or card details.

Put it to work

Six things to ask on day one

Pick a moment to see what to ask, which tools answer it, and what an answer looks like.

Try asking

“How did my stores do in the last 7 days, and which orders are waiting on me?”

Tools it calls

Readdsmate_get_dashboard_summary
Readdsmate_list_orders

Example answer from a demo store

Last 7 days: 42 orders and $3,180 in sales across your 2 stores. 3 orders are waiting on you: 2 need payment and 1 has a variant with no supplier.

Tool reference

Every tool, as your AI app sees it

Grouped by area and generated from the tools themselves.

Account

2 tools

dsmate_get_accountGet the connected DS-Mate account: owner email and the stores available to this connector.
dsmate_get_dashboard_summaryGet the DS-Mate dashboard's performance overview across all the seller's stores, or one store with storeId: orders, sales (gross), revenue (after marketplace fees and tax), profit (after fees and supplier cost), active products, returns and the orders waiting on the seller.

Stores

3 tools

dsmate_list_storesList the DS-Mate stores connected to this account, with channel, status, and when each last synced successfully. storeId is the id every other DS-Mate tool takes.
dsmate_list_store_productsList the products listed in one DS-Mate store (its catalog).
dsmate_get_store_schemaGet the import organization data valid for one store: product categories, collections, product types, and tags.

Orders

3 tools

dsmate_list_ordersList orders across the seller's connected DS-Mate stores, newest first (by when the buyer ordered).
dsmate_get_orderDiagnose one order the way the DS-Mate dashboard shows it.
dsmate_list_unmapped_variantsList product variants that are not yet linked to a supplier across the connected DS-Mate stores (these block fulfillment).

Sourcing

4 tools

dsmate_list_suppliersList the supplier accounts (AliExpress, CJ, 4PX and others) the seller connected to DS-Mate, the ones the dashboard's Settings > Suppliers page shows, with each one's status, whether it is the default for its supplier, and when its sign-in lapses.
dsmate_search_productsSearch AliExpress, the supplier the DS-Mate AI tools look up, for products by keyword.
dsmate_search_by_imageFind AliExpress products that look like the image at a link (an https link to a public image; uploading a file is not supported).
dsmate_get_product_by_urlGet full details for one AliExpress product from its link or its product id: title, price, description (HTML for import, plain text to show), images, availability, the currency of every price, and its variants with price, sale price, stock and options. price is the lowest price among its variants in stock that a seller pays today (its sale price when one is on; every variant counts when the supplier gives no stock), so it can differ from a search's price: the searches pass on AliExpress's own price, which nothing checks against stock.

Messages

2 tools

dsmate_list_messagesList buyer conversations from the seller's DS-Mate stores, newest message first, with conversations active in the last 30 days, and the count of conversations with an unread buyer message (unreadTotal).
dsmate_get_message_threadRead the messages of one buyer conversation by its threadId (from dsmate_list_messages).

Limits and errors

What to expect when a call is refused

Rate limits

60tool calls every 60 seconds for each seller, across all apps.
3000tool calls every 60 seconds for each app, across all sellers.
8calls running at once for each seller; the next ones wait their turn.
64calls waiting for each seller; the next one is refused.

When a call is refused

The app gets an error with a code, a message that says what to do next, and sometimes details.

REAUTH_REQUIREDThe connection is no longer valid: it was revoked, or its DS-Mate account no longer exists. Reconnect DS-Mate.Reconnect DS-Mate in your app.
UPSTREAM_ERRORDS-Mate could not complete the call: no answer in time, a network or server error, or an answer the tool could not read. details.reason names the case when there is one.Try again later.
VALIDATIONThe arguments do not fit the tool's input, or DS-Mate refused the request for this account (for example a write on a read-only connection). The message says what to change.Change the request as the message says.
NOT_FOUNDDS-Mate has no record matching an id or reference in the request.Check the order number or id.
RATE_LIMITEDA call limit was reached. When the gateway refused the call, details.retryAfterSeconds says how long to wait.Wait the seconds in details.retryAfterSeconds, then retry.
AMBIGUOUSThe reference names more than one record (dsmate_get_order: an order name or id shared by several orders, in one store or several). Nothing is wrong with the request. matches lists each record with what tells them apart; ask the user which one, then call again with its id.Say which record you mean, then ask again.

Code	What happened	What to do
REAUTH_REQUIRED	The connection is no longer valid: it was revoked, or its DS-Mate account no longer exists. Reconnect DS-Mate.	Reconnect DS-Mate in your app.
UPSTREAM_ERROR	DS-Mate could not complete the call: no answer in time, a network or server error, or an answer the tool could not read. details.reason names the case when there is one.	Try again later.
VALIDATION	The arguments do not fit the tool's input, or DS-Mate refused the request for this account (for example a write on a read-only connection). The message says what to change.	Change the request as the message says.
NOT_FOUND	DS-Mate has no record matching an id or reference in the request.	Check the order number or id.
RATE_LIMITED	A call limit was reached. When the gateway refused the call, details.retryAfterSeconds says how long to wait.	Wait the seconds in details.retryAfterSeconds, then retry.
AMBIGUOUS	The reference names more than one record (dsmate_get_order: an order name or id shared by several orders, in one store or several). Nothing is wrong with the request. matches lists each record with what tells them apart; ask the user which one, then call again with its id.	Say which record you mean, then ask again.

Example: a refused call

isError: true
code:    RATE_LIMITED
message: "Too many calls. Try again in 20 seconds."
details: { retryAfterSeconds: 20 }

What DS-Mate logs

One line per tool call, so you and we can see what an app did.

Logged: Your account, the app, the tool, the ids it passed, the result and timing
Never logged: The answer, message text, customer names or search words
Kept: 90 days in our monitoring service, 3 days on our servers

FAQs

Questions sellers ask

No. Every app gets read only access today: it answers questions and changes nothing. Importing products and linking variants come later, and each will be a preview you confirm.

Add DS-Mate to your AI app

Paste the server URL, sign in, and ask your first question.