commercetools MCP. Fetch order status or inspect product data via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
commercetools connects your agent directly to a composable e-commerce backend. It lets you manage product catalogs, retrieve detailed order records, and access customer profiles using natural conversation—no API keys or UI clicks needed for routine data lookups.
What your AI agents can do
Get order
Retrieves the full, detailed information for one specific order.
Get product
Gets the complete details for a single product using its unique identifier.
Get project settings
Pulls general configuration data for the entire commerce project.
You can retrieve specific product data using its unique key or list all available products in the catalog.
The server allows you to list recent orders, search by order number, or get full details on a single transaction.
You can retrieve lists of available product categories, helping map out the entire catalog structure.
The tool retrieves a list of customers in your system, giving you access to core profile data.
You get general settings for the current commerce tools project, including supported currencies and languages.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
commercetools MCP Server: 10 Tools for Commerce Data Access
These tools allow your agent to interact with every core component of a commerce engine—from listing products to retrieving detailed order histories.
019d7578get order
Retrieves the full, detailed information for one specific order.
019d7578get product
Gets the complete details for a single product using its unique identifier.
019d7578get project settings
Pulls general configuration data for the entire commerce project.
019d7578list active carts
Retrieves a list of all currently active shopping carts in the system.
019d7578list categories
Gets an enumeration of every product category available in your store.
019d7578list customers
Pulls a complete list of customer records from the commerce backend.
019d7578list orders
Retrieves a paginated list of recent orders placed through the system.
019d7578list products
Fetches a general list of all products in your catalog.
019d7578search orders by number
Finds and retrieves details for an order using its specific external order number.
019d7578search product by key
Retrieves a product's full details by matching its unique, internal key.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with commercetools, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You connect your agent directly to a composable e-commerce backend. It lets you manage product catalogs, retrieve detailed order records, and access customer profiles using natural conversation—you don't need API keys or clicking through UIs for routine lookups.
Catalog Management: When you need info on what you sell, the system gives you several ways to dig into your catalog. You can run list_products to get a general list of everything available in your store. If you know a product's unique key, you use search_product_by_key for its full details; otherwise, get_product takes that specific identifier and returns the complete data set.
You can also map out your entire catalog structure by running list_categories, which gives you an enumeration of every product category available. For tracking customer buying habits in real-time, the server lets you view all current carts using list_active_carts.
Order & Transaction History: Checking on orders is straightforward. You can run list_orders to pull a paginated list of recent transactions that went through the system. If you only know an external order number, search_orders_by_number finds and returns those specific details for you. To get every single piece of data associated with one completed transaction, you use get_order, which pulls the full record for a singular order.
Customer Data: You've got access to core profile information too. The tool that runs list_customers pulls a complete list of customer records from the commerce backend, giving your agent immediate access to account details and profiles.
Project Configuration: Before you get deep into transactions, you might need to know what the system is running on. You can pull general setup information for the whole project by invoking get_project_settings. This gives you key operational data like supported currencies and languages that govern how all other tools behave.
How commercetools MCP Works
- 1 Subscribe to this server and input your commercetools Client ID and Secret (or API client token).
- 2 Your AI agent connects using those credentials, establishing a direct link to the commerce backend.
- 3 You prompt your agent with natural language queries (e.g., 'What is the status of order #123?') and it executes the necessary tool calls.
The bottom line is that you talk to your AI agent, and it handles all the API routing and data fetching from your commerce system.
Who Is commercetools MCP For?
E-commerce Managers need this when they're tired of hopping between dashboards just to verify a product count or an order status. Backend Developers use it constantly instead of writing tedious cURL scripts for every API endpoint test case. Support Agents rely on it to instantly pull up customer and order details, cutting down resolution time from minutes to seconds.
Uses the agent to quickly verify order statuses or retrieve specific customer profiles based only on an order number.
Checks product availability across categories using conversational prompts, eliminating manual catalog spreadsheet checks.
Inspects API responses and schema details via chat instead of running multiple Postman collections or writing complex scripts.
What Changes When You Connect
- Check any order's full details using
get_order. You don't have to manually input IDs into a form; just ask your agent. - Quickly see all available products and their categories by calling
list_productsorlist_categories, giving you instant catalog visibility. - Need customer data? Use
list_customersto pull up profiles immediately. It's faster than searching through a dashboard UI. - Testing product logic is easy with
get_product. You get the full schema details right in your chat window, perfect for development testing. - Track sales volume using
list_ordersorsearch_orders_by_number, allowing you to monitor revenue trends without hitting the web UI.
Real-World Use Cases
Support agent needs to check a returned order's status.
A customer calls about an order. Instead of asking the manager for access, the support agent just prompts their AI client: 'What is the current status of Order #12345?'. The agent runs search_orders_by_number and spits out the status (e.g., Shipped/Returned) instantly.
Developer needs to validate a new product's API schema.
A developer doesn't want to open Postman five times. They prompt: 'Show me all details for the Running Sneakers product.' The agent calls get_product and returns the full, structured JSON data directly in the IDE chat.
Manager needs a list of top-selling product types.
The manager asks: 'List all available categories so I can check for missing lines.' The agent calls list_categories, providing an immediate, structured overview that helps them plan inventory buys.
Team needs to audit the entire user base.
The team lead asks: 'List all customers who signed up last month.' The agent executes list_customers and returns the list, allowing the team to cross-reference account data without manual database queries.
The Tradeoffs
Treating it like a general search bar.
Asking: 'Show me some product stuff and order details.' The agent fails because the request is too vague for specific tool calls.
→
Be direct. Ask, 'What are the total active carts?' (uses list_active_carts), or, 'Find the full details of Order #9876' (uses get_order). Specificity matters.
Assuming data is available without a key.
Asking: 'Get the jeans product.' The agent can't find it because products need their unique identifier, not just a name.
→
Use search_product_by_key and provide the exact unique key. This tool guarantees precision when retrieving specific items.
Trying to process transactions.
Asking: 'Mark this order as paid.' The tools are for reading data, not changing state or processing payments.
→
This server reads data. Use it to verify the status (e.g., get_order) before you run a separate payment system tool.
When It Fits, When It Doesn't
Use this MCP Server if your primary need is reading, listing, or inspecting existing e-commerce data—product catalogs, order history, or customer records. It's ideal for support tools, reporting scripts, and development testing because it centralizes all the read access points (get_order, list_products, etc.) into conversational calls.
Don't use this if you need to perform complex multi-step transactions (like processing a refund that touches inventory AND payments) or interact with external payment gateways. For those jobs, you need dedicated write/transaction tools. If your goal is simply 'Show me what was,' this server is built for it.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by commercetools. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding product status shouldn't require jumping between UIs and Postman tabs.
Right now, checking a simple order status means logging into the Merchant Center, finding the Order ID, navigating to the right tab, waiting for the page to load, then copying the data. It’s slow, error-prone, and requires context switching.
With this MCP server, you just ask your agent: 'What's the status of order #10452?' The agent runs `get_order` through its backend connection and gives you the exact, clean answer in a chat window. Done.
commercetools MCP Server: Get product data with 'get_product'.
Before this server, getting full product details meant running a cURL script against the API endpoint and pasting the entire JSON response into your terminal. You had to manage headers, keys, and endpoints manually.
Now, you ask for the product by its key, and `get_product` delivers the complete schema data directly to your agent chat. It's instant and requires zero command-line overhead.
Common Questions About commercetools MCP
How do I check if a specific order exists using get_order? +
You must provide the unique ID for the order to use get_order. If the ID is correct, it returns all details; otherwise, it signals an error or 'not found' response.
Can I list products and then get individual product details? +
Yes. You can first call list_products to see the general catalog, then use the unique key from that list with get_product for deeper inspection.
What is the difference between listing and searching orders? +
Use list_orders to get a paginated view of recent sales. Use search_orders_by_number when you have one specific, known order number to check its status directly.
Does list_customers show all customer data? +
Yes, list_customers retrieves a list of records. Your AI agent can then use that context to guide subsequent calls for detailed profiles.
Before I use any tool, like get_product or list_categories, what do I need to know about project authentication? +
You must first subscribe and provide your commercetools Client ID and Secret. The server uses these credentials to authenticate every call, ensuring your AI agent has the necessary access rights for the operation.
If I use search_orders_by_number but the order number is incorrect or doesn't exist, how does the tool handle that error? +
The API returns a standard HTTP 404 Not Found status. Your AI client reads this structured response and reports back to you immediately, letting you know exactly why the search failed.
When I run list_products, can I filter or limit the results by specific attributes, like availability? +
Yes, the underlying API supports filtering parameters. You instruct your agent to pass criteria—for example, 'only active' or 'in stock'—and the tool returns a subset of products matching those conditions.
If I use list_customers repeatedly in a short time frame, are there rate limits I should be aware of? +
Most commercial APIs enforce rate limits. If you make too many calls to list_customers in quick succession, the server will temporarily block subsequent requests until the limit resets.
How do I find my Client ID and Secret? +
You can create API Clients in the commercetools Merchant Center under Settings > Developer Settings > API Clients.
What regions are supported? +
Common regions include us-central1.gcp, eu-central-1.aws, and others. Check your Merchant Center URL to find yours.
Do I need a specific scope? +
This server typically requires 'manage_project' or equivalent read/write permissions to interact with products and orders.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Honeywell Process
Connect Honeywell Process to any AI agent via MCP.
Uber
AI ride management: estimate prices, track trips, and manage locations via agents.
Atlassian Crowd
Equip your AI agent to manage users, groups, and directory memberships via the Atlassian Crowd API.
You might also like
OECD Data API
Access global economic data — audit social and fiscal series via AI.
Scribe
Create step-by-step guides and SOPs automatically by recording your workflow and generating visual documentation instantly.
GetFeedback
Manage online surveys, track real-time responses, and oversee feedback data via AI agents with GetFeedback.