ecomone MCP tool catalog
91 tools in 18 groups. tools/list only returns the tools your connection's scopes allow; the full input schema of each tool comes from tools/list.
Discovery, rules & setup#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_capabilities | Lists, per area, whether this connection can read/edit the shop; with several shops and no shop given, lists the shops (slug, plan status). | shop:read | read |
list_shops | Lists the shops this connection covers; use the slug as the shop argument. | shop:read | read |
get_shop_readiness | Checks whether the shop is ready to launch (start checklist). | shop:read | read |
list_ai_changes | Lists the most recent write actions made through the MCP connector, newest first; filterable by period and tool. | shop:read | read |
einrichten | Shop setup plan: propose a stored plan, execute it exactly after one merchant confirmation, or read progress. Plan valid 24 h; never publishes. | settings:write | live |
get_recipe | Returns the detailed rulebook for an area (build, popups, email, campaign, growth, service, setup); meant to be called before the first write in that area. | shop:read | read |
check | Checks an area and reports findings: campaign, design, product, email_flow, shipping, tracking, domain. | shop:read | read |
Storefront building (theme, pages, sections, publishing)#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
list_pages | Lists the shop's pages and the sections (with ids) on each page. | shop:read | read |
inspect_section | Shows all settings of a section as exact paths with current values. | shop:read | read |
get_section_schema | Returns the available setting paths, block lists and block types of a section type. | shop:read | read |
create_page | Creates a new page (e.g. About, FAQ), optionally with section types. Draft. | pages:write | draft / write |
set_section_visibility | Hides or shows a section (like the eye icon in the editor). Draft. | sections:write | draft / write |
set_shop_logo | Sets the shop logo (draft for the storefront; checkout and order pages use it immediately). | theme:write | draft / write |
list_drafts | Lists named theme drafts with name and modification date and which one is open. | shop:read | read |
publish_shop | Publishes the current draft to all visitors. Live immediately. | shop:publish | live |
set_storefront_password | Enables or disables password protection of the live shop. Live immediately. | shop:publish | live |
acknowledge_commerce_hint | Acknowledges a pre-publish commerce check hint so it no longer blocks/appears before publishing. | shop:publish | live |
list_layout_sections | Lists header, announcement bar, footer and cart drawer with section id, type and short content. | shop:read | read |
set_announcement_bar | Creates or removes the announcement bar above the header. Draft. | sections:write | draft / write |
look_at | Takes a screenshot of a page or of the signed pop-up preview. | shop:read | draft / write |
manage_draft | Creates, switches to, renames or deletes theme drafts. | theme:write | draft / write |
manage_section | Adds, deletes, reorders sections and edits their settings, content and blocks. Draft. | sections:write | draft / write |
manage_theme | Reads the theme draft (aktion: get; global custom CSS and head HTML stay hidden) or changes theme typography, colors/palette, fonts, buttons/spacing, favicon, navigation, social links and language selector. Draft. | theme:write | draft / write |
Media library#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
list_media | Lists images in the merchant's media library (URL, name, width, height, folder). | shop:read | read |
import_media_from_url | Imports an image (PNG/JPEG/WebP/GIF/AVIF, max 10 MB) or video (MP4/MOV/WebM, max 200 MB, 3 min) from an https URL into the media library. | sections:write | draft / write |
generate_media_image | Generates an AI image into the media library. Costs 1 credit; only with explicit merchant consent. | sections:write | draft / write |
Products, bundles & collections#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
generate_product_images | Generates product images with AI Studio. Costs 1 credit per image; only with explicit merchant consent. | products:write | live |
get_image_run | Reads (and advances) the status of a generate_product_images run. | products:write | live |
list_bundles | Lists quantity offers/bundles (tiered prices), optionally for one product. | shop:read | read |
set_product_shipping | Sets per-product shipping; requires bestaetigt_vom_haendler=true, otherwise returns a summary to confirm. Live at checkout. | products:write | live |
archive_product | Archives a product (or restores it) instead of deleting it. Live immediately. | products:write | live |
bulk_update_products | Updates up to 100 products in one call (SKU, barcode, category, vendor, tags, handle, active, costs, weight, origin...). Live immediately. | products:write | live |
products | Lists products; with id/handle returns one product's details. | products:read | read |
collections | Lists collections; with id returns one collection. | collections:read | read |
manage_product | Creates or updates products, private digital files and add-on rules. Live immediately. | products:write | live |
manage_collection | Creates or updates a collection. Live immediately. | collections:write | live |
manage_bundle | Creates or updates a quantity offer/bundle. Live immediately. | products:write | live |
Inventory#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_inventory | Stock per product/variant; max 50 per call (default 20), paginated with cursor. | inventory:read | read |
set_inventory | Sets stock of a product or of individual variants; optionally toggles inventory tracking. | inventory:write | draft / write |
Orders & invoices#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_order_journey | Shows where an order came from (source, pages visited before purchase). | orders:read | read |
fulfill_order | Sets fulfillment status and tracking data of an order; can send the shipping confirmation. | orders:fulfillment | draft / write |
set_order_note | Appends an internal note (never shown to the customer; marked [KI]). | orders:notes | draft / write |
cancel_order | Cancels an order like the order page does; paid orders are refunded via Stripe (full by default, partial via erstattung_cents). | orders:cancel | live |
refund_order | Refunds an amount or individual line items via Stripe; never more than was paid. | orders:refund | live |
get_invoice | Invoices and credit notes of an order with number, amount, approval state and a link to the PDF. | orders:read | read |
create_invoice | Issues the invoice of an order (assigns the number); unapproved invoices stay drafts. Sends nothing. | orders:edit | draft / write |
export_accounting | Exports the invoices and credit notes issued in a date range (from/to, YYYY-MM-DD) as accounting CSV, like GET /invoices/accounting. Needs billing permission; changes no documents. | orders:read | read |
resend_order_email | Re-sends the order or shipping confirmation to the customer; requires bestaetigt_vom_haendler=true. | orders:fulfillment | draft / write |
orders | Lists orders; with id returns one order. | orders:read | read |
Customers#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
customers | Lists customers; with id returns one customer. | customers:read | read |
Discounts#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
discounts | Lists discount codes; with id returns one code. | discounts:read | read |
manage_discount | Creates or updates a discount code. Live immediately. | discounts:write | live |
Reviews#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
list_reviews | Lists reviews, filterable by status, product and stars. | reviews:read | read |
manage_review | Approves/hides, replies to or imports reviews, or changes review settings. Live immediately. | reviews:write | live |
Analytics#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_revenue | Revenue totals and time series per day/week/month (default last 30 days), in minor units. | revenue:read | read |
get_ads_performance | Per campaign/ad set/ad: spend (if Meta is connected), visitors, funnel, orders, revenue, contribution margin, ROAS, POAS, BEROAS, CPA, margin, plus Meta-reported purchases. | reports:read | read |
Pop-ups#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
set_popup_status | Sets a pop-up to active, paused or draft. Activating is live immediately. | popups:write | live |
get_popup_stats | Impressions, interactions, wins, contacts, orders, revenue and rates for a period (default 30 days). | popups:read | read |
list_popup_leads | Contacts collected by pop-ups (newest first): e-mail, date, pop-up, code, redeemed, consent; max 50 per call. | popups:read | read |
popups | Lists pop-ups; with id returns one pop-up. | popups:read | read |
manage_popup | Creates or updates a pop-up (always as draft; go live via set_popup_status). | popups:write | live |
E-mail marketing (flows, designs, segments, campaigns)#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
marketing | Segments (create/update/delete/count) and campaigns/series (create, schedule, pause, cancel, delete unsent), test send and statistics. Required scope depends on the action. | marketing:read | draft / write |
email_flows | Lists e-mail flows; with id returns one flow. | marketing:read | read |
email_designs | Lists e-mail designs; with id returns one design. | marketing:read | read |
preview_email | Renders a preview of a flow e-mail or an order e-mail. | marketing:read | draft / write |
send_test_email | Sends a test e-mail, only to the person who created the key/connection, never to customers. | marketing:send | draft / write |
manage_email_flow | Creates, updates, activates or pauses an e-mail flow. | marketing:write | draft / write |
manage_email_design | Creates or updates an e-mail design. | marketing:write | draft / write |
Order e-mails & sender domain#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
setup_sender_domain | Creates the sender domain for shop e-mails and returns the DNS records (SPF, DKIM, Return-Path). | email:write | live |
verify_sender_domain | Verifies the sender domain and shows the state of each DNS record. | email:read | read |
set_sender_addresses | Sets sender addresses per purpose (orders, contact, internal) on the verified sender domain. | email:write | live |
update_order_email_template | Changes subject, HTML body, button or active flag of an order e-mail. Live immediately. | email:write | live |
order_email_templates | Lists order e-mail templates; with id (template key) returns one. | email:read | read |
Inbox / customer service#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_support_mode | Merchant's inbox mode, approved categories, remaining daily quota and pause state. | inbox:read | read |
list_snippets | Inbox text snippets (title, shortcut, text). | inbox:read | read |
conversations | Lists inbox conversations; with id returns one conversation. | inbox:read | read |
manage_conversation | Inbox actions: drafts (own text, snippet, AI suggestion, forward), categorise, snooze, labels, spam, send a saved draft (only with merchant approval). | inbox:write | live |
Settings, legal texts & languages#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_legal_pages | Lists imprint, terms, privacy, withdrawal, shipping terms and contact text with fill status. | settings:read | read |
generate_legal_pages | Fills legal text templates from shop, company and market data; overwrites only with ueberschreiben=true. | settings:write | live |
languages | Changes enabled/default storefront languages (with confirmation) and manages the translation glossary. | settings:write | live |
translations | Reads and sets translations, lists gaps, estimates and starts/cancels/resumes translation jobs. | settings:write | live |
get_settings | Reads settings of one area: shop, company, tracking, email (sender), reviews, shipping. | shop:read | read |
update_settings | Changes shop data, company data or a legal text. Live immediately. | settings:write | live |
Markets, taxes & shipping#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
set_shipping | Sets up shipping rates; requires bestaetigt_vom_haendler=true, otherwise returns a summary to confirm. Live at checkout. | shop:write | live |
list_markets | Lists markets with countries, currency, tax settings, rates per country, primary market, status and shipping rates. | markets:read | read |
manage_market | Creates or updates a market; sales-relevant changes require merchant confirmation. | markets:write | live |
Tracking#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
update_tracking_settings | Changes tracking settings (pixels, tracking tier, consent). Live immediately. | tracking:write | live |
Domains#
| Tool | What it does | Scope | Effect |
|---|---|---|---|
get_domains | Connected domains with status, primary domain and required DNS records. | domains:read | read |
add_domain | Connects a domain the merchant already owns. | domains:write | live |
buy_domain | Does not buy anything: returns the backend link where the merchant can buy or transfer a domain. | domains:read | read |
manage_domain | Sets the primary domain or removes a domain. Live immediately. | domains:write | live |