• MONITOR
  • VERIFY
  • ACT
  • HUMAN

How to track and process orders with your AI

Connect Medusa to your AI client to manage store orders through a simple chat interface.

Ask AI about this page

Short answer

How can I track and process orders with my AI?

Your AI pulls order data and shipping info directly from Medusa. You can then tell your agent to capture payments for specific orders manually. This gives you a direct line to your store's backend.

Order management outcomes

Where your orders land.

These are the specific results you get from your AI.

MONITOR

Live order tracking

The AI pulls current order lists so you can see what is pending or shipped. You get real-time visibility into your store's volume.

VERIFY

Shipping detail checks

Your agent looks up specific order details to confirm addresses or tracking numbers. This keeps your data accurate without manual searching.

ACT

Manual payment capture

You can trigger the capture of funds for an order through a text command. This moves the transaction forward immediately.

HUMAN

Manual oversight

The AI handles the data retrieval and triggers, but you decide which orders are ready for payment. You stay in control of the money.

The workflow

What your AI does when an order arrives.

The AI acts as the bridge between your chat interface and the Medusa engine.

  1. Fetch order lists

    The AI scans your Medusa store to find recent or specific orders based on your request.

    list_orders

  2. Inspect order details

    Once you identify an order, the AI pulls the full breakdown including shipping and customer info.

    get_order

  3. Execute payment

    When you confirm everything is correct, the AI tells Medusa to capture the payment.

    capture_payment

  4. Confirm status

    The AI verifies the action was successful by checking the updated order state.

    get_order

Try it

Copy these to start.

Use these prompts to kick off your first task.

Starting points

These are opening lines. Swap the order IDs or names with your actual Medusa data.

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"
    }
  }
}
Copy into chat04

  • Show me the most recent orders from Medusa.

  • Get the details for order #12345.

  • Capture the payment for order #67890.

  • List all orders that are currently pending.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Medusa once, then ask.

Just link your Medusa instance to Vinkius. Your credentials stay encrypted and your AI client gets instant access to the tools.

Connect Medusa to your AI

FAQ

How this task behaves

  • 01

    Can the AI delete orders?

    No. The AI only has tools to list, get, and capture payments. It cannot delete any data from Medusa.

  • 02

    Will the AI capture payments without my permission?

    No. The AI only executes the capture command when you explicitly tell it to do so in the chat.

  • 03

    Can I change shipping addresses through the AI?

    No. There are no tools available to modify order or shipping information.

  • 04

    How does the AI know which order I'm talking about?

    You provide the order ID or use the list tool to identify it, then the AI uses that ID to pull the specific data.

  • 05

    Does the AI handle refunds?

    No. The current toolset is limited to listing, retrieving, and capturing payments.

  • More questions about Medusa? See everything the Medusa Connector can do

Connect MedusaJS to Claude, Cursor, ChatGPT & more