MedusaJS Connector for AI agents.

Q: Can I capture a payment for an authorized order using my agent?

Yes. Use the capturepayment 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.

Q: How do I check the tax rates and currencies for a specific region?

The listregions 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.

10 live capabilities

Manage your headless commerce catalog and orders through natural conversation.

Live agent request MedusaJS / Connector

Waiting for input…

AI Agent

Why people use MedusaJS

Medusa Headless E-commerce Engine: Stop Manual Order Auditing

With this Connector, you just ask your agent for the details of order #123. It pulls the shipping address, line items, and payment status instantly, giving you the answer in seconds.

What Vinkius changes

You get a conversational interface for your entire MedusaJS commerce backend.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

The 'Where's my stuff?' query

A customer asks about a specific order.
Real-world use case 02

Bulk inventory audit

A developer needs to check variant mappings.
Real-world use case 03

Manual payment processing

An admin needs to capture a held payment.

Complete set · 10capabilities

The complete MedusaJS capability set.

These are the exact actions your AI can choose when you ask it to work with MedusaJS.

Capability set01 / 03

01—04

4 capabilities in this set.

Part of 10 available through MedusaJS.

01 Capability
List collections
See all your product collections and how your store is organized. Use this to verify your store taxonomies.
02 Capability
List customers
View your entire list of registered customers in your CRM. It helps you audit your customer directory quickly.
03 Capability
Get customer
Pull up a specific customer profile using their unique ID. This gives you a deep dive into a single user's history.
04 Capability
Get order
See full order details including line items, shipping addresses, and payment status. It's the fastest way to check a specific order.

Capability set02 / 03

05—07

3 capabilities in this set.

Part of 10 available through MedusaJS.

05 Capability
Get product
Get complete product info like variants, options, and pricing. Use this to verify specific SKU-level data.
06 Capability
List orders
Bring up a list of all recent commerce orders. It's perfect for monitoring daily order flows.
07 Capability
List products
See every product currently listed in your Medusa store. Use this to get a high-level view of your catalog.

Capability set03 / 03

08—10

3 capabilities in this set.

Part of 10 available through MedusaJS.

08 Capability
List regions
Check localized tax rates, currencies, and payment providers for different areas. This is vital for cross-border commerce.
09 Capability
Get store config
Pull store-level metadata like base URLs and default regions. This helps you verify your core store settings.
10 Capability
Capture payment
Manually capture funds for an order to move them into your processing pipeline. This is useful for finalizing authorized payments.

Set up in minutes

One URL. Then ask MedusaJS to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use MedusaJS from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it MedusaJS, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable MedusaJS for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the MedusaJS URL.
Step 03

Save and start

Save the connection and enable MedusaJS in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "medusa-headless-e-commerce-engine": {
      "url": "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using MedusaJS

Open Agent mode in chat and ask: "Using MedusaJS, help me...". 10 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "medusa-headless-e-commerce-engine": {
      "url": "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using MedusaJS

Ask Copilot: "Using MedusaJS, help me...". 10 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "medusa-headless-e-commerce-engine": {
      "url": "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using MedusaJS

Open Cascade and ask: "Using MedusaJS, help me...". 10 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "medusa-headless-e-commerce-engine": {
      "url": "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using MedusaJS

Ask Cline: "Using MedusaJS, help me...". 10 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add medusa-headless-e-commerce-engine --transport http "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using MedusaJS

Ask Claude: "Using MedusaJS, show me...". 10 tools are ready

Where the request belongs

Work MedusaJS can move forward.

Built around the request

This is for the e-commerce operations lead who's tired of manual data exports and the headless developer who needs to audit variant mappings without constantly hitting the API manually.

E-commerce Operations Manager

Auditing customer profiles and regional tax logic across multiple regions during peak seasons.

Headless Developer

Verifying product variant mappings and API responses directly from the workspace for rapid debugging.

Store Administrator

Capturing authorized payments and managing collection hierarchies to maintain high-performance commerce operations.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Megaventory

Inventory and order management via Megaventory. track products, stock levels, and orders.

View Connector

02 10 capabilities

OpenCart

Connect your OpenCart store to AI agents. browse products, manage orders, track customers, and update fulfillment status through natural conversation.

View Connector

03 10 capabilities

Saleor

Connect your AI to your headless Saleor e-commerce store. Seamlessly manage products, audit recent orders, and assist customers natively through your chat.

View Connector

04 12 capabilities

Fieldfolio

Connect Fieldfolio to automate wholesale management. manage products, orders, and inventory directly from your AI agent.

View Connector

05 10 capabilities

Commerce.js

Manage your e-commerce store via Commerce.js. list products, manage carts, and handle orders directly from any AI agent.

View Connector

06 10 capabilities

Magento (Adobe Commerce)

Manage e-commerce via Magento (Adobe Commerce). search products, track orders, and audit customer data.

View Connector

Bring your own AI

Change the model, client or framework. Keep MedusaJS connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about MedusaJS.

The practical details behind the request, access and result.

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

One connection away

Give your agent a direct line to MedusaJS.

Connect MedusaJS once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Medusa Headless E-commerce Engine: Stop Manual Order Auditing

You get a conversational interface for your entire MedusaJS commerce backend.

The 'Where's my stuff?' query

Bulk inventory audit

Manual payment processing

List collections

List customers

Get customer

Get order

Get product

List orders

List products

List regions

Get store config

Capture payment

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using MedusaJS

Create MCP config

Add the server config

Enable Agent mode

Start using MedusaJS

Open MCP Settings

Add the server

Save and reload

Start using MedusaJS

Open Cline MCP Settings

Add remote server

Enable the server

Start using MedusaJS

Install Claude Code

Add the Connector

Verify the connection

Start using MedusaJS

E-commerce Operations Manager

Headless Developer

Store Administrator

Megaventory

OpenCart

Saleor

Fieldfolio

Commerce.js

Magento (Adobe Commerce)

Give your agent a direct line to MedusaJS.