MCP tool catalog
The DataGlass MCP tool surface by business domain — the read tools, and the write tools each per-domain scope unlocks. 568 tools in total, 263 of them write-capable.
The production connector exposes 568 tools, of which 263 can write. This catalog is representative, not exhaustive: it names the tools worth knowing in each business domain and states which scope a domain's writes require. Runtime tools/list is the machine-readable source of truth for the exact set, JSON Schema inputs, and outputs.
Every tool a domain lists is available only if the connector holds the matching scope. A connector is read-only until you approve a write scope on the consent screen — see Permissions and safety for the model.
All shop-scoped requests remain subject to DataGlass authentication, organization and shop ownership, page permissions, Pro-plan access, and rate limits. Object request bodies are normally flattened into top-level tool arguments; array and scalar bodies keep their named body argument.
How to read this catalog
- The read domains below need no write scope. They report, compare, diagnose, recommend, and simulate.
- The write domains further down are grouped by the
PAT_*scope that unlocks them. Every tool in them advertisesdestructiveHint=true, so your assistant prompts before executing. - Counts shown per domain are the tools documented here, not the full runtime surface.
Foundation and product search · 3
| Tool | Use | Key input or routing note |
|---|---|---|
get_playbook | Retrieve server-provided workflows and conventions. | Optional playbook; omit it for the index. |
search | Find canonical products by name, SKU, model SKU, or numeric listing ID. | Required query; returns up to 50 canonical-product:<id> results. |
fetch | Retrieve one canonical product and all marketplace bindings after search. | Required id exactly as returned by search. |
Search-result URLs are relative. Resolve them against https://app.dataglasslabs.com.
Shop discovery and authorization · 4
| Tool | Use | Key input or routing note |
|---|---|---|
list_shopee_shops | List connected Shopee shops with ID, name, region, timezone, and seller class. | No arguments; call before Shopee shop tools. |
list_shopee_shop_accounts | Inspect Shopee authorization by shop and app type. | No arguments; non-null deauthorizedAt means expired or revoked access. |
list_lazada_shops | List connected Lazada sellers with seller ID, name, and region. | No arguments; Lazada calls name the shop identifier sellerId. |
list_tiktok_shops | List connected TikTok Shops with shop ID, name, and region. | No arguments; preserve every returned ID as a string. |
Unified financial health · 2
| Tool | Use | Key input or routing note |
|---|---|---|
get_financial_overview | Cross-platform realized-profit rollup across all connected shops. | Optional lookback, dates, top-N, and VAT settings; no shop ID. |
diagnose_shop | Compact shop health check with KPI deltas, COGS coverage, loss-makers, top and worst products, and drilldown signals. | platform, discovered shopId, region; optional lookbackDays and includeInferredCogs. |
Begin broad health and decline questions with diagnose_shop; follow a returned signal only when detail is necessary.
Canonical products and cost basis · 5
| Tool | Use | Key input or routing note |
|---|---|---|
list_products | Return canonical products with Shopee, Lazada, and TikTok bindings. | searchParams array; use [] for no filter. |
list_shopee_products | Paginated Shopee dashboard with stock, price, units sold, and margin. | Shopee dashboard request with discovered shop and pagination or filters. |
list_lazada_products | Paginated Lazada dashboard with stock, price, units sold, and margin. | Lazada dashboard request with discovered seller and pagination or filters. |
get_product_costs | Retrieve stored COGS and manufacturing costs used in margin. | canonicalIds from canonical product results. |
get_estimated_margin | Read the inferred shop margin used when explicit COGS is absent. | Shopee shopId; this is shop-level inference despite the historical name. |
TikTok product discovery is available through search, fetch, and list_products; there is no curated list_tiktok_products tool.
Product conversion metrics · 3
| Tool | Use | Key input or routing note |
|---|---|---|
get_shopee_product_conversion_metrics | Shopee impressions, clicks, CTR, CVR, orders, units, revenue, spend, and views. | shopId, region, datadateFrom, datadateTo; optional product and pagination filters. |
get_lazada_product_conversion_metrics | Lazada impressions, clicks, CTR, CVR, orders, units, revenue, spend, and views. | sellerId, region, datadateFrom, datadateTo; optional product and pagination filters. |
get_tiktok_product_conversion_metrics | TikTok impressions, clicks, CTR, CVR, orders, units, revenue, spend, and views. | String shopId, datadateFrom, datadateTo; optional product and pagination filters. |
Conversion dates use YYYYMMDD, not YYYY-MM-DD.
Orders and fulfilment reads · 4
| Tool | Use | Key input or routing note |
|---|---|---|
count_orders | Count normalized orders across all shops or one platform. | Optional platform, fromDate, toDate; inclusive YYYY-MM-DD. |
list_orders | Paginate normalized orders across connected shops. | Platform, shop, date filters, and cursor from the runtime schema. |
get_order | Retrieve normalized order detail, lines, quantities, prices, and fees. | canonicalOrderId returned by list_orders. |
count_unshipped_orders | Count pending-fulfilment backlog. | Optional sinceDays, default 30. |
Canonical platform values include shopee, lazada, and tiktok_shop. Use a count tool when the question is only "how many?"
Shopee financials, fees, ROAS, and payout · 13
| Tool | Use | Key input or routing note |
|---|---|---|
get_shopee_financial_overview | Realized profit, weighted margin, period comparison, and COGS coverage for one shop. | shopId, region; optional dates, top-N, VAT, and inferred COGS. |
get_shopee_cost_breakdown | Fee, transaction, service, shipping, COGS, and ads cost lines. | Same shop and window settings as the overview. |
get_shopee_pnl_flow | Waterfall from gross revenue through costs to net profit. | Same shop and window settings as the overview. |
get_shopee_product_profit | Forward-profit economics for one item or model. | shopId, region, itemId; optional modelId. |
get_shopee_variant_breakdowns | Variant-level profit rows for selected model IDs. | shopId, region, modelIds. |
get_shopee_product_breakdowns | Paginated batch product profit breakdown. | Path shopId, region; optional IDs, window, and cursor. |
rank_shopee_products_by_profit | Rank best and worst products by total profit. | shopId, region; optional window, sort, filters, and paging. |
simulate_shopee_profit | Test price, discount, or COGS economics without writing. | Current product identity plus only the override fields being tested. |
get_shopee_product_roas | Cancellation-deduped, profit-adjusted ROAS for one product. | shopId, region, itemId; optional analysis window. |
get_shopee_corrected_roas | Corrected shop or product ads ROAS after cancellations and returns. | shopId, region, and required analysis request. |
get_commission_overview | Current declared Shopee fee rates by category. | shopId, region; optional scope or filter request. |
get_commission_impact | Estimated profit impact from an upcoming fee change. | shopId, region, requested rate and effective-date scenario. |
get_shopee_payout | Reconcile expected versus reported escrow payout and order lines. | shopId, inclusive payout dates from and to; optional incomeStatus 1 paid or 2 pending. |
Payout is not profit. Use get_shopee_payout for "how much did Shopee pay me?" and financial overview tools for profitability.
Lazada financials and settlement · 7
| Tool | Use | Key input or routing note |
|---|---|---|
get_lazada_financial_overview | Lazada P&L overview with profit, margin, top and worst products, and costs. | Discovered sellerId, region; optional dates, top-N, VAT, and inferred COGS. |
get_lazada_product_profit | Forward-profit economics for one Lazada item or SKU. | sellerId, region, itemId; optional skuId. |
get_lazada_sku_breakdowns | Variant-level profit breakdown for Lazada SKUs. | Path sellerId, region; optional filters. |
get_lazada_product_breakdowns | Paginated batch product profit breakdown. | Path sellerId, region; optional products, window, and cursor. |
rank_lazada_products_by_profit | Rank Lazada products by total profit. | Path sellerId, region; optional window, sort, and paging. |
simulate_lazada_profit | Test price, discount, or COGS economics without writing. | Current product identity plus only the overrides being tested. |
get_lazada_payout | Net finance-statement settlement split into paid and pending. | sellerId, region, inclusive settlement dates from and to. |
Lazada exposes net settled-ledger totals, not the expected-versus-reported reconciliation report available for Shopee and TikTok.
TikTok financials, fees, ROAS, and payout · 9
| Tool | Use | Key input or routing note |
|---|---|---|
get_tiktok_financial_overview | TikTok Shop P&L with profit, margin, top and worst products, and costs. | Exact string shopId, region; optional dates, top-N, VAT, and inferred COGS. |
get_tiktok_product_profit | Forward-profit economics for one product or SKU. | Exact shopId, productId; optional skuId. |
get_tiktok_sku_breakdowns | Profit breakdown for selected TikTok SKU IDs. | Exact shopId and skuIds, preserved as strings. |
get_tiktok_product_breakdowns | Batch product profit breakdown. | Exact shopId, productIds; optional per-product ads-cost map. |
simulate_tiktok_profit | Test price, discount, or COGS economics without writing. | Current product identity plus only the overrides being tested. |
get_tiktok_campaign_roas | Cancellation and return-deduped True ROAS for a GMV Max campaign. | Exact shopId, region, campaignId, advertiserId; optional window. |
get_tiktok_commission_overview | Current TikTok fee rates by category. | Exact shopId; optional scope or filters. |
get_tiktok_commission_impact | Product and shop impact from an upcoming fee change. | Exact shopId plus rate and effective-date scenario. |
get_tiktok_payout | Reconcile expected versus actual bank-settlement statements. | Exact shopId, inclusive payout dates from and to; optional status. |
Treat every TikTok identifier as an opaque string, even when it contains only digits.
Shopee ads and growth reads · 6
| Tool | Use | Key input or routing note |
|---|---|---|
get_shopee_ads_performance | Active-campaign dashboard with spend, GMV, orders, and ROAS. | shopId, region; optional dates, sort, filters, page, and cursor. |
get_shopee_ads_recommendations | Suggested campaign budgets and bids. | shopId, region; optional status and campaign filters. |
get_shopee_campaign_profit_adjusted_roas | Stored preferred profit-adjusted ROAS floor by campaign. | shopId, region; optional campaignId. |
get_shopee_target_roas_recommendations | Margin-based target-ROAS proposals for auto-bidding. | shopId, region; optional status and campaign filters. |
get_shopee_gms_target_roas_recommendations | Shop-level GMV Max or GMS target-ROAS proposals. | shopId, region; optional status filters. |
get_shopee_boost_recommendations | Products recommended for search or ads boost. | Shop, region, and optional recommendation filters. |
Start from performance and True or profit-adjusted ROAS. Do not recommend budget changes from marketplace headline ROAS alone.
TikTok GMV Max ads reads · 4
| Tool | Use | Key input or routing note |
|---|---|---|
get_tiktok_gmv_max_campaigns | GMV Max campaigns with rolling 30-day expense, orders, GMV, ROAS, CTR, and CPC. | String shopId, region; optional advertiser, campaign, status, cursor, and page filters. |
get_tiktok_gmv_max_sessions | Product and SKU bid sessions beneath GMV Max campaigns. | String shopId, region; optional advertiser, campaign, session, cursor, and page filters. |
get_tiktok_budget_recommendations | Suggested GMV Max campaign budgets. | Exact shopId, region; optional campaign and status filters. |
get_tiktok_target_roas_recommendations | Suggested GMV Max target ROAS. | Exact shopId, region; optional campaign and status filters. |
Use the campaign list first, sessions only for product-level drilldown, and get_tiktok_campaign_roas for cancellation-adjusted evidence.
Cross-domain recommendation reads · 5
| Tool | Use | Key input or routing note |
|---|---|---|
list_recommendations | Cursor-paginated recommendation feed across shops and types. | Optional shop, platform, type, and status filters; pass nextCursor for more. |
get_bundle_deal_recommendations | Suggested Shopee product groupings for bundle deals. | shopId, region; optional status and filters. |
get_margin_defense_actions | Shopee price-raise or discount-trim proposals for fee changes. | shopId, region; optional recommendation status. |
get_tiktok_margin_defense_actions | TikTok price-raise or discount-trim proposals. | Exact string shopId, region; optional status. |
get_price_buffer_recommendations | Shopee and TikTok price-buffer or discount proposals that defend margin. | Shop, platform, region, and optional status or filters from the schema. |
Reading a recommendation needs no write scope. Applying, rejecting, stopping, or rolling one back is available under PAT_RECOMMENDATION_WRITE, or under the domain scope that owns the change — a margin-defense apply is a pricing write, an ads-recommendation apply is an ads write. Bundle-deal recommendations are the exception: DataGlass can propose the grouping, but there is no mediated bundle-deal write, so an assistant cannot create one.
Inventory planning reads · 5
| Tool | Use | Key input or routing note |
|---|---|---|
get_inventory_alerts | Reorder-point alerts, live first and then resolved history. | Optional status: open, acknowledged, dismissed, or resolved. |
get_reorder_plan | Computed (s,S) reorder threshold and quantity by SKU. | No arguments; self-scoped to the authenticated user's inventory. |
get_inventory_forecast | Forecast over the planning horizon. | Optional canonicalVariantId; bucket W weekly or M monthly. |
get_demand_chart | Historical and forecast demand time series. | Optional canonicalVariantId; default bucket W; weeksBack defaults to 26. |
get_open_purchase_orders | Open and inbound purchase orders used to avoid double ordering. | Optional status: open, received, or cancelled. |
The inventory surface is cross-shop and self-scoped. Check inbound purchase orders before finalizing a reorder quantity.
Pricing writes · PAT_PRICING_WRITE · 103 tools
The largest write domain. Price-tier drafts are the mediated path: build a draft, evaluate its economics, apply it, and roll it back if needed.
| Tool | Use | Destructive |
|---|---|---|
create_price_tier_draft | Stage price and discount changes for a set of variants without touching the platform. | No |
get_price_tier_draft | Read a draft's contents before applying it. | No |
evaluate_price_tier_changes | Compute the resulting margin for a draft. | No |
apply_price_tier_draft | Push the draft's prices and discounts live to the platform. Buyers see the new prices. | Yes |
rollback_price_tier_draft | Restore each applied variant's captured pre-apply price. Fresh platform writes, not an undo. | Yes |
apply_shopee_target_margin | Compute and push the discount or list price required to hit a target margin. Run preview_shopee_target_margin first. | Yes |
apply_margin_defense_action | Trim discount or raise list price per variant against a fee change; can also stage for a future deploy date. | Yes |
apply_price_buffer_discount | Apply a margin-defending price-buffer proposal. | Yes |
Lazada and TikTok have parallel tools under the same scope: apply_lazada_price_tier_draft, apply_tiktok_price_tier_draft, apply_lazada_target_margin, apply_tiktok_target_margin, apply_tiktok_margin_defense_action, and their rollback and cancel counterparts.
Ads writes · PAT_ADS_WRITE · 46 tools
| Tool | Use | Destructive |
|---|---|---|
create_ads_group | Create an ads optimization group over a set of campaigns and activate it. | No |
enable_ads_group_optimization | Turn on automatic budget optimization for a group. | Yes |
disable_ads_group_optimization | Pause every active member campaign and turn optimization off. | Yes |
control_ad_campaign | Change a live campaign's budget, target, or status. | Yes |
apply_shopee_target_roas | Apply a margin-based target-ROAS recommendation to a campaign. | Yes |
revert_shopee_target_roas | Undo an applied target-ROAS change. | No |
apply_shopee_ads_recommendation | Apply a recommended budget or bid. | Yes |
apply_tiktok_ad_budget | Apply a recommended GMV Max campaign budget. | Yes |
apply_tiktok_target_roas | Apply a recommended GMV Max target ROAS. | Yes |
apply_boost_recommendation | Boost the recommended products in search or ads. | Yes |
pause_ads_group still exists as a deprecated alias of disable_ads_group_optimization. Prefer the latter.
Catalog writes · PAT_CATALOG_WRITE · 36 tools
| Tool | Use | Destructive |
|---|---|---|
apply_shopee_cogs | Write resolved COGS rows for a shop. Changes every profit and margin figure for those products, historical reports included. Run preview_shopee_cogs first. | Yes |
apply_lazada_cogs / apply_tiktok_cogs | The same, per platform. | Yes |
upsert_historical_cogs | Add or amend a dated COGS window. | No |
apply_shopee_stock | Set canonical stock and queue write-back to live listings, including bound listings on other platforms. | Yes |
apply_shopee_product_title | Change a live listing's title. | Yes |
apply_tiktok_product_seo | Apply a TikTok SEO recommendation to a live listing. | Yes |
create_canonical_product | Creates a new live listing on every selected shop using each platform's create-product API, then binds them to one canonical. | Yes |
copy_product_to_shops | Re-creates an existing listing as a new live listing on each target shop, including a different platform. | Yes |
link_canonicals / unlink_canonical / detach_binding | Merge, split, or detach canonical product bindings. | Yes |
set_products_hidden | Hide or unhide products in DataGlass. | No |
create_canonical_product and copy_product_to_shops produce listings buyers can see. Neither is a canonical-row-only operation.
Returns and refunds · PAT_RETURNS_WRITE · 17 tools
Return and refund decisions sit behind their own scope because they move real money and the platform will not reverse them.
| Tool | Use | Destructive |
|---|---|---|
approve_tiktok_return | Approve a return or refund request, committing the buyer's refund. | Yes |
reject_tiktok_return | Reject a return or refund request. | Yes |
approve_tiktok_cancellation / reject_tiktok_cancellation | Decide a buyer cancellation request. | Yes |
confirm_shopee_return | Confirm a Shopee return. | Yes |
offer_shopee_return_solution / dispute_shopee_return | Offer a partial-refund solution or dispute the return. | Yes |
decide_lazada_refund | Decide a Lazada refund. | Yes |
upload_shopee_return_proof | Attach evidence to a return case. | No |
Order actions · PAT_ORDERS_WRITE · 14 tools
| Tool | Use | Destructive |
|---|---|---|
cancel_shopee_order | Cancel a live order. The buyer is notified, the sale is lost, and it counts against fulfilment metrics. There is no un-cancel. | Yes |
handle_shopee_buyer_cancellation | Accept or reject a buyer's cancellation request. | Yes |
split_shopee_order / unsplit_shopee_order | Split or recombine an order for fulfilment. | Yes |
split_tiktok_order | Split a TikTok order. | Yes |
set_shopee_order_note | Attach a seller note to an order. | No |
generate_shopee_fbs_invoices | Generate FBS invoice documents. | No |
Logistics and shipping · PAT_LOGISTICS_WRITE · 14 tools
| Tool | Use | Destructive |
|---|---|---|
ship_tiktok_package | Hand one package to the carrier. The buyer sees the order move to shipped and the delivery clock starts. There is no un-ship. | Yes |
batch_ship_tiktok_packages | The same, for many packages. | Yes |
create_tiktok_packages / combine_tiktok_packages | Create or combine packages before shipping. | Yes |
update_tiktok_package_shipping_info | Amend tracking or carrier details. | Yes |
print_shopee_airway_bills | Generate Shopee AWB documents. | No |
print_shop_shipping_documents | Generate shipping documents for a shop. | No |
Acting on recommendations · PAT_RECOMMENDATION_WRITE · 12 tools
| Tool | Use | Destructive |
|---|---|---|
reject_recommendation | Dismiss a recommendation so it stops surfacing. | No |
pause_recommendation / resume_recommendation | Hold or resume a running Action. | No |
stop_recommendation | Stop a running Action. | Yes |
rollback_recommendation | Revert an applied Action. | Yes |
save_profit_leak_settings | Change profit-leak triage settings. | No |
set_negative_profit_alert_settings | Change negative-profit alert settings. | No |
Inventory writes · PAT_INVENTORY_WRITE · 10 tools
| Tool | Use | Destructive |
|---|---|---|
acknowledge_inventory_alert | Acknowledge a reorder-point alert. | No |
dismiss_inventory_alert | Dismiss an alert. | No |
log_purchase_order | Record an inbound purchase order so it counts against reorder quantities. | No |
apply_purchase_order_upload | Import purchase orders from an upload. | No |
run_inventory_model | Recompute the forecast and reorder plan. | No |
set_shopee_stock_sync | Turn stock write-back to a platform on or off. | Yes |
Ads report authoring · PAT_REPORTS_WRITE · 10 tools
| Tool | Use | Destructive |
|---|---|---|
generate_ads_performance_report | Generate an ads performance report. | No |
open_ads_report_workspace | Open a report workspace for editing. | No |
save_ads_report_section_draft | Save a section draft. | No |
validate_ads_report_workspace | Validate the workspace before publishing. | No |
publish_ads_report_workspace | Publish the finished report. | No |
Capabilities absent from the tool surface
Some things an assistant cannot do at any scope, because DataGlass exposes only mediated writes and these have no mediated path:
- Vouchers, bundle deals, flexi-combo, and free-shipping campaigns. DataGlass can read them and can recommend a bundle-deal grouping, but it cannot create or edit any of them through an agent.
- Raw price, discount, and stock passthroughs.
updatePrice,addDiscount, andupdateStockare not tools. Use the mediated equivalents — a price-tier draft, a target-margin apply, orapply_shopee_stock. - The Shopee price-tier review queue and the campaigns-losing-by-profit-adjusted-ROAS list. Both were withdrawn from the agent surface on 3 August 2026, because membership in either result set is itself the financial signal. Both still work in the app.
Coverage check
| Domain | Scope required | Tools documented |
|---|---|---|
| Foundation and search | — | 3 |
| Shop discovery | — | 4 |
| Unified financial health | — | 2 |
| Products and costs | — | 5 |
| Conversion | — | 3 |
| Orders and fulfilment reads | — | 4 |
| Shopee financials | — | 13 |
| Lazada financials | — | 7 |
| TikTok financials | — | 9 |
| Shopee ads and growth reads | — | 6 |
| TikTok ads reads | — | 4 |
| Recommendation reads | — | 5 |
| Inventory reads | — | 5 |
| Pricing writes | PAT_PRICING_WRITE | 103 |
| Ads writes | PAT_ADS_WRITE | 46 |
| Catalog writes | PAT_CATALOG_WRITE | 36 |
| Returns and refunds | PAT_RETURNS_WRITE | 17 |
| Order actions | PAT_ORDERS_WRITE | 14 |
| Logistics and shipping | PAT_LOGISTICS_WRITE | 14 |
| Acting on recommendations | PAT_RECOMMENDATION_WRITE | 12 |
| Inventory writes | PAT_INVENTORY_WRITE | 10 |
| Ads report authoring | PAT_REPORTS_WRITE | 10 |
| Runtime total | 568 (263 write) |
The read rows above list the tools documented on this page, not every read tool in the runtime surface. The write rows are the full count for each scope.
Runtime schema and drift
Runtime tools/list is authoritative for tool names, field names, required values, behaviour hints, and result schemas. If a documented tool and the runtime schema differ, use the runtime schema and report the documentation drift. Counts on this page were verified against the backend on 25 August 2026 and will grow as new tools ship.