Get started free
All integrations

Medusa Admin integration

Medusa is an open-source commerce platform; this is its Admin API. Manage products with their variants, options, categories, collections, types and tags, run orders end to end including edits, fulfilments, returns, claims, exchanges and refunds, work with draft orders, customers and customer groups, price lists and pricing rules, promotions and campaigns, inventory items and stock locations, regions, tax and shipping, sales channels, publishable API keys, users and invites, workflow executions and file uploads. The host is part of the credential because every install is its own deployment. Authentication is the admin API token sent as HTTP basic (token as username, empty password).

389 toolsBasic authAPI docs

What you can do with Medusa Admin

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Batch, 13 operations

  • POSTbatch_update_inventory_location_levels

    Manage Inventory Levels of Inventory Item.

  • POSTcreate_admin_inventory_item_location_level_batch

    Manage Inventory Levels.

  • POSTcreate_buy_rule_batch

    Manage the Buy Rules of a Promotion.

  • POSTcreate_image_batch

    Manage Images of Product Variant.

  • POSTcreate_image_variant_batch

    Manage Variants of Product Image.

  • POSTcreate_inventory_item_batch

    Manage Variants Inventory in a Product.

  • POSTcreate_option_batch

    Add Options to Product.

  • POSTcreate_price_batch

    Manage Prices in Price List.

  • POSTcreate_product_batch

    Manage Products.

  • POSTcreate_product_variant_batch

    Manage Variants in a Product.

  • POSTcreate_promotion_rule_batch

    Manage a Promotion's Rules.

  • POSTcreate_property_label_batch

    Create Property Label.

  • POSTcreate_setting_batch

    Manage Translation Settings.

Shipping method, 7 operations

  • POSTcreate_claim_inbound_shipping_method

    Add an Inbound Shipping Method to a Claim.

  • POSTcreate_claim_outbound_shipping_method

    Add Outbound Shipping Methods to a Claim.

  • POSTcreate_edit_shipping_method

    Add Shipping Method to Draft Order Edit.

  • POSTcreate_exchange_inbound_shipping_method

    Add an Inbound Shipping Method to an Exchange.

  • POSTcreate_exchange_outbound_shipping_method

    Add Outbound Shipping Method to Exchange.

  • POSTcreate_order_edit_shipping_method

    Add Shipping Method to Order Edit.

  • POSTcreate_return_shipping_method

    Add a Shipping Method to a Return.

Cancel, 6 operations

  • POSTcreate_admin_fulfillment_cancel

    Cancel a Fulfillment.

  • POSTcreate_claim_cancel

    Cancel a Claim.

  • POSTcreate_exchange_cancel

    Cancel an Exchange.

  • POSTcreate_order_cancel

    Cancel Order.

  • POSTcreate_order_fulfillment_cancel

    Cancel Fulfillment.

  • POSTcreate_return_cancel

    Cancel a return.

Item, 6 operations

  • POSTcreate_claim_inbound_item

    Add Inbound Items to a Claim.

  • POSTcreate_claim_outbound_item

    Add Outbound Items to a Claim.

  • POSTcreate_edit_item

    Add Item to Draft Order Edit.

  • POSTcreate_exchange_inbound_item

    Add Inbound Items to an Exchange.

  • POSTcreate_exchange_outbound_item

    Add Outbound Items to Exchange.

  • POSTcreate_order_edit_item

    Add Items to Order Edit.

Confirm, 5 operations

  • POSTconfirm_product_import

    Confirm Product Import.

  • POSTcreate_admin_product_import_confirm

    Confirm Product Import.

  • POSTcreate_edit_confirm

    Confirm an Edit on a Draft Order.

  • POSTcreate_order_edit_confirm

    Confirm Order Edit.

  • POSTcreate_receive_confirm

    Confirm Return Receival.

Product, 5 operations

  • POSTadd_products_to_product_category

    Manage Products in Product Category.

  • POSTcreate_admin_product

    Create Product.

  • POSTcreate_collection_product

    Manage Products of a Collection.

  • POSTcreate_price_list_product

    Remove Products from Price List.

  • POSTcreate_sale_channel_product

    Manage Products in Sales Channel.

Request, 5 operations

  • POSTcreate_claim_request

    Confirm a Claim Request.

  • POSTcreate_edit_request

    Request Edit on Draft Order.

  • POSTcreate_exchange_request

    Confirm an Exchange.

  • POSTcreate_order_edit_request

    Request Order Edit.

  • POSTcreate_return_request

    Confirm Return Request.

Export, 3 operations

  • POSTcreate_inventory_item_export

    Export Inventory Items.

  • POSTcreate_order_export

    Export Orders.

  • POSTcreate_product_export

    Export Products.

Promotion, 3 operations

  • POSTcreate_admin_promotion

    Create Promotion.

  • POSTcreate_campaign_promotion

    Manage the Promotions of a Campaign.

  • POSTcreate_edit_promotion

    Add Promotions to Draft Order Edit.

Customer, 2 operations

  • POSTadd_customers_to_customer_group

    Manage Customers of a Customer Group.

  • POSTcreate_admin_customer

    Create Customer.

Customer group, 2 operations

  • POSTadd_customer_to_customer_groups

    Manage Customer Groups of Customer.

  • POSTcreate_admin_customer_group

    Create Customer Group.

Fulfillment, 2 operations

  • POSTcreate_admin_fulfillment

    Create Fulfillment.

  • POSTcreate_order_fulfillment

    Create an Order Fulfillment.

Import, 2 operations

  • POSTcreate_admin_product_import

    Create Product Import.

  • POSTcreate_product_import

    Create Product Import.

Sales channel, 2 operations

  • POSTcreate_admin_sale_channel

    Create Sales Channel.

  • POSTcreate_api_key_sale_channel

    Manage Sales Channels of a Publishable API Key.

Shipment, 2 operations

  • POSTcreate_admin_fulfillment_shipment

    Create a Shipment for a Fulfillment.

  • POSTcreate_order_fulfillment_shipment

    Create Shipment for an Order's Fulfillment.

Accept, 1 operation

  • POSTcreate_accept

    Accept Invite.

Active, 1 operation

  • POSTcreate_active

    Make View Configuration Active.

Addresse, 1 operation

  • POSTcreate_address

    Add a Customer Address.

Api key, 1 operation

  • POSTcreate_api_key

    Create Api Key.

Archive, 1 operation

  • POSTcreate_archive

    Archive an Order.

Authorize, 1 operation

  • POSTcreate_authorize

    Authorize Payment Session.

Campaign, 1 operation

  • POSTcreate_campaign

    Create Campaign.

Capture, 1 operation

  • POSTcreate_capture

    Capture Payment.

Claim, 1 operation

  • POSTcreate_claim

    Create a Claim.

Claim item, 1 operation

  • POSTcreate_claim_item

    Add Claim Items to a Claim.

Collection, 1 operation

  • POSTcreate_collection

    Create Collection.

Complete, 1 operation

  • POSTcreate_complete

    Complete Order.

Configuration, 1 operation

  • POSTcreate_layout_configuration

    Add Layout Configuration.

Convert to order, 1 operation

  • POSTconvert_draft_order_to_order

    Convert a Draft Order to an Order.

Credit, 1 operation

  • POSTcreate_credit

    Add Credit to Store Credit Account.

Credit line, 1 operation

  • POSTcreate_credit_line

    Create Credit Line for Order.

Dismiss item, 1 operation

  • POSTcreate_dismiss_item

    Add Damaged Items to Return.

Draft order, 1 operation

  • POSTcreate_draft_order

    Create Draft Order.

Edit, 1 operation

  • POSTcreate_edit

    Create a Draft Order Edit.

Exchange, 1 operation

  • POSTcreate_exchange

    Create Exchange.

Failure, 1 operation

  • POSTcreate_failure

    Fail a Step in a Workflow's Execution.

Fulfillment provider, 1 operation

  • POSTcreate_fulfillment_provider

    Manage Fulfillment Providers of a Stock Location.

Fulfillment set, 1 operation

  • POSTcreate_fulfillment_set

    Add Fulfillment Set to Stock Location.

Gift card, 1 operation

  • POSTcreate_gift_card

    Create Gift Card.

Guest, 1 operation

  • POSTcreate_guest

    Transfer Order to Guest Customer.

Inventory item, 1 operation

  • POSTcreate_admin_inventory_item

    Create Inventory Item.

Invite, 1 operation

  • POSTcreate_invite

    Create Invite.

Location level, 1 operation

  • POSTcreate_location_level

    Create Inventory Level for Inventory Item.

Mark as delivered, 1 operation

  • POSTcreate_mark_a_delivered

    Mark a Fulfillment as Delivered.

Mark as paid, 1 operation

  • POSTcreate_mark_a_paid

    Mark a Payment Collection as Paid.

Order edit, 1 operation

  • POSTcreate_order_edit

    Create Order Edit.

Payment collection, 1 operation

  • POSTcreate_payment_collection

    Create Payment Collection.

Payment session, 1 operation

  • POSTcreate_payment_session

    Initialize Payment Session in Payment Collection.

Presigned url, 1 operation

  • POSTcreate_presigned_url

    Get Presigned Upload URL.

Price list, 1 operation

  • POSTcreate_price_list

    Create Price List.

Price preference, 1 operation

  • POSTcreate_price_preference

    Create Price Preference.

Product categorie, 1 operation

  • POSTcreate_admin_product_category

    Create Product Category.

Product option, 1 operation

  • POSTcreate_product_option

    Create Product Option.

Product tag, 1 operation

  • POSTcreate_product_tag

    Create Product Tag.

Product type, 1 operation

  • POSTcreate_product_type

    Create Product Type.

Property label, 1 operation

  • POSTcreate_property_label

    Create Property Label.

Receive, 1 operation

  • POSTcreate_receive

    Start Return Receival.

Receive item, 1 operation

  • POSTcreate_receive_item

    Add Received Items to Return.

Refund, 1 operation

  • POSTcreate_refund

    Refund Payment.

Refund reason, 1 operation

  • POSTcreate_refund_reason

    Create Refund Reason.

Region, 1 operation

  • POSTcreate_region

    Create Region.

Resend, 1 operation

  • POSTcreate_resend

    Refresh Invite Token.

Reservation, 1 operation

  • POSTcreate_reservation

    Create Reservation.

Return, 1 operation

  • POSTcreate_return

    Create Return.

Return reason, 1 operation

  • POSTcreate_return_reason

    Create Return Reason.

Revoke, 1 operation

  • POSTcreate_revoke

    Revoke API Key.

Rule, 1 operation

  • POSTcreate_rule

    Create Tax Rule for a Rate.

Run, 1 operation

  • POSTcreate_run

    Execute a Workflow.

Service zone, 1 operation

  • POSTcreate_service_zone

    Add a Service Zone to a Fulfillment Set.

Shipping option, 1 operation

  • POSTcreate_shipping_option

    Create Shipping Option.

Showing the first 120 of 389 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Medusa Admin from Claude Code, Cursor or Codex

Connect Medusa Admin in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Medusa Admin operations become tools the client can call, next to every other integration you connected.

Claude Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Medusa Admin

  1. Create your workspace

    Sign up free. Nothing to install.

  2. Connect Medusa Admin once

    Add your Medusa Admin connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.

  3. Describe the job in chat

    The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Medusa Admin integration FAQ

What can you do with the Medusa Admin integration?
LiveContext exposes 389 operations on Medusa Admin, covering batch, shipping method, cancel and item.

Popular integrations

Browse the whole catalog