# Mirakl MCP > Mirakl (Enterprise Marketplace Platform) MCP connects your AI agent directly to your marketplace backend. List global product offers, track multi-vendor orders end-to-end, audit seller compliance profiles, and manage complex financial settlements—all without logging into the portal. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** marketplace, inventory-management, vendor-management, offer-orchestration, saas-platform, retail-operations ## Description Your agent can now handle core operations for any large e-commerce platform using Mirakl. Forget jumping between dashboards to get a full picture of your business. You talk to your AI client, and it pulls data from every critical system: you can list specific global offers across multiple sellers, pull the full details on multi-vendor orders, or check fulfillment histories. Need to audit seller performance? You can enumerate all third-party shops and retrieve their compliance profiles instantly. The MCP also tracks accounting invoices and settlements tied to those shops, giving finance teams clear visibility into your financial boundaries. All platform communication, from buyer questions to seller disputes, is available through the message stream, letting you monitor support logs efficiently. Accessing this data via Vinkius means all these capabilities live in one place, ready for your agent to use when you need them. ## Tools ### list_offers Lists all global marketplace offers created by multiple sellers, detailing specific price points. ### get_offer Retrieves deep details about a single explicit Mirakl offer entity and its seller limits. ### list_orders Lists all complex, multi-vendor checkout orders processed through the Mirakl marketplace. ### get_order Gets deep details tracing a specific Marketplace order transaction, including full line items and payment status. ### list_shops Lists all third-party seller accounts (Shops) that are currently active on the platform. ### get_shop Retrieves deep configurations and profiles for a specified Mirakl Seller Shop account. ### list_products Lists nodes from the broad platform product catalog, regardless of specific seller listing. ### list_categories Lists static structural category trees, helping map the overall marketplace taxonomy (e.g., Electronics -> Computers). ### list_messages Retrieves a list of internal communication messages between buyers, sellers, and platform operators. ### list_invoices Lists structural accounting invoices that track financial settlements for seller shops. ## Prompt Examples **Prompt:** ``` List all active seller shops in my Mirakl marketplace ``` **Response:** ``` I've retrieved your list of active shops. Highlights include 'Tech World' (ID: shop-123), 'Home & Garden Pro' (ID: shop-456), and 'Direct Sport' (ID: shop-789). Would you like to see the compliance status or offer count for any of these? ``` **Prompt:** ``` Show me the last 5 invoices generated for seller shops ``` **Response:** ``` Retrieving latest invoices… I've identified 5 recent settlements. Highlights: Invoice #INV-1001 (€1,250 for Shop A), Invoice #INV-1002 (€850 for Shop B), and Invoice #INV-1003 (€45.50). Would you like to see the settlement details for the largest invoice? ``` **Prompt:** ``` Search for messages related to order ID 'order-987' ``` **Response:** ``` Searching communication history… I've found a thread for order 'order-987' between the buyer and the seller. The customer is asking about the delivery timeframe. Would you like me to retrieve the full message content or draft a reply as the operator? ``` ## Capabilities ### Audit global product listings List and retrieve detailed marketplace offers from multiple sellers, including current inventory availability and specific pricing constraints. ### Track multi-vendor transactions Retrieve full line-item details, payment statuses, and fulfillment histories for complex checkout orders involving several vendors. ### Manage seller accounts Get comprehensive lists of third-party shops on the platform along with their detailed operational configurations and compliance records. ### Navigate product taxonomy Explore the entire platform product catalog and navigate the structural category trees to understand market structure. ### Review financial settlements List and audit structural accounting invoices and payments triggered against seller shops for clear financial oversight. ### Monitor platform communication Access full, chronological message threads between buyers, sellers, and internal operators to monitor support interactions. ## Use Cases ### Checking fulfillment status for a large sale. A manager needs to know if an order placed by three different sellers has been paid for and shipped. They ask their agent to `list_orders` for the ID, then use `get_order` to confirm payment statuses and check the combined fulfillment history. ### Verifying a seller's credentials. A compliance officer needs proof that 'Tech World' is still compliant. They ask their agent to run `list_shops`, find the shop ID, and then use `get_shop` immediately to retrieve the latest operational configurations and compliance profiles. ### Resolving a billing dispute. A finance team member needs to confirm payment for last week's sales. They ask their agent to run `list_invoices`, find the relevant settlement, and then use `get_order` details if they suspect a specific transaction was miscounted. ### Mapping product structure. An e-commerce lead wants to know how many different categories exist under 'Electronics' across the whole marketplace. They ask their agent to run `list_categories` and then use `list_products` to see all available nodes in that section. ## Benefits - Track complex transactions instantly. Instead of pulling separate reports for order tracking, use `list_orders` and `get_order` to get full line-item details and payment statuses in one conversational query. - Audit compliance easily. Use the MCP to run through all active sellers with `list_shops`, then check specific seller details using `get_shop` to ensure operational readiness across your platform. - Get financial clarity fast. The ability to call `list_invoices` and audit structural accounting records means finance teams can validate marketplace settlements without accessing the core billing system. - Understand product context. If you need to check inventory or pricing, running `list_offers` provides immediate access to live global listings, far faster than manually searching seller storefronts. - Monitor customer support history. Use `list_messages` to pull up conversation threads instantly, giving operators full context on a buyer's issue without needing the order ID first. ## How It Works The bottom line is you tell your agent what data you need, and it handles the complex API calls to get a coherent answer. 1. Subscribe to this MCP and provide your specific Mirakl Environment URL and API Key. 2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.). 3. Use natural conversation prompts to execute tasks like listing offers or checking order status. ## Frequently Asked Questions **How do I use Mirakl (Enterprise Marketplace Platform) MCP to check inventory?** You run `list_offers` and it pulls the live inventory binding for specific products. This is better than checking a catalog, because it shows which sellers actually have stock right now. **Can Mirakl (Enterprise Marketplace Platform) MCP help with refunds?** Yes, you use `get_order` to view the transaction details and payment statuses. If there's a dispute, you can cross-reference that data with `list_messages` for any communication around the refund request. **Is Mirakl (Enterprise Marketplace Platform) MCP only for active shops?** No. You use `list_shops` to see all accounts, and then you can run `get_shop` to retrieve detailed compliance profiles regardless of their current activity level. **How do I audit my financial records with Mirakl (Enterprise Marketplace Platform) MCP?** Run `list_invoices`. This function retrieves the structural accounting invoices and settlements, giving you a clear overview of your marketplace's financial boundaries.