> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mercur Documentation

> The open-source enterprise marketplace platform. Composable, API-first, and AI-native, on infrastructure you own.

Mercur is the open-source enterprise marketplace platform. It gives operators
multi-vendor governance: sellers, offers, commissions, order splitting, and
payouts, with role-based access and an auditable change pipeline, on
infrastructure you own. Core commerce runs on the proven Medusa engine, so
products, pricing, carts, orders, and payments are mature from day one.

<video playsInline controls className="w-full aspect-video" src="https://mintcdn.com/mercur/l-9KBMYmsw41SJV7/images/admin-showcase.mp4?fit=max&auto=format&n=l-9KBMYmsw41SJV7&q=85&s=7f05f74177de054b73291d34073597bb" data-path="images/admin-showcase.mp4" />

## Get started

<CardGroup cols={2}>
  <Card title="Overview" icon="book-open" href="/learn/introduction">
    Install Mercur, tour the panels, and watch a multi-vendor order flow.
  </Card>

  <Card title="Why Mercur" icon="lightbulb" href="/learn/why-mercur">
    Governance, ownership, and composability without a closed platform.
  </Card>

  <Card title="Architecture" icon="sitemap" href="/learn/architecture">
    How the marketplace platform is architected, module by module.
  </Card>

  <Card title="Build with AI" icon="robot" href="/resources/ai/overview">
    Version-matched docs, agent skills, and the MCP server.
  </Card>
</CardGroup>

## Explore the platform

Each marketplace capability is its own module, with concepts, server guides, and a
data-model reference.

<CardGroup cols={3}>
  <Card title="Store" icon="store" href="/platform/store/overview">
    Govern who sells, with role-based access and an account lifecycle.
  </Card>

  <Card title="Catalog" icon="layer-group" href="/platform/catalog/overview">
    One shared master catalog that every store sells against.
  </Card>

  <Card title="Offer" icon="tag" href="/platform/offer/overview">
    A seller's listing against a master product, with its own price and stock.
  </Card>

  <Card title="Attribute" icon="sliders" href="/platform/attribute/overview">
    A typed attribute catalog that also drives variant axes.
  </Card>

  <Card title="Product Edit" icon="clipboard-check" href="/platform/product-edit/overview">
    The auditable change pipeline behind every catalog edit.
  </Card>

  <Card title="Order Group" icon="diagram-project" href="/platform/order-group/overview">
    How a single cart splits into per-seller orders.
  </Card>

  <Card title="Commission" icon="percent" href="/platform/commission/overview">
    Policy-based rules and per-order commission lines.
  </Card>

  <Card title="Payout" icon="wallet" href="/platform/payout/overview">
    Split settlement and provider-driven payouts.
  </Card>

  <Card title="Review" icon="star" href="/platform/review/overview">
    Product and seller reviews with moderation.
  </Card>
</CardGroup>

## Build

<CardGroup cols={2}>
  <Card title="How-Tos" icon="wrench" href="/resources/best-practices/overview">
    Extend the server and both panels the Mercur way.
  </Card>

  <Card title="Integrations" icon="plug" href="/resources/integrations/overview">
    Stripe Connect and installable blocks.
  </Card>

  <Card title="Self-host" icon="server" href="/resources/deployment/self-host">
    Deploy Mercur on your own infrastructure.
  </Card>

  <Card title="Blocks" icon="cube" href="/resources/tutorials/add-a-block">
    Install features as source code you own.
  </Card>
</CardGroup>

## API reference

Fully typed routes for every audience. Start with the
[API conventions](/references/api/conventions) for authentication, seller scoping,
and field selection.

<CardGroup cols={2}>
  <Card title="Admin API" icon="shield-halved" href="/references/api/admin">
    Operator routes under <code>/admin/\*</code>.
  </Card>

  <Card title="Vendor API" icon="store" href="/references/api/vendor">
    Seller-scoped routes under <code>/vendor/\*</code>.
  </Card>

  <Card title="Store API" icon="bag-shopping" href="/references/api/store">
    Storefront routes under <code>/store/\*</code>.
  </Card>

  <Card title="Panel extensions" icon="puzzle-piece" href="/references/panel-extensions/overview">
    Widgets, custom fields, and custom pages.
  </Card>
</CardGroup>
