# Medusa MCP for AI Agents AI Agent Connect

> Medusa (Headless E-commerce Engine) MCP connects your MedusaJS store to your AI agent. It lets you manage your full product catalog, track order statuses, handle customer CRM data, and process payments through a natural conversation. It's built for high-growth headless commerce teams who need to move faster than a standard dashboard allows.

## Overview
- **Category:** loved-by-devs
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/ai-agent-connect
- **Tags:** headless-commerce, order-management, product-catalog, payment-capture, inventory-tracking, customer-management

## Description

Managing a headless commerce stack usually means jumping between multiple tabs and complex API docs just to find a single order status or update a product variant. This Connector changes that by putting your entire MedusaJS backend into your AI client. Instead of digging through a dashboard, you can just ask your agent to pull up recent orders, check specific customer profiles, or list out your regional tax settings. It handles the heavy lifting of navigating your store's architecture so you can focus on high-level operations. Whether you're auditing your product collections or checking store configurations, you get direct access to your commerce data without the friction of manual lookups. You'll find it's a massive time-saver when you're using the Vinkius catalog to quickly spin up new commerce tools. It turns your AI into a functional commerce admin that knows your inventory, your customers, and your order history inside out.

## Tools

### list_collections
See all your product collections and how your store is organized. Use this to verify your store taxonomies.

### list_customers
View your entire list of registered customers in your CRM. It helps you audit your customer directory quickly.

### get_customer
Pull up a specific customer profile using their unique ID. This gives you a deep dive into a single user's history.

### get_order
See full order details including line items, shipping addresses, and payment status. It's the fastest way to check a specific order.

### get_product
Get complete product info like variants, options, and pricing. Use this to verify specific SKU-level data.

### list_orders
Bring up a list of all recent commerce orders. It's perfect for monitoring daily order flows.

### list_products
See every product currently listed in your Medusa store. Use this to get a high-level view of your catalog.

### list_regions
Check localized tax rates, currencies, and payment providers for different areas. This is vital for cross-border commerce.

### get_store_config
Pull store-level metadata like base URLs and default regions. This helps you verify your core store settings.

### capture_payment
Manually capture funds for an order to move them into your processing pipeline. This is useful for finalizing authorized payments.

## Prompt Examples

**Prompt:** 
```
List all products in my Medusa store
```

**Response:** 
```
I've retrieved your product list. Here are some highlights:

| Product Name | ID | Status |
| :--- | :--- | :--- |
| Classic Tee | prod-123 | Active |
| Cargo Pants | prod-456 | Active |
| Tech Backpack | prod-789 | Active |

Would you like to see the inventory levels or variant details for any of these?
```

**Prompt:** 
```
Show me the last 5 orders placed today
```

**Response:** 
```
Retrieving your latest orders... I've identified 5 new orders:

* **Order #1001**: $45.50 (Payment: Captured)
* **Order #1002**: $120.00 (Payment: Awaiting)
* **Order #1003**: $15.99 (Status: Fulfilled)
* **Order #1004**: $89.00 (Status: Pending)
* **Order #1005**: $22.50 (Status: Fulfilled)

Would you like to see the shipping address for the pending order?
```

**Prompt:** 
```
Capture the payment for order ID 'order-987'
```

**Response:** 
```
Executing payment capture... Success. For order 'order-987', the funds have been captured from the customer's payment method. The order status has been updated to **Awaiting Fulfillment** in your Medusa store.
```

## Capabilities

### Pull full product details
Get complete information on products including variants, options, and pricing.

### Track order history
View recent orders with line-item details, shipping addresses, and payment statuses.

### Execute manual payment captures
Trigger payment captures for authorized orders to move funds into your processing pipeline.

### Audit customer profiles
Retrieve and manage registered customer data and internal CRM flags.

### Retrieve regional settings
Check localized tax rates, currencies, and payment providers across different regions.

### Browse product collections
Navigate your store's taxonomies and product groupings efficiently.

### Access store metadata
Extract base URLs and default region settings for commerce auditing.

## Use Cases

### The 'Where's my stuff?' query
A customer asks about a specific order. The manager asks the agent to use get_order to find the shipping address and status instantly.

### Bulk inventory audit
A developer needs to check variant mappings. They ask the agent to use list_products and get_product to find discrepancies in the catalog.

### Manual payment processing
An admin needs to capture a held payment. They ask the agent to use capture_payment for a specific order ID to finalize the transaction.

### Regional tax check
A manager wants to know the tax for a new region. They ask the agent to use list_regions to see the current configuration for that geography.

## Benefits

- Stop jumping between tabs to check order statuses by using get_order to see everything in one place.
- Update your inventory knowledge instantly by pulling full data with get_product and list_products.
- Handle manual payment flows faster by triggering capture_payment directly from your AI client.
- Audit your CRM more efficiently by using list_customers and get_customer to find specific profiles.
- Verify regional settings across different markets using list_regions to ensure correct tax and currency logic.
- Speed up debugging by checking store-level data with get_store_config and list_collections without manual API calls.

## How It Works

The bottom line is you get a conversational interface for your entire MedusaJS commerce backend.

1. Subscribe to the Medusa MCP on Vinkius.
2. Enter your Medusa Store URL and Admin API Token.
3. Start asking your AI client questions about your products, orders, or customers.

## Frequently Asked Questions

**Can the Medusa MCP manage my product catalog?**
Yes, it lets you list all products and view deep details for specific items, including variants and pricing, through your AI agent.

**How do I use the Medusa MCP to see my orders?**
You can ask your agent to list recent orders or pull up a specific order by its ID to see line items and fulfillment status.

**Can I use the Medusa MCP for customer CRM tasks?**
Absolutely. You can use it to list your entire customer directory or pull up a specific profile to audit their history and flags.

**Does the Medusa MCP support regional tax settings?**
Yes, it can retrieve your configured regions, including localized tax rates, currency logic, and enabled payment providers.

**Can I capture payments using the Medusa MCP?**
Yes, it allows you to trigger manual payment captures for authorized orders directly through your AI client.

**How do I connect my MedusaJS store to my AI agent?**
Simply subscribe to the Connector on Vinkius, provide your store URL and Admin API token, and you can start chatting with your commerce data.

**Can I capture a payment for an authorized order using my agent?**
Yes. Use the `capture_payment` tool with a specific Order UUID. Your agent will trigger the action against your payment provider (e.g., Stripe) to finalize the fund transfer for the order immediately.

**How do I check the tax rates and currencies for a specific region?**
The `list_regions` tool retrieves all configured geographical zones in Medusa. Your agent will expose the localized currency logic, tax rates, and enabled payment methods assigned to each region.

**Can my agent retrieve the detailed variants and prices for a product?**
Absolutely. Use the `get_product` tool by providing the Product ID. Your agent will fetch the full object including nested variants, options (size, color), and pricing arrays for all configured regions.