Discover Stores and Supplier Apps
list_stores[Store]
[What it does] Lists connected seller stores with their application, country, currency, timezone and connection status, plus supplier applications and their connected accounts. Pass view=account_context to return only stores and supplier_apps; this view omits stores[].pricing_currency, stores[].shipping_profiles, and push_configuration. Omit view or use view=full for the full response.
[When to use] Call it when the user asks which stores or supplier accounts are connected, about a store's currency, timezone or status, and proactively before any store-scoped action because downstream tools accept only a store ID. Trigger words: store list, supplier account, Shopify, store status, authorization, currency, timezone.
[When not to use] For products inside a store use search_store_products; for pricing-rule detail use get_pricing_rule; for a reconnect link use start_store_reauthorization. It never adds, unbinds or edits stores or supplier accounts.
[How to use]
In most cases, omit
viewand use the default full response. Passview=account_contextonly when you need just stores and supplier apps/accounts without pricing, Shipping Profile, or product-push details.Match the user's store reference against the returned stores; continue only on one clear match, ask the user to choose on multiple matches, and never write to all stores by default.
An empty list means no connected store is available, and sections in
degraded_partsare unavailable only this time — note them and continue rather than retrying. If a status is notAVAILABLE, inspect the returned status before choosing reauthorization; do not infer that every non-available state requires it.Do not mix IDs:
stores[].dsers_store_idfor store-scoped tools,stores[].sales_channel_idfor connection flows,supplier_apps[].supplier_platform_idfor supplier scope, andsupplier_apps[].accounts[].supplier_account_idfor an exact supplier account. The account ID comes from upstreamsupplierId; it is not the account rowid, user ID, email, or login name.Only AliExpress and Alibaba.com support multiple supplier accounts. Pass
supplier_account_idtoplace_orders_to_suppliersonly when one of those platforms has multiple usable accounts and the user selected one; omit it for a single account and every other supplier platform.Hidden stores are still returned — exclude or flag them when counting, and read each store in its own currency and timezone, not the account's.
For
publish_products_to_stores, Shopify Shipping Profile choices come fromstores[].shipping_profiles[].idand the chosen profile'slocations[].id; fixed product-push choices remain in that Tool's input schema, while this Tool also returns dynamic languages and effective store defaults.For a Shopify store, if
stores[].shipping_profilesis empty, first calllist_shopify_shipping_zonesfor the same store to obtain valid country codes and currency, then callcreate_shopify_shipping_profile. After creation succeeds, calllist_storesagain and use the refreshedstores[].shipping_profiles[].idand the selected profile'slocations[].id; never invent or reuse stale IDs. [Side effects] Read-only; no store, authorization or push setting is changed. [Confirmation] None required; picking among matches is disambiguation.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_stores"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | Response detail level. full returns the complete response. account_context returns only stores and supplier apps/accounts, omitting pricing_currency, shipping_profiles, and push_configuration. | full |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| stores | Yes | Connected sales stores owned by the authenticated account | |
| supplier_apps | Yes | Visible supplier-platform applications and their connected supplier accounts | |
| degraded_parts | No | Sections unavailable during this read; other returned sections remain usable | |
| push_configuration | No | Dynamic publish languages and effective per-store push defaults | |
| toolcall_response_at | Yes | UTC timestamp when the Tool response was returned, formatted as RFC3339. |