Skip to directory

About Medusa Docs MCP

Medusa-hosted documentation MCP that answers questions from official Medusa documentation and returns curated implementation guides for common development tasks.

What you can use it for

  • Ask questions about Medusa APIs and framework behavior using official documentation
  • Get documented guides for provider integrations, product extensions, and Medusa upgrades
Connection and setup
Hosting
Remote hosted
Transport
Streamable HTTP
Endpoint
https://docs.medusajs.com/mcp
Authentication
Streamable HTTP; authenticate with a Medusa Cloud account using OAuth or a personal access key.

Requirements

  • Medusa Cloud account
  • MCP client that supports remote Streamable HTTP servers
  • Browser access for OAuth, or a Medusa Cloud Personal Access Key for token authentication

Setup steps

  1. Add https://docs.medusajs.com/mcp as a remote Streamable HTTP MCP server using the client's documented configuration.
  2. Authenticate with Medusa Cloud through the client's browser OAuth flow, or configure a Personal Access Key as a Bearer token.
  3. Reconnect the MCP server, then ask a Medusa documentation question or request a documented guide.
Tools 5+

This catalog entry is the Medusa Docs MCP at https://docs.medusajs.com/mcp, not the separate Medusa Cloud store-data MCP at https://cloud.medusajs.com/mcp. Current Medusa docs describe additional curated guide actions beyond the five named tools stored here; the docs do not publish their MCP identifiers in the tool overview. The five exact IDs are retained as a partial documented subset rather than inventing names or claiming completeness.

  • ask_medusa_question

    Find relevant Medusa documentation and return sourced sections to answer a question.

    01
  • get_payment_provider_integration_guide

    Return a step-by-step guide for integrating a payment provider.

    02
  • get_fulfillment_provider_integration_guide

    Return a step-by-step guide for integrating a fulfillment provider.

    03
  • get_product_custom_data_guide

    Return an implementation guide for attaching custom data to Medusa product, variant, or option models.

    04
  • get_medusa_upgrade_instructions

    Return step-by-step instructions for upgrading Medusa to a specified version.

    05

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

Limitations and notes
  • Requires a Medusa Cloud account. Public docs describe additional curated guide capabilities without enumerating all exact MCP tool identifiers; this inventory is partial. This is separate from the Cloud store-data MCP endpoint.
Source discrepancies
  • The queue's source was the Medusa documentation domain. The docs confirm this as the Docs MCP. Medusa also offers a separate Cloud store-management MCP; endpoints, capabilities, and authentication for that service are not combined here.
Original sources
  • official docs mcp reference

    Current docs identify the authenticated Streamable HTTP Docs MCP and list Ask Medusa Questions, three migration guides, provider integration, product extension, upgrade, and feedback capabilities; only some exact identifiers are named in public docs.

  • official tool documentation

    Current guide confirms the exact ask_medusa_question identifier and its documentation-search behavior.

Documentation checked 2026-10-28T13:56:00.000Z. Connection has not been runtime tested.

Similar tools