Mercur
Open-source multi-vendor marketplace platform for B2B & B2C. Built on top of MedusaJS. Create your own custom marketplace. šļø
Install / Use
/learn @mercurjs/MercurREADME
What is Mercur?
<a href="https://www.mercurjs.com/">Mercur</a> is the first truly limitless open source marketplace platform that combines the simplicity of SaaS with the freedom of open source. Built on MedusaJS, it empowers businesses to create custom marketplaces without choosing between ownership and ease of use.
Mercur is a platform to start, customize, manage, and scale your marketplace for every business model with a modern technology stack.
What's new in Mercur 2.0
Mercur 2.0 is a major rearchitecture of the platform built by @vholik, @Si3r4dz, and @gtomaka.
- Block-based architecture ā reusable modules, workflows, API routes, and UI extensions installable via CLI
- Vendor portal ā a standalone React-based vendor dashboard
- Dashboard SDK ā Vite plugin with file-based routing and hot module reloading
- CLI ā
@mercurjs/clifor scaffolding projects, adding blocks, and managing registries - Full code ownership ā code is copied into your project, no black-box dependencies
Using with AI Agents
Mercur is built to be AI-agent friendly. Your AI coding assistant can use these resources to understand and work with Mercur projects:
- MCP Server:
https://docs.mercurjs.com/mcpā connect your agent for documentation search - llms.txt:
https://docs.mercurjs.com/llms.txtā machine-readable project summary - AGENTS.md: included in every project created with
mercurjs createā gives agents instant project context - Skills:
.claude/skills/shipped with templates ā domain-specific patterns for Claude Code - AI Development Guide: docs.mercurjs.com/v2/ai-development/mcp
Why Choose Mercur?
- Full Ownership: Unlike SaaS platforms, you own your marketplace with no transaction fees or vendor lock-in
- Modern Foundation: Built on MedusaJS, offering a modern tech stack that developers love
- Beautiful by Default: Create stunning storefronts without sacrificing customization
Power Any Marketplace Model
- Custom B2B Marketplace: Build enterprise-grade platforms with specialized workflows
- Custom B2C Marketplace: Create engaging consumer marketplaces with modern UX
- eCommerce Extension: Transform your store into a marketplace (coming soon)
Ā
Ready-to-go marketplace features
<b>Storefronts for Marketplace </b> <br> Customizable storefronts designed for B2B and B2C with all elements including browsing and buying products across multiple vendors at once.
Discover <a href="https://github.com/mercurjs/b2c-marketplace-storefront">B2C Storefront Repository</a> - <a href="https://b2c.mercurjs.com/">šļø Check demo </a>
<b>Admin Panel</b> <br> Control over whole marketplace: setting product categories, vendors, commissions and rules
<b>Vendor Panel</b> <br> A powerful dashboard giving sellers complete control over their products, orders, and store management in one intuitive interface.
Discover <a href="https://github.com/mercurjs/vendor-panel">Vendor Panel</a> - <a href="https://www.mercurjs.com/contact"> Contact us to get demo </a>
<b>Integrations</b> <br> Built-in integration with Stripe for payments and Resend for communication needs. More integrations coming soon.
Ā
Quickstart
Step 1: Create a new Mercur project and start the development server:
bunx @mercurjs/cli@latest create my-marketplace
Step 2: Start the development server:
cd my-marketplace
bun run dev
Step 3: Access your marketplace:
- Backend API:
http://localhost:9000 - Admin Panel:
http://localhost:7000 - Vendor Panel:
http://localhost:7001
Ā
Prerequisites
Contribution
Mercur is an Open Source project and we encourage everyone to help us making it better. If you are interested in contributing to the project, please read our Contributing Guide and Code of Conduct.
If you have any questions about contributing, please join our Discord server - we are happy to help you!
Discovered a š or have feature suggestion? Feel free to create an issue on Github.
