ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use MedusaJS with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage headless commerce via MedusaJS. search products, track orders, and audit customer data.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 10 capabilities

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.

  1. 01

    List collections

    List Medusa product collections

  2. 02

    Get order

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

  3. 03

    Get product

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

  4. 04

    Get store config

    Get Medusa store configuration (supported currencies, default region)

Capability set02 / 03

05-07

3 capabilities in this set.

Part of 10 available through MedusaJS.

  1. 05

    List products

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

  2. 06

    List regions

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

  3. 07

    Capture payment

    Capture payment for a Medusa order

Capability set03 / 03

08-10

3 capabilities in this set.

Part of 10 available through MedusaJS.

  1. 08

    Get customer

    Get Medusa customer explicitly by ID

  2. 09

    List customers

    List Medusa CRM customers

  3. 10

    List orders

    List Medusa orders

Observed, not estimated

815ms average. Fast in production.

MedusaJS is checked daily against the live service.

Daily averagePeak 1041ms
Aug 25Today
Fastest day
724ms
Slowest day
1041ms
14-day trend
Improving-16%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of MedusaJS, so you can see the experience inside your AI.

It does not authenticate your account with MedusaJS. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

MedusaJS Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — MedusaJS capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "medusa-headless-e-commerce-engine-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_qUShgPxQYN7u6QZI6bMx41EHHA73PpqdbrpYsGqb/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions MedusaJS owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.