June 11, 2026·Product
Announcing New Prompts for the Medusa MCP Server
Shahed Nasser
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.

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:
- Integrate a payment provider
- Integrate a fulfillment provider
- 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:
12Integrate 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:
12Integrate 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:
12Extend 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.


