Skip to content
MCP server

Sellbase

Run an open-source Supabase and Stripe store from your own site through an AI agent

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, Web
Runs
Locally
Version
0.3.3
Listing updated
1 day ago

About Sellbase

Sellbase is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

Sellbase drops a store into a site you already have: catalogue, cart, Stripe checkout, orders, inventory and an admin at /admin, living in its own schema in your Supabase project with no extra server. Setup is npx sellbase init, and the project says there are no Sellbase fees; you pay only Stripe and hosting. It is MIT licensed.

The MCP server is how an agent runs the store. It reads a store API URL and an agent token with scopes the owner granted, minted with npx sellbase token create or in the admin. The README says it has 31 tools covering products, orders, refunds, discounts, bookings, webhooks, docs search and a test purchase, and that actions moving money or destroying data ask the owner first and are logged.

Storefront pieces come as React components for Next.js and Vite or sellbase web components for plain HTML, WordPress, Webflow, Astro and Vue. Other features include abandoned-cart emails, manual orders from WhatsApp, payment links, signed webhooks and appointment bookings.

Install

Run in a terminal

claude mcp add sellbase --env SELLBASE_URL='<SELLBASE_URL>' --env SELLBASE_API_TOKEN='<SELLBASE_API_TOKEN>' -- npx -y sellbase

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sellbase": {
      "command": "npx",
      "args": [
        "-y",
        "sellbase"
      ],
      "env": {
        "SELLBASE_URL": "<SELLBASE_URL>",
        "SELLBASE_API_TOKEN": "<SELLBASE_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sellbase": {
      "command": "npx",
      "args": [
        "-y",
        "sellbase"
      ],
      "env": {
        "SELLBASE_URL": "<SELLBASE_URL>",
        "SELLBASE_API_TOKEN": "<SELLBASE_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "sellbase": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "sellbase"
      ],
      "env": {
        "SELLBASE_URL": "<SELLBASE_URL>",
        "SELLBASE_API_TOKEN": "<SELLBASE_API_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sellbase": {
      "command": "npx",
      "args": [
        "-y",
        "sellbase"
      ],
      "env": {
        "SELLBASE_URL": "<SELLBASE_URL>",
        "SELLBASE_API_TOKEN": "<SELLBASE_API_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sellbase": {
      "command": "npx",
      "args": [
        "-y",
        "sellbase"
      ],
      "env": {
        "SELLBASE_URL": "<SELLBASE_URL>",
        "SELLBASE_API_TOKEN": "<SELLBASE_API_TOKEN>"
      }
    }
  }
}

Configuration

  • SELLBASE_URLYour store API: <SUPABASE_URL>/functions/v1/sellbase-api. `npx sellbase init` writes it to .env.sellbase, which the server also reads.Required
  • SELLBASE_API_TOKENAgent token (sb_live_…) with the scopes the owner granted. Create one with `npx sellbase token create` or in Admin → Settings → AI agents.Required
  • SUPABASE_ANON_KEYSupabase anon/publishable key (public). Needed for storefront tools on hosted projects.

What it does

Scoped agent tokens
Agents act through tokens carrying only the scopes the owner granted.
Owner approval
Money and destructive actions ask the owner first and are logged.
Test purchase
An agent can prove checkout works end to end.
Catalog and orders
Manage products, inventory, refunds and discounts.
Bookings
Handle appointments alongside product sales.
Any front end
React components and web components for many site stacks.

Good for

  • Have an agent set up a store for a small product line
  • Create and update products from chat
  • Check orders and issue a refund with owner approval
  • Run a test purchase after connecting Stripe

Pricing

Open source

MIT; you pay only Stripe and hosting.

Prices change. Check jlgavel011.github.io before you buy.

Sellbase FAQ

Does Sellbase charge fees?

No. The project says there are no Sellbase fees; you pay Stripe and your hosting.

Where does the data live?

In your own Supabase Postgres database.

What does the agent need?

SELLBASE_URL for your store API and an agent token with granted scopes.

What licence is it?

MIT.

Is Sellbase free?

Yes. Sellbase is open source, so you can use and self-host it for free.

How do I add Sellbase to Claude Code?

Run this command in your terminal: claude mcp add sellbase --env SELLBASE_URL='<SELLBASE_URL>' --env SELLBASE_API_TOKEN='<SELLBASE_API_TOKEN>' -- npx -y sellbase

What are the best alternatives to Sellbase?

The closest alternatives to Sellbase are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Sellbase

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools