MCP
MCP Tools Reference
Complete list of tool groups and actions available in the Vantemo MCP server.
MCP Tools Reference
The Vantemo MCP server organizes the full API into 11 tool groups. Each group is
a meta-tool that accepts an action parameter to select the specific operation.
How Tool Groups Work
When the AI calls a tool, it provides two parameters:
- action (required): The specific operation to perform (e.g.,
list_products) - params (optional): Parameters for the operation (e.g.,
{ "status": "active" })
AI calls: catalog({ action: "list_products", params: { status: "active", limit: 10 } })
→ MCP server resolves to: GET /v1/admin/shops/{shopId}/products?status=active&limit=10
→ Returns product list as text contentcatalog
Products, categories, collections, tags, and inventory management.
| Action | Method | Description |
|---|---|---|
list_products | GET | List products with pagination, status filter, and search |
get_product | GET | Get full product detail including variants and media |
create_product | POST | Create a new product |
update_product | PATCH | Partial update of product fields |
delete_product | DELETE | Soft-delete a product (requires confirm: true) |
duplicate_product | POST | Create a draft copy of an existing product |
update_product_status | PATCH | Change product status (active/draft/archived) |
get_product_counts | GET | Product counts grouped by status |
upsert_prices | POST | Set multi-currency prices for a product |
list_categories | GET | List all categories (flat or tree format) |
get_category | GET | Get a single category |
create_category | POST | Create a new category |
update_category | PATCH | Update category name, slug, or parent |
delete_category | DELETE | Delete a category (requires confirm: true) |
list_collections | GET | List product collections |
get_collection | GET | Get collection detail with rules or products |
create_collection | POST | Create a manual or automated collection |
update_collection | PATCH | Update collection details or rules |
delete_collection | DELETE | Delete a collection (requires confirm: true) |
set_collection_products | PUT | Replace products in a manual collection |
list_tags | GET | List product tags with usage counts |
create_tag | POST | Create a new tag |
update_tag | PATCH | Rename a tag |
delete_tag | DELETE | Delete a tag (requires confirm: true) |
list_inventory | GET | List inventory with stock status filter |
get_inventory | GET | Get inventory details for a product |
update_inventory | PATCH | Update inventory settings (tracking, backorder) |
adjust_stock | POST | Adjust stock quantity with audit trail |
orders
Order lifecycle management including fulfillment, tracking, abandoned carts, and subscriptions.
| Action | Method | Description |
|---|---|---|
list_orders | GET | List orders with status filter and pagination |
get_order | GET | Full order detail with line items and addresses |
update_order_status | PATCH | Transition order status (e.g., paid → shipped) |
update_tracking | PATCH | Set tracking number and carrier |
list_abandoned_carts | GET | List abandoned carts with recovery status |
get_abandoned_cart_stats | GET | Aggregate abandoned cart metrics |
list_subscriptions | GET | List recurring subscriptions |
get_subscription | GET | Subscription detail with payment history |
cancel_subscription | POST | Cancel a subscription (requires confirm: true) |
customers
Customer profiles, CRM notes, and order history.
| Action | Method | Description |
|---|---|---|
list_customers | GET | List customers with search by name or email |
get_customer | GET | Customer profile with order stats and spend |
list_customer_orders | GET | A customer's order history |
list_customer_notes | GET | Internal CRM notes for a customer |
add_customer_note | POST | Add an internal CRM note |
cart_checkout
Shopping cart and checkout operations (storefront API).
| Action | Method | Description |
|---|---|---|
create_cart | POST | Create a new shopping cart |
get_cart | GET | Get cart contents |
add_cart_item | POST | Add an item to a cart |
update_cart_item | PATCH | Update item quantity |
remove_cart_item | DELETE | Remove an item from cart |
apply_coupon | POST | Apply a coupon code to cart |
remove_coupon | DELETE | Remove coupon from cart |
create_checkout | POST | Initiate checkout from cart |
content
Blog posts, pages, navigation menus, reviews, and testimonials.
| Action | Method | Description |
|---|---|---|
list_blog_posts | GET | List blog posts with status filter |
get_blog_post | GET | Get full blog post content |
create_blog_post | POST | Create a new blog post |
update_blog_post | PATCH | Update blog post content or status |
delete_blog_post | DELETE | Delete a blog post (requires confirm: true) |
list_pages | GET | List CMS pages |
get_page | GET | Get page content |
create_page | POST | Create a new page |
update_page | PATCH | Update page content |
delete_page | DELETE | Delete a page (requires confirm: true) |
list_menus | GET | List navigation menus |
get_menu | GET | Get menu with items |
create_menu | POST | Create a navigation menu |
update_menu | PATCH | Update menu name or items |
delete_menu | DELETE | Delete a menu (requires confirm: true) |
list_reviews | GET | List product reviews |
update_review_status | PATCH | Approve or reject a review |
list_testimonials | GET | List testimonials |
update_testimonial_status | PATCH | Update testimonial visibility |
marketing
Email campaigns, coupons, and email settings.
| Action | Method | Description |
|---|---|---|
list_campaigns | GET | List email campaigns with status filter |
get_campaign | GET | Get campaign detail with content |
create_campaign | POST | Create a new email campaign |
update_campaign | PATCH | Update campaign content or schedule |
delete_campaign | DELETE | Delete a campaign (requires confirm: true) |
list_coupons | GET | List discount coupons |
get_coupon | GET | Get coupon detail |
create_coupon | POST | Create a new coupon |
update_coupon | PATCH | Update coupon rules or limits |
delete_coupon | DELETE | Delete a coupon (requires confirm: true) |
list_email_templates | GET | List email templates |
get_email_settings | GET | Get email provider settings |
update_email_settings | PATCH | Update email settings |
analytics
Business intelligence and reporting. All actions are read-only.
| Action | Method | Description |
|---|---|---|
overview | GET | Dashboard KPIs: revenue, orders, AOV, conversion rate |
revenue | GET | Revenue time series by day/week/month |
top_products | GET | Best-selling products by revenue |
customer_metrics | GET | New vs returning customers, retention, LTV |
geographic | GET | Revenue breakdown by country |
funnel | GET | Checkout funnel conversion steps |
order_status | GET | Order distribution by status |
category_revenue | GET | Revenue breakdown by category |
ad_spend | GET | Ad spend, ROAS, clicks by platform |
All analytics actions accept a period parameter: 7d, 30d, 90d, or 12m.
store_config
Store settings, payment/shipping providers, domains, and themes.
| Action | Method | Description |
|---|---|---|
get_shop | GET | Get shop settings and configuration |
update_shop | PATCH | Update shop name, locale, currency, etc. |
list_providers | GET | List configured payment/shipping providers |
list_domains | GET | List connected domains |
list_themes | GET | Browse available themes |
get_theme | GET | Get theme details |
media
Image upload and product gallery management.
| Action | Method | Description |
|---|---|---|
list_media | GET | List media library assets |
get_media | GET | Get media asset details |
delete_media | DELETE | Delete a media asset (requires confirm: true) |
list_product_media | GET | List images attached to a product |
attach_product_media | POST | Attach media to a product gallery |
detach_product_media | DELETE | Remove media from product gallery |
reorder_product_media | PATCH | Set product gallery image order |
shipping
Shipping zones and rates configuration.
| Action | Method | Description |
|---|---|---|
list_shipping_zones | GET | List shipping zones |
get_shipping_zone | GET | Get zone detail with countries |
create_shipping_zone | POST | Create a shipping zone |
update_shipping_zone | PATCH | Update zone settings |
delete_shipping_zone | DELETE | Delete a zone (requires confirm: true) |
list_shipping_rates | GET | List shipping rates |
docs
Search Vantemo documentation and API reference.
| Action | Method | Description |
|---|---|---|
search_docs | GET | Search documentation for guides and help |
get_api_reference | GET | Fetch the full API reference |
list_endpoints | GET | List all available API endpoints |
Destructive Action Safety
Actions marked as destructive (DELETE operations, subscription cancellations) require
confirm: true in the params to execute. Without it, the MCP server returns a warning
message asking the AI to confirm with the user first.
# Without confirmation — returns warning
catalog({ action: "delete_product", params: { productId: "..." } })
→ "The action 'catalog.delete_product' is destructive..."
# With confirmation — executes the delete
catalog({ action: "delete_product", params: { productId: "...", confirm: true } })
→ { success: true }Next Steps
- MCP Server Overview — Architecture and setup
- MCP Setup — Client-specific configuration