Medusa (Headless E-commerce Engine)

Medusa (Headless E-commerce Engine) MCP Connector for Claude

A+

Manage headless commerce via MedusaJS — search products, track orders, and audit customer data.

10 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your MedusaJS store to any AI agent and take full control of your enterprise-grade headless commerce operations, catalog management, and customer CRM through natural conversation.

What you can do

  • Product Orchestration — List and retrieve detailed product metadata by ID, including pricing, SKU-level variants, and media galleries directly from your agent
  • Order Monitoring — List recent commerce orders and retrieve full line-item details, shipping addresses, payment statuses, and fulfillment histories securely
  • Payment Capture — Trigger manual capture actions for authorized orders to move funds from the customer vault into your store's processing pipeline in real-time
  • Customer CRM — Manage your registered customer directory, retrieve detailed profiles, and audit internal flags or default shipping addresses natively
  • Regional Auditing — List configured store regions to understand localized tax rates, currency logic, and enabled payment providers across different geographies
  • Collection Management — Navigate product collections and taxonomies to verify store organization and group-based product distributions efficiently
  • Store Configuration — Extract store-level metadata including base URLs and default region settings to ensure accurate cross-border commerce auditing

How it works

  1. Subscribe to this server
  2. Enter your Medusa Store URL and Admin API Token
  3. Start managing your headless storefront from Claude, Cursor, or any MCP-compatible client

Who is this for?

  • Headless Developers — verify API responses and audit product variant mappings directly from your workspace for rapid debugging
  • E-commerce Managers — monitor order flows and customer profiles across multiple store regions through natural conversation without manual dashboard exports
  • Store Administrators — manage collection hierarchies and capture authorized payments efficiently to maintain high-performance commerce operations
headless-commerceorder-managementproduct-catalogpayment-captureinventory-trackingcustomer-management

10 tools expose this connector's capabilities to your AI agent.

capture_payment

Capture payment for a Medusa order

list_collections

List Medusa product collections

list_customers

List Medusa CRM customers

get_customer

Get Medusa customer explicitly by ID

get_order

Get Medusa order by ID. Returns line items, billing/shipping addresses, payment status, fulfillment status

get_product

Get Medusa product by ID. Returns full details: variants, options, prices

list_orders

List Medusa orders

list_products

List Medusa products. Medusa is a headless open-source commerce engine

list_regions

List Medusa regions (currency, tax rates, payment providers)

get_store_config

Get Medusa store configuration (supported currencies, default region)

See how to talk to your AI agent using Medusa (Headless E-commerce Engine).

List all products in my Medusa store

I've retrieved your product list. Highlights include the 'Classic Tee' (ID: prod-123), 'Cargo Pants' (ID: prod-456), and 'Tech Backpack' (ID: prod-789). Would you like to see the inventory levels for any of these?

Show me the last 5 orders placed today

Retrieving latest orders… I've identified 5 new orders. Highlights: Order #1001 ($45.50, Payment: Captured), Order #1002 ($120.00, Payment: Awaiting), and Order #1003 ($15.99, Status: Fulfilled). Would you like to see the shipping address for the pending order?

Capture the payment for order ID 'order-987'

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

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.

Related Connectors