# Coppel MCP for AI Agents AI Agent Connect

> Coppel MCP for AI Agents. Manage Mexico's largest department store and consumer credit ecosystem through your AI agent. Browse the product catalog, manage retail orders, check customer credit limits, and find physical store locations across Mexico.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_f2Fu7RRv2ScrLPN1Ip4KmO7G0nv0xMWpJRiCEkW5/ai-agent-connect
- **Tags:** order-management, product-catalog, consumer-credit, retail-logistics, inventory-management

## Description

Managing retail operations in Mexico's largest department store ecosystem usually means jumping between different internal tabs and spreadsheets. You have to track inventory, handle customer credit inquiries, and manage complex order histories, all while keeping an eye on seasonal promotions. This Connector changes that by bringing all those data points into a single conversation with your AI agent. Instead of hunting for a specific customer's credit limit or looking up a store's hours in a different window, you just ask. You can check a customer's payment history, see if they're eligible for a weekly payment plan, or pull up the details on a specific appliance in seconds. It handles the heavy lifting of navigating the Coppel B2B catalog so you can focus on closing sales and managing your team. By connecting this through Vinkius, you get a direct line into the retail and credit data you need without the friction of manual data entry. It's about getting answers fast so you can keep the business moving.

## Tools

### get_order
Get full details for a specific order. This is useful for checking fulfillment status or payment breakdowns.

### get_product
Get full details for a specific product. Use this to see exact specifications and pricing for any catalog item.

### get_store
Get details for a specific store. This includes the address and operating hours for a retail location.

### list_categories
List all product categories in the Coppel catalog. This helps you understand the full scope of available inventory.

### list_customers
List registered customers in the system. This provides a high-level view of your customer base.

### list_orders
List customer orders filtered by status. You can quickly find pending or delivered orders for your records.

### list_payments
List payments for an order or account. It shows dates, methods, and receipt references for tracking.

### list_products
List products from the Coppel catalog. You can filter by categories like electronics or clothing to browse inventory.

### list_promotions
List active promotions and deals. Use this to see seasonal discounts and interest-free credit offers.

### list_stores
List Coppel physical store locations. You can filter by state to find stores in specific regions like Jalisco.

### search_products
Search products by keyword. This returns matching items with pricing and credit plan availability.

### create_order
Place a new order with specific IDs, quantities, and payment methods. It supports weekly payment plans for eligible customers.

### get_customer_credit
Check a customer's current credit status. This reveals their approved limit and current balance instantly.

### get_customer
Get full details for a specific registered customer. Use this to pull comprehensive account information in one step.

## Prompt Examples

**Prompt:** 
```
Find me some laptops under 10,000 MXN that have weekly payment plans.
```

**Response:** 
```
I found 3 laptops under 10,000 MXN in the Coppel catalog:

| Model | Price | Weekly Plan |
| :--- | :--- | :--- |
| **HP Laptop 15** | $8,500 MXN | $160 x 60 weeks |
| **Acer Swift** | $9,200 MXN | $180 x 60 weeks |
| **Lenovo IdeaPad** | $7,800 MXN | $150 x 60 weeks |

Would you like me to get the full specs on any of these?
```

**Prompt:** 
```
What is the credit status for account #554433?
```

**Response:** 
```
Here is the credit status for customer account **#554433 (Juan Pérez):**

*   **Credit Limit:** $50,000 MXN
*   **Current Balance:** $12,400 MXN
*   **Available Credit:** $37,600 MXN
*   **Weekly Payment (Abono Semanal):** $300 MXN
*   **Next Payment Due:** May 12, 2026

They have enough credit for a purchase up to $37,600 MXN.
```

**Prompt:** 
```
Are there any active promotions for furniture right now?
```

**Response:** 
```
I found 2 active promotions for furniture:

1.  **15% off all sofas** (Ends June 30)
2.  **Interest-free credit for 12 months** on all bedroom sets.

Would you like me to search for specific furniture items that qualify for these deals?
```

## Capabilities

### Browse full product catalogs
Search for specific items and view real-time pricing or credit plan availability.

### Manage retail orders
Create new orders and track the fulfillment status of existing ones.

### Query customer credit
Check approved limits, current balances, and payment histories for customers.

### Locate physical stores
Find addresses and operating hours for over 1,700 locations across Mexico.

### Track payment history
View payment dates, methods, and receipt references for any account.

### Access seasonal promotions
Pull active deals like Buen Fin or Hot Sale discounts instantly.

## Use Cases

### Verifying a customer's credit for a large purchase
A sales rep asks the agent to check the credit status for account #7890123. The agent uses get_customer_credit to confirm the customer has a $32,650 MXN limit available.

### Finding the nearest store in a specific state
A customer wants to know where to go in Jalisco. The rep asks the agent to list_stores for Jalisco to get the nearest address and hours.

### Checking stock for seasonal electronics
A manager asks the agent to search_products for Samsung TVs under $15,000 MXN to see what's available for the Buen Fin sale.

### Auditing pending orders from last week
An operations lead asks the agent to list_orders filtered by pending status to see what still needs to be fulfilled.

## Benefits

- Speed up sales by checking customer credit limits instantly with get_customer_credit.
- Reduce order errors by using create_order to specify exact quantities and payment methods.
- Save time on inventory lookups by using search_products to find items by keyword.
- Improve customer service by using list_stores to give accurate location details to shoppers.
- Stay on top of marketing goals by pulling active deals with list_promotions.
- Simplify payment tracking by viewing history and receipt references via list_payments.

## How It Works

The bottom line is that it turns a complex retail backend into a simple chat interface.

1. Subscribe to the Coppel MCP through the Vinkius marketplace.
2. Enter your Coppel API Key and Secret in your AI client settings.
3. Start asking your agent to check credit status, find products, or list orders.

## Frequently Asked Questions

**How can I use the Coppel MCP to manage store inventory?**
You can ask your agent to search for specific items, browse categories, or check product details. This lets you see what's in stock and at what price without opening a separate inventory tool.

**Can the Coppel MCP check customer credit limits for me?**
Yes, it can pull real-time credit information for registered customers. You can see their approved limits, current balances, and weekly payment amounts in seconds.

**How do I find physical Coppel locations using this Connector?**
You can ask your agent to list stores in a specific Mexican state. It will return the addresses, operating hours, and available services for those locations.

**Can I create new orders through the Coppel MCP?**
Yes, your agent can create new orders by specifying product IDs, quantities, and delivery details. It also supports selecting weekly payment plans for eligible customers.

**Does the Coppel MCP show active seasonal promotions?**
It can pull all current deals, including seasonal events like Buen Fin. You can ask about specific categories or general discounts across the store.

**How does the Coppel MCP help with weekly payment plans?**
It allows your agent to identify which products qualify for weekly payments and what the specific installment amounts are, making it easier to explain options to customers.

**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.