# Sellbase

> Sellbase is an open-source MCP server for e-commerce. Run an open-source Supabase and Stripe store from your own site through an AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Web
- **Website:** https://jlgavel011.github.io/sellbase/
- **Repository:** https://github.com/jlgavel011/sellbase
- **MCP Registry name:** io.github.jlgavel011/sellbase
- **Categories:** e-commerce, developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/sellbase
