
Sellbase
Run an open-source Supabase and Stripe store from your own site through an AI agent
- 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 sellbaseAdd 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.RequiredSELLBASE_API_TOKENAgent token (sb_live_…) with the scopes the owner granted. Create one with `npx sellbase token create` or in Admin → Settings → AI agents.RequiredSUPABASE_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools