Medusa MCP server

What the model can do

Medusa v2 commerce backend (self-hosted or Medusa Cloud): orders with their items, payments and fulfilments, customers, products and inventory items; can create and update customers, create and convert draft orders, fulfil, ship, cancel, complete and archive orders, capture and refund payments, create, update and delete products, and set stock levels.

Reads

• medusa_list_ordersMedusa orders, newest first: id, order number, status, payment and fulfilment status, email, customer, currency, total…
• medusa_get_orderOne Medusa order: status, payment and fulfilment, email, customer, totals (as Medusa stores them), its line items (id, title, variant, SKU, quantity…
• medusa_list_customersMedusa customers: id, name, email, company, whether they have an account, and dates.
• medusa_list_productsMedusa products: id, title, handle, status (draft, proposed, published, rejected), whether a gift card, and dates.
• medusa_list_inventory_itemsMedusa inventory items: id, SKU, title, whether it ships, and stocked, reserved and available quantities where Medusa includes them.
• medusa_list_paymentsMedusa payments: id, amount and currency, when captured, how much was captured and refunded, and the payment collection.

Acts, when you ask

These change something in Medusa. The model is told to use them only when you ask for exactly that, and each one is granted by name: per team on a shared connection, by the owner on a personal one.

• medusa_create_customerCreates a customer record in Medusa with an email and/or a name and company.
• medusa_create_draft_orderCreates a draft order in Medusa for a customer (by id or email) in a region, with optional items (a product variant and quantity…
• medusa_convert_draft_orderConverts a Medusa draft order into a placed order.
• medusa_create_order_fulfillmentFulfils line items of a Medusa order from a stock location, which reserves and takes the stock.
• medusa_create_order_shipmentMarks a fulfilment of a Medusa order as shipped, with optional tracking labels.
• medusa_cancel_fulfillmentCancels a fulfilment of a Medusa order that has not shipped, returning its stock.
• medusa_cancel_orderCancels a Medusa order.
• medusa_complete_orderMarks a Medusa order completed.
• medusa_archive_orderArchives a Medusa order (it leaves the active order list; Medusa offers no unarchive route).
• medusa_update_orderChanges a Medusa order's email, shipping address or billing address.
• medusa_capture_paymentCaptures an authorised Medusa payment, in full or for an amount (in the units Medusa stores), through the store's payment provider.
• medusa_refund_paymentRefunds a captured Medusa payment, in full or for an amount (in the units Medusa stores), through the store's payment provider.
• medusa_update_customerChanges a Medusa customer's email, first or last name, or company.
• medusa_create_productCreates a Medusa product with a title and optional subtitle, description, handle and collection.
• medusa_update_productChanges a Medusa product's title, subtitle, description, handle, collection or status.
• medusa_delete_productDeletes a Medusa product with its variants.
• medusa_update_inventory_levelSets the stocked and/or incoming quantity of a Medusa inventory item at a stock location, replacing the number there (not adding to it).

Connect it

First connect Medusa on Dashboard → Connections, then add Memtro to your client once. The Medusa tools appear alongside the tools of everything else you have connected; nothing is configured per connector.

claude plugin marketplace add memtro-org/claude-memtro
claude plugin install memtro@memtro --config api_key=sk-memtro-...

{
  "mcpServers": {
    "memtro": {
      "url": "https://platform.memtro.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-memtro-..."
      }
    }
  }
}

{
  "mcp": {
    "memtro": {
      "type": "remote",
      "url": "https://platform.memtro.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk-memtro-..."
      }
    }
  }
}

Who may use it

The key identifies the person, and the server offers that person the tools they may use everywhere else in Memtro. A shared Medusa connection is used by the teams an administrator granted it to, tool by tool, on the Permissions page; a personal connection is used by its owner alone, and its tools that act stay off until the owner allows them. See Teams and permissions and Connectors.

Ask it like this

• › What has Brightwave Ltd ordered from us this quarter?
• › Which orders are paid but not yet fulfilled?
• › How many of the blue hoodie are available in stock?
• › Create a draft order for priya@acme.example with two of the large mugs
• › Refund 20 pounds on Northwind's last order for the damaged mug

Questions

Is this an official Medusa MCP server?

No. It is Memtro's MCP server with Memtro's Medusa connector behind it: the connector reads Medusa through its API with the credentials you connect on Dashboard → Connections, and Medusa publishes nothing here. The same endpoint carries every other system you connect and Memtro's memory tools.

What does it cost?

Nothing on top of Memtro. One price per organisation by its number of users, from $50 a month for up to 10 users after a 7-day free trial, with every connector, the MCP server, jobs and memory included. You bring your own model keys.

Can it change anything in Medusa?

Only when you ask, and only what it has been granted: create a customer record; create a draft order (not sent, charged or placed until someone converts it); convert a draft order into a placed order (permanent); fulfil items of an order (customer notification off unless asked); mark a fulfilment shipped with tracking (customer notification off unless asked); cancel a fulfilment that has not shipped; cancel an order (permanent); mark an order completed; archive an order; change an order's email or shipping or billing address; capture an authorised payment (moves money); refund a captured payment in full or part (moves money); change a customer's name, email or company; create a product (draft unless a status is given); change a product's title, description, handle or status; delete a product (permanent); set the stocked or incoming quantity of an item at a location. Every other tool reads, searches or lists. An administrator grants each acting tool by name per team, and a personal connection acts only after its owner allows it.

Which clients work?

Any MCP client that speaks Streamable HTTP: Claude Code, Cursor, Claude Desktop, OpenCode, Codex, Zed, Windsurf, Cline and the Anthropic and OpenAI SDKs. There is no local process to run; the server is remote and authenticated with your key.

Other MCP servers · Finance and commerce

• Xero MCP server
• Stripe MCP server
• Felloh MCP server
• Wise MCP server
• Starling Bank MCP server
• QuickBooks Online MCP server