Blog

June 11, 2026·Product

Announcing New Prompts for the Medusa MCP Server

Shahed Nasser

Shahed  avatar

Shahed Nasser

Medusa's MCP server now includes built-in prompts that guide AI agents step-by-step through integrating payment providers, fulfillment providers, and extending products.

Image modal

We're adding three new prompts to the Medusa MCP server. These prompts give AI agents structured, step-by-step instructions for common Medusa development tasks, pulling in the exact documentation context the agent needs to complete each one.

Without task-specific prompts, agents working on complex integrations often hallucinate APIs, miss required steps, or fetch the wrong docs. These prompts fix that by encoding the correct sequence of actions and documentation lookups directly into the MCP server.

We added three prompts to the MCP server that will allow you to do the following:

  1. Integrate a payment provider
  2. Integrate a fulfillment provider
  3. Extend products

Integrate a payment provider

This prompt walks an agent through integrating a third-party payment provider such as PayPal. It covers creating the provider module, implementing the required methods, and registering the provider in your Medusa configuration.

Example prompt to trigger it:

Integrate PayPal as a payment provider in my Medusa application.

Integrate a fulfillment provider

This prompt guides an agent through integrating a third-party fulfillment provider such as ShipStation or DHL. It handles the full flow: creating the module, implementing fulfillment and cancellation logic, and wiring it up to your configuration.

Example prompt to trigger it:

Integrate ShipStation as a fulfillment provider in my Medusa application.

Extend products

This prompt instructs an agent on how to create a custom module that links to product data models to support new properties and business logic. Common examples include adding a brand relationship, building digital product support, or attaching any other custom data to products.

Example prompt to trigger it:

Extend products to support brands in my Medusa application.

More prompts on the way

These three are the first batch. We'll continue adding prompts on demand, covering more integrations and customization patterns as the need comes up. If there's a task you'd like to see a prompt for, open an issue or let us know on Discord.

Get started

The new prompts are available now in the Medusa MCP server. Check the MCP server documentation to set it up and start using prompts in your AI-assisted Medusa projects.

Share this post

Ready to build your custom commerce setup?