Mercur

Website · Documentation · Live Demo · Discord

What is Mercur

Mercur is an open-source, headless platform for building multi-vendor marketplaces. Add vendor onboarding, multi-vendor catalogs, offers, commissions, and automated payouts on top of a commerce core you can change at its foundation. Run B2C, B2B, and hybrid marketplaces without choosing between a profit-draining SaaS platform and a build from scratch.

• Own your marketplace, no fees: Self-host on your own infrastructure with full source access. No percentage of GMV, no per-transaction cut, no vendor lock-in — your data, your customers, and your roadmap stay yours.
• Built for the marketplace model: Vendor onboarding, multi-vendor catalogs, offers, commissions, and automated payouts are built in — multiple sellers can list offers against the same product, so you're not rebuilding marketplace logic on top of a single-seller commerce engine.
• Headless and customizable, no forks: TypeScript, event-driven, and API-first — serve any storefront or frontend. Extend or override workflows, products, and vendor rules through a composable architecture built for the most complex B2B and multi-vendor models, without patching the core.
• Standing on Medusa: Inherit a mature, battle-tested commerce core — catalog, orders, payments, shipping, tax, and stock — instead of reinventing it. Mercur adds the marketplace layer on top of Medusa.
• Production-ready and AI-native: Run real marketplaces in production today, on an architecture designed for AI-assisted development — an introspectable, API-first stack that works hand in hand with your AI coding tools.

Getting Started

To get a local marketplace up and running, please follow these simple steps.

Prerequisites

Here's what you need to run Mercur.

• Node.js (Version: >=20.x)
• PostgreSQL (Version: >=13.x)
• Redis
• Bun (recommended)

If you want to enable any of the available integrations (e.g. Stripe Connect payouts, Resend email, Algolia/Meilisearch search), you may want to obtain additional credentials for each one and add them to your .env file.

Setup

1. Create a new Mercur project

   bun create mercur-app@latest my-marketplace
   

2. Start the development server

   cd my-marketplace
   bun run dev
   

3. Access your marketplace

   • Backend API: http://localhost:9000
   • Admin Panel: http://localhost:9000/dashboard
   • Vendor Panel: http://localhost:9000/seller

   Your marketplace comes seeded with a demo store out of the box — a ready-to-go seller (seller@mercur.dev / supersecret) with a full catalog of products and offers, so you can explore the admin and vendor panels immediately. Sign in to the Vendor Panel with those credentials, or manage everything from the Admin Panel.

Built With

• Medusa.js
• TypeScript
• React.js
• Vite
• Node.js
• PostgreSQL
• Redis

Architecture

Mercur is modular. Each piece is a separate, independently deployable app that talks to the core over APIs.

• Mercur Core: the marketplace engine on top of Medusa, with vendors, commissions, payouts, and multi-vendor primitives.
• Admin Panel: marketplace operators manage vendors, catalog, categories, commissions, and rules.
• Vendor Panel: sellers manage their products, orders, and payouts.
• Storefronts: customer-facing B2C/B2B apps with multi-vendor browsing, cart, and checkout.

What's in this repo

This is the Mercur development monorepo: the @mercurjs/core plugin, the React + Vite admin and vendor dashboards, the @mercurjs/cli, the typed API client, the dashboard SDK, the Stripe Connect payout provider, and the cross-package integration suites. If you just want to build a marketplace, run bun create mercur-app@latest (see Getting Started) - clone this repo only when you want to contribute to Mercur itself.

Deployment

Because Mercur is a plain Node.js application backed by PostgreSQL and Redis, it deploys the same way whether you ship it as a container, orchestrate it with Kubernetes, push it to a managed cloud, or lock it inside an air-gapped network. There's no proprietary runtime to adopt and no hosting tier you're forced onto, so where your marketplace lives and where its data sits stay entirely under your control. Prefer a managed backend? Mercur also deploys to Medusa Cloud with push-to-deploy and auto-scaling.

License

This repository is Mercur core, licensed under the MIT License and fully open source. It's the marketplace engine on top of Medusa — vendors, multi-vendor catalogs, offers, commissions, and payouts, with the admin and vendor dashboards and APIs to run a marketplace yourself.

Mercur Enterprise adds a licensed suite of advanced modules (EAN matching & deduplication, a Buy Box / winning-offer engine, master-data governance, multi-channel stock sync, automated split payouts, vendor KYC, and much more), all maintained, tested, and upgraded by the core team. You deploy and run Enterprise on your own infrastructure, exactly like the open-source core.

It comes backed by a direct support relationship with the people who build the platform: a dedicated support channel, contractual SLAs with guaranteed response times, prioritized bug fixes and security patches, and hands-on onboarding and architecture guidance to get you to production. Higher support tiers add priority escalation and a named technical contact.

Book Mercur Enterprise demo.

Professional services

Mercur is built and maintained by Rigby, a team that has designed, built, and launched multi-vendor marketplaces in production. If you'd rather not do it alone, we work alongside your engineers — from architecture reviews and integrating Mercur with your existing stack to hardening, scaling, and getting your marketplace live on schedule. Talk to our team.

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.

Upgrades

Follow the Release Notes to keep your Mercur marketplace up-to-date.

Contributors

Star history