# Coppel MCP MCP > Coppel MCP connects your AI agent directly to Mexico's largest department store and consumer credit network. Browse electronics, track orders, check customer credit limits, and find local stores across 1,700+ locations instantly. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** order-management, product-catalog, consumer-credit, retail-logistics, inventory-management ## Description Need to manage retail operations for Coppel? This MCP lets your agent talk to the entire system via natural conversation. You can browse millions of products—everything from furniture to electronics—and get real-time pricing data. Need to place an order or check a customer's account status? It handles that too, including credit eligibility and tracking weekly payments. Instead of logging into separate portals for inventory, orders, and finance, your agent does it all in one chat window. This connection gives you the power of the entire Vinkius catalog right where you need it. You can even pinpoint a store's hours or find out which seasonal promotions are running this month. ## Tools ### create_order Places a new order by specifying product IDs, quantities, delivery address, and accepted payment method or weekly installment plan. ### get_customer_credit Checks the full credit status of any customer, including their limits and available funds. ### get_customer Retrieves all current details associated with a specific customer's profile. ### get_order Pulls all detailed information for a single existing order. ### get_product Gets the complete specifications, pricing, and details for one specific product ID. ### get_store Retrieves operational hours, services offered, and location specifics for a single Coppel store. ### list_categories Returns a list of all product categories available in the catalog, helping you narrow your search focus. ### list_customers Lists registered customers based on filters to help identify accounts needing attention or service. ### list_orders Retrieves a list of customer orders, allowing filtering by status like pending or delivered. ### list_payments Shows all payment records for an order or account, including dates, methods (card/cash), and receipt details. ### list_products Lists products across the full catalog by category, useful for broad inventory checks. ### list_promotions Displays all currently active promotions and seasonal deals running through Coppel. ### list_stores Lists physical store locations, letting you filter by a specific Mexican state like 'Jalisco' or 'CDMX'. ### search_products Searches the entire product catalog using keywords to find matching items and their current pricing. ## Prompt Examples **Prompt:** ``` Search for Samsung TVs under $15,000 MXN in the Coppel catalog. ``` **Response:** ``` I found 6 Samsung TVs under $15,000 MXN: 1. Samsung Crystal UHD 43" — $8,999 (weekly: $175 x 60 weeks). 2. Samsung Crystal UHD 50" — $11,499 (weekly: $222 x 60 weeks). 3. Samsung LED 32" — $4,599 (weekly: $89 x 60 weeks). Would you like the full specs on any of these? ``` **Prompt:** ``` Check the credit status for customer account #7890123. ``` **Response:** ``` Customer #7890123 (María González López): Credit limit: $45,000 MXN. Current balance: $12,350 MXN. Available credit: $32,650 MXN. Weekly payment (abono semanal): $285 MXN. Next payment due: April 15, 2026. Payment streak: 24 consecutive on-time payments. Credit rating: A+ (excellent). She has room for a purchase up to $32,650 MXN. ``` **Prompt:** ``` Show me active Buen Fin promotions. ``` **Response:** ``` 3 active Buen Fin promotions found: 1. '20% off all Samsung TVs' (Nov 15-18). 2. '18 months interest-free on Whirlpool appliances' (Nov 15-18). 3. 'Buy 2 get 1 free on Nike shoes' (Nov 15-20). All promotions are stackable with the regular weekly credit plans. Want me to search specific products in these categories? ``` ## Capabilities ### Browse and search the product catalog Find specific items by keyword, category, or price range across electronics, clothing, and appliances. ### Manage customer accounts Pull full details on any registered customer to verify identity or check account status. ### Check consumer credit eligibility Instantly determine a customer's current spending limit, available credit, and payment history with Coppel. ### Place and track orders Create new purchases using specific product IDs, specifying delivery details or weekly installment plans. ### Locate physical stores Search for Coppel branches across Mexico by state or zip code to get hours and services. ## Use Cases ### Customer wants a large TV but doesn't know their credit limit. The agent first uses `get_customer_credit` to check the customer’s available funds. Then, it calls `search_products` for '4K TVs.' Finally, it presents three options that fit within the verified credit limit and suggests an order placement using `create_order`. ### Store Manager needs inventory status before a visit. The manager asks where to find furniture. The agent uses `list_categories` to confirm 'Furniture' is available, then runs `get_product` for the specific SKU number and confirms local availability at the targeted store using `get_store`. ### Financial Analyst needs quarterly payment data. Instead of running a manual report, the analyst prompts for 'all payments for account #123.' The agent uses `list_payments` and can also pull historical order context using `list_orders` to build the full picture. ### Sales Rep needs all product details quickly. A walk-in customer asks about a specific appliance. The rep directs the agent to use `get_product` with the model number, getting instant specs and pricing, which is faster than checking an internal database. ## Benefits - Know a customer's credit status immediately. Instead of having them wait for an agent to check the backend system, you can run `get_customer_credit` right through your chat interface. - Stop browsing product by category. Use `search_products` with keywords (e.g., 'small kitchen appliances') and get relevant results instantly, complete with pricing and credit plan availability. - Never miss a promotion again. Call `list_promotions` to pull up all active sales, like Buen Fin or Hot Sale deals, so your agent can suggest the best current offers. - Streamline store planning by using `list_stores`. You can filter locations by state (like Oaxaca) and get operating hours without visiting the Coppel website. - Process payments seamlessly. After an order is placed using `create_order`, you can quickly check historical records with `list_payments` to confirm payment methods used. ## How It Works The bottom line is: you talk naturally to your agent, and it executes complex business logic across Coppel's entire ecosystem. 1. First, subscribe to the MCP and enter your unique Coppel API Key and Secret credentials. 2. Next, tell your AI agent what you need—for example, 'Check credit for customer X' or 'Find me a blender in CDMX.' 3. The MCP runs the necessary tool calls, gathering all the data points (credit status, product details, store hours) and presenting them back to your conversation. ## Frequently Asked Questions **How do I use the create_order tool with my AI agent?** You specify the product IDs and quantities in a single prompt. The MCP handles the complex sequence of checking inventory, verifying payment eligibility, and submitting the order to Coppel's system. **What is get_customer_credit for?** It checks a customer’s credit status in real time, giving you their current spending limit, available funds, and even their payment streak details. This is crucial before processing any purchase. **Can I find store hours using the list_stores tool?** The `list_stores` tool lets you filter by state (like CDMX). After listing potential stores, you can then use `get_store` to get the exact address and current operating hours. **Is search_products better than list_products?** Yes. `search_products` allows you to target items using natural language keywords (e.g., 'small coffee maker'), while `list_products` is limited to browsing by pre-defined categories. **When I use the get_product tool, what detailed specifications does it provide?** It gives you full details, including real-time pricing and available credit plans. You'll find everything from specs to inventory status in one call. **Does list_payments show all types of transaction records, like cash or card payments?** Yes, it tracks multiple payment sources. The tool shows amounts and dates for weekly installments, store cash payments, and credit/card transactions, complete with receipt references. **What is the required format when I use get_customer to pull up a customer's file?** You must provide a unique identifier (ID) for the specific customer. The system requires this ID to retrieve all associated personal and account details. **How do I use list_orders to filter only for pending or returned shipments?** The tool allows filtering by status, letting you narrow down results quickly. You can search specifically for orders that are 'pending' fulfillment or marked as 'delivered'. **Can I check a customer's weekly payment amount and remaining credit balance?** Yes! Use the `get_customer_credit` tool with the customer's account number. It returns their approved credit limit, current outstanding balance, weekly payment amount (abono semanal), next payment due date, and their on-time payment streak. **Can I find Coppel stores in a specific Mexican state?** Absolutely. Use the `list_stores` tool with the state parameter (e.g., 'Jalisco', 'Nuevo León', 'CDMX'). It returns all branches in that state with addresses, phone numbers, operating hours, and available services like BanCoppel banking. **How do I search for products and see their credit payment plans?** Use the `search_products` tool with a keyword query. Each result includes the cash price, available weekly payment plan options (abonos), number of installments, and total credit cost. Use `get_product` for the full specification sheet of a specific item.