[opensourcedex]

mercur is a free, open source e-commerce platforms project written in TypeScript and released under MIT. It has 1,768 GitHub stars, 444 forks and 4 open issues, and was last pushed 12 hours ago. On this registry it ranks #27 of 30 tracked projects in E-commerce Platforms, with 5 head-to-head comparisons available. It gained 3 stars over the last 3 tracked days.

What is mercur?

What it is

Mercur is an open-source, headless marketplace platform written in TypeScript and built on Medusa.js. It provides a storefront, vendor panel, admin console, and integrations as modular applications that communicate with a commerce core over APIs. The project targets multi-vendor commerce, where several sellers list offers on one marketplace, and it positions itself as an alternative to Mirakl.

The problem it solves is running B2C, B2B, and hybrid marketplaces without a SaaS platform that takes a percentage of gross merchandise value or building marketplace logic from scratch. Mercur adds vendor onboarding, multi-vendor catalogs, offers, commissions, and automated payouts on top of Medusa, so operators can manage vendors, listings, payments, shipping, tax, stock, and workflows while self-hosting the source.

Key capabilities

  • Multi-vendor marketplace logic: supports vendor onboarding, multiple sellers listing offers against the same product, and vendor-specific rules through a composable architecture.
  • Commissions and automated payouts: includes marketplace revenue logic and payout workflows, with Stripe Connect payouts as an available integration.
  • Headless commerce core: built on Medusa, exposing catalog, orders, payments, shipping, tax, and stock capabilities to any storefront or frontend.
  • Admin and vendor panels: ships with an admin console and a vendor panel, accessible locally at http://localhost:9000/dashboard and http://localhost:9000/seller.
  • Modular architecture: Mercur Core is a separate marketplace engine on top of Medusa, and each piece is an independently deployable app that talks to the core over APIs.
  • Integrations for operations: supports optional integrations such as Stripe Connect payouts, Resend email, and Algolia or Meilisearch search, requiring additional credentials in .env.

Who uses it and how

  • Marketplace operators use Mercur to run B2C, B2B, and hybrid multi-vendor stores without depending on a single-seller commerce engine.
  • Engineering teams use it to extend or override workflows, products, and vendor rules through a composable architecture, rather than patching the core.
  • Platform teams use the admin panel to manage vendors, catalogs, offers, commissions, and payouts from one console.
  • Sellers use the vendor panel to list offers and manage their storefront presence, with a seeded demo seller provided for local exploration.

Getting started

Mercur is typically started locally with Bun using bun create mercur-app@latest my-marketplace, then cd my-marketplace and bun run dev. It requires Node.js 20.x or newer, PostgreSQL 13.x or newer, Redis, and optional external credentials for integrations.

When to use it — and when not to

Mercur is a good fit when a team needs a self-hosted marketplace platform built on Medusa and is willing to operate PostgreSQL, Redis, integrations, and the application stack. It compares to Mirakl as an open-source alternative, but it does not remove the burden of hosting, upgrading, securing, and integrating the platform. Teams that need a fully managed marketplace or a simple single-vendor store may prefer a different approach.

project readme (upstream, from github) — read inline

Mercur

Mercur

The open-source marketplace platform. A Mirakl alternative.

Website · Documentation · Live Demo · Discord

License PRs Welcome Support GitHub closed issues

Discord

What is Mercur

demo-screen

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.

Mercur Use Cases

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 ([email protected] / 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

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.

Mercur

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

Mercur contributors

Star history

<a href="https://star

readme truncated — read the full docs on github

Frequently asked questions

Is mercur free to use?

mercur is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does mercur do?

The complete open source platform to run your entire marketplace. Storefront, vendor panel, admin console, and integrations in one enterprise-grade platform you

What is mercur written in?

mercur is primarily written in TypeScript. Its source is publicly available at https://github.com/mercurjs/mercur, and it has 1,768 GitHub stars.