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).
Say what should happen.
The workflow builds itself.
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
batch_update_inventory_location_levelsBatch update inventory location levelsPOSTManage Inventory Levels of Inventory Item.create_admin_inventory_item_location_level_batchCreate admin inventory item location level batchPOSTManage Inventory Levels.create_buy_rule_batchCreate buy rule batchPOSTManage the Buy Rules of a Promotion.create_image_batchCreate image batchPOSTManage Images of Product Variant.create_image_variant_batchCreate image variant batchPOSTManage Variants of Product Image.create_inventory_item_batchCreate inventory item batchPOSTManage Variants Inventory in a Product.create_option_batchCreate option batchPOSTAdd Options to Product.create_price_batchCreate price batchPOSTManage Prices in Price List.create_product_batchCreate product batchPOSTManage Products.create_product_variant_batchCreate product variant batchPOSTManage Variants in a Product.create_promotion_rule_batchCreate promotion rule batchPOSTManage a Promotion's Rules.create_property_label_batchCreate property label batchPOSTCreate Property Label.create_setting_batchCreate setting batchPOSTManage Translation Settings.
Shipping method, 7 operations
create_claim_inbound_shipping_methodCreate claim inbound shipping methodPOSTAdd an Inbound Shipping Method to a Claim.create_claim_outbound_shipping_methodCreate claim outbound shipping methodPOSTAdd Outbound Shipping Methods to a Claim.create_edit_shipping_methodCreate edit shipping methodPOSTAdd Shipping Method to Draft Order Edit.create_exchange_inbound_shipping_methodCreate exchange inbound shipping methodPOSTAdd an Inbound Shipping Method to an Exchange.create_exchange_outbound_shipping_methodCreate exchange outbound shipping methodPOSTAdd Outbound Shipping Method to Exchange.create_order_edit_shipping_methodCreate order edit shipping methodPOSTAdd Shipping Method to Order Edit.create_return_shipping_methodCreate return shipping methodPOSTAdd a Shipping Method to a Return.
Cancel, 6 operations
create_admin_fulfillment_cancelCreate admin fulfillment cancelPOSTCancel a Fulfillment.create_claim_cancelCreate claim cancelPOSTCancel a Claim.create_exchange_cancelCreate exchange cancelPOSTCancel an Exchange.create_order_cancelCreate order cancelPOSTCancel Order.create_order_fulfillment_cancelCreate order fulfillment cancelPOSTCancel Fulfillment.create_return_cancelCreate return cancelPOSTCancel a return.
Item, 6 operations
create_claim_inbound_itemCreate claim inbound itemPOSTAdd Inbound Items to a Claim.create_claim_outbound_itemCreate claim outbound itemPOSTAdd Outbound Items to a Claim.create_edit_itemCreate edit itemPOSTAdd Item to Draft Order Edit.create_exchange_inbound_itemCreate exchange inbound itemPOSTAdd Inbound Items to an Exchange.create_exchange_outbound_itemCreate exchange outbound itemPOSTAdd Outbound Items to Exchange.create_order_edit_itemCreate order edit itemPOSTAdd Items to Order Edit.
Confirm, 5 operations
confirm_product_importConfirm product importPOSTConfirm Product Import.create_admin_product_import_confirmCreate admin product import confirmPOSTConfirm Product Import.create_edit_confirmCreate edit confirmPOSTConfirm an Edit on a Draft Order.create_order_edit_confirmCreate order edit confirmPOSTConfirm Order Edit.create_receive_confirmCreate receive confirmPOSTConfirm Return Receival.
Product, 5 operations
add_products_to_product_categoryAdd products to product categoryPOSTManage Products in Product Category.create_admin_productCreate admin productPOSTCreate Product.create_collection_productCreate collection productPOSTManage Products of a Collection.create_price_list_productCreate price list productPOSTRemove Products from Price List.create_sale_channel_productCreate sale channel productPOSTManage Products in Sales Channel.
Request, 5 operations
create_claim_requestCreate claim requestPOSTConfirm a Claim Request.create_edit_requestCreate edit requestPOSTRequest Edit on Draft Order.create_exchange_requestCreate exchange requestPOSTConfirm an Exchange.create_order_edit_requestCreate order edit requestPOSTRequest Order Edit.create_return_requestCreate return requestPOSTConfirm Return Request.
Export, 3 operations
create_inventory_item_exportCreate inventory item exportPOSTExport Inventory Items.create_order_exportCreate order exportPOSTExport Orders.create_product_exportCreate product exportPOSTExport Products.
Promotion, 3 operations
create_admin_promotionCreate admin promotionPOSTCreate Promotion.create_campaign_promotionCreate campaign promotionPOSTManage the Promotions of a Campaign.create_edit_promotionCreate edit promotionPOSTAdd Promotions to Draft Order Edit.
Customer, 2 operations
add_customers_to_customer_groupAdd customers to customer groupPOSTManage Customers of a Customer Group.create_admin_customerCreate admin customerPOSTCreate Customer.
Customer group, 2 operations
add_customer_to_customer_groupsAdd customer to customer groupsPOSTManage Customer Groups of Customer.create_admin_customer_groupCreate admin customer groupPOSTCreate Customer Group.
Fulfillment, 2 operations
create_admin_fulfillmentCreate admin fulfillmentPOSTCreate Fulfillment.create_order_fulfillmentCreate order fulfillmentPOSTCreate an Order Fulfillment.
Import, 2 operations
create_admin_product_importCreate admin product importPOSTCreate Product Import.create_product_importCreate product importPOSTCreate Product Import.
Sales channel, 2 operations
create_admin_sale_channelCreate admin sale channelPOSTCreate Sales Channel.create_api_key_sale_channelCreate api key sale channelPOSTManage Sales Channels of a Publishable API Key.
Shipment, 2 operations
create_admin_fulfillment_shipmentCreate admin fulfillment shipmentPOSTCreate a Shipment for a Fulfillment.create_order_fulfillment_shipmentCreate order fulfillment shipmentPOSTCreate Shipment for an Order's Fulfillment.
Accept, 1 operation
create_acceptCreate acceptPOSTAccept Invite.
Active, 1 operation
create_activeCreate activePOSTMake View Configuration Active.
Addresse, 1 operation
create_addressCreate addressPOSTAdd a Customer Address.
Api key, 1 operation
create_api_keyCreate api keyPOSTCreate Api Key.
Archive, 1 operation
create_archiveCreate archivePOSTArchive an Order.
Authorize, 1 operation
create_authorizeCreate authorizePOSTAuthorize Payment Session.
Campaign, 1 operation
create_campaignCreate campaignPOSTCreate Campaign.
Capture, 1 operation
create_captureCreate capturePOSTCapture Payment.
Claim, 1 operation
create_claimCreate claimPOSTCreate a Claim.
Claim item, 1 operation
create_claim_itemCreate claim itemPOSTAdd Claim Items to a Claim.
Collection, 1 operation
create_collectionCreate collectionPOSTCreate Collection.
Complete, 1 operation
create_completeCreate completePOSTComplete Order.
Configuration, 1 operation
create_layout_configurationCreate layout configurationPOSTAdd Layout Configuration.
Convert to order, 1 operation
convert_draft_order_to_orderConvert draft order to orderPOSTConvert a Draft Order to an Order.
Credit, 1 operation
create_creditCreate creditPOSTAdd Credit to Store Credit Account.
Credit line, 1 operation
create_credit_lineCreate credit linePOSTCreate Credit Line for Order.
Dismiss item, 1 operation
create_dismiss_itemCreate dismiss itemPOSTAdd Damaged Items to Return.
Draft order, 1 operation
create_draft_orderCreate draft orderPOSTCreate Draft Order.
Edit, 1 operation
create_editCreate editPOSTCreate a Draft Order Edit.
Exchange, 1 operation
create_exchangeCreate exchangePOSTCreate Exchange.
Failure, 1 operation
create_failureCreate failurePOSTFail a Step in a Workflow's Execution.
Fulfillment provider, 1 operation
create_fulfillment_providerCreate fulfillment providerPOSTManage Fulfillment Providers of a Stock Location.
Fulfillment set, 1 operation
create_fulfillment_setCreate fulfillment setPOSTAdd Fulfillment Set to Stock Location.
Gift card, 1 operation
create_gift_cardCreate gift cardPOSTCreate Gift Card.
Guest, 1 operation
create_guestCreate guestPOSTTransfer Order to Guest Customer.
Inventory item, 1 operation
create_admin_inventory_itemCreate admin inventory itemPOSTCreate Inventory Item.
Invite, 1 operation
create_inviteCreate invitePOSTCreate Invite.
Location level, 1 operation
create_location_levelCreate location levelPOSTCreate Inventory Level for Inventory Item.
Mark as delivered, 1 operation
create_mark_a_deliveredCreate mark a deliveredPOSTMark a Fulfillment as Delivered.
Mark as paid, 1 operation
create_mark_a_paidCreate mark a paidPOSTMark a Payment Collection as Paid.
Order edit, 1 operation
create_order_editCreate order editPOSTCreate Order Edit.
Payment collection, 1 operation
create_payment_collectionCreate payment collectionPOSTCreate Payment Collection.
Payment session, 1 operation
create_payment_sessionCreate payment sessionPOSTInitialize Payment Session in Payment Collection.
Presigned url, 1 operation
create_presigned_urlCreate presigned urlPOSTGet Presigned Upload URL.
Price list, 1 operation
create_price_listCreate price listPOSTCreate Price List.
Price preference, 1 operation
create_price_preferenceCreate price preferencePOSTCreate Price Preference.
Product categorie, 1 operation
create_admin_product_categoryCreate admin product categoryPOSTCreate Product Category.
Product option, 1 operation
create_product_optionCreate product optionPOSTCreate Product Option.
Product tag, 1 operation
create_product_tagCreate product tagPOSTCreate Product Tag.
Product type, 1 operation
create_product_typeCreate product typePOSTCreate Product Type.
Property label, 1 operation
create_property_labelCreate property labelPOSTCreate Property Label.
Receive, 1 operation
create_receiveCreate receivePOSTStart Return Receival.
Receive item, 1 operation
create_receive_itemCreate receive itemPOSTAdd Received Items to Return.
Refund, 1 operation
create_refundCreate refundPOSTRefund Payment.
Refund reason, 1 operation
create_refund_reasonCreate refund reasonPOSTCreate Refund Reason.
Region, 1 operation
create_regionCreate regionPOSTCreate Region.
Resend, 1 operation
create_resendCreate resendPOSTRefresh Invite Token.
Reservation, 1 operation
create_reservationCreate reservationPOSTCreate Reservation.
Return, 1 operation
create_returnCreate returnPOSTCreate Return.
Return reason, 1 operation
create_return_reasonCreate return reasonPOSTCreate Return Reason.
Revoke, 1 operation
create_revokeCreate revokePOSTRevoke API Key.
Rule, 1 operation
create_ruleCreate rulePOSTCreate Tax Rule for a Rate.
Run, 1 operation
create_runCreate runPOSTExecute a Workflow.
Service zone, 1 operation
create_service_zoneCreate service zonePOSTAdd a Service Zone to a Fulfillment Set.
Shipping option, 1 operation
create_shipping_optionCreate shipping optionPOSTCreate 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 mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Medusa Admin
- Create your workspace
Sign up free. Nothing to install.
- 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.
- 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.
