Sellbase

Open source commerce in your own Supabase: catalog, checkout, orders and bookings, run by your AI.

Connector by jlgavel011 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/jlgavel011-sellbase

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

Open source commerce in your own Supabase: catalog, checkout, orders and bookings, run by your AI.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools: 14 read · 14 write · 2 delete · 1 not yet classified
Secrets: 2 (API keys, tokens or passwords)
Install scripts: None found
Runs as: Node.js package

Tools by what they do 31

Read from the source code; the running server may list different tools.

Read 14 · Look things up without changing anything.

availability_get
bookings_search
customers_search
docs_search
feedback_draft
integration_test
order_get
orders_search
payments_live_check
product_get
products_search
report_summary

Show 2 more tools

store_status
storefront_scaffold

Write 14 · Create, change, send or run things.

booking_action
collection_upsert
discount_upsert
media_add
order_action
order_create
product_file_upload
product_upsert
products_bulk
products_import
service_setup
store_update_settings

Show 2 more tools

test_purchase
webhook_setup

Delete 2 · Delete, drop, revoke or wipe things.

inventory_adjust
order_refund

Not yet classified 1 · We could not tell from the name and description.

integration_connect

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

SELLBASE_API_TOKEN
SUPABASE_ANON_KEY

Other settings (environment variables or headers).

SELLBASE_URL

Files it touches

Any path the agent passes to its tools

Tools (31)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

availability_getFree times for a serviceread-only
Free start times for a service variant (next 14 days by default). Use it to verify the setup or to find a time to reschedule. Times are UTC instants; say them to the owner in `timezone`.
booking_actionAct on an appointment
complete, no_show, cancel (needs reason and confirm=true; refund=true also refunds the booked line and needs refunds:write) or reschedule (needs starts_at from availability_get). The customer is emailed on cancel and reschedule.
bookings_searchSearch appointmentsread-only
Appointments in a date range (the agenda), e.g. today's for a resource. Defaults to the next 14 days.
collection_upsertCreate or update collection
Group products (e.g. "Lo más vendido", "Regalos"). Send id to update. product_ids replaces the products in that order; omit it to keep them. The storefront filters with ?collection=<slug>. Use delete: true with id to remove the collection (products are kept).
customers_searchSearch customersread-only
Find customers by email, name or phone, with orders count and total spent. Pass id for one customer with addresses, orders and appointments.
discount_upsertCreate or update discount
Discount codes and automatic discounts. kind "percent": value in basis points (1000 = 10%). kind "fixed": value in minor units. kind "free_shipping": value 0. code null = automatic (applies without a code). Codes are uppercase. Send id to update (every field is replaced). Call without discount to list the current ones. Money is an integer in minor units: $199.90 MXN is 19990.
docs_searchSearch the Sellbase docsread-only
Search guides, skills and the API reference bundled with Sellbase (e.g. "going live with Stripe", "shipping options", "refund scope"). Use it before guessing how a feature works.
feedback_draftDraft feedback for the Sellbase maintainersread-only
Use it when you find a Sellbase bug (unexpected error, wrong docs, a workaround you had to write), or when you build something on top of Sellbase that other stores would need (kind "extension"). Returns a redacted draft and a prefilled GitHub issue link. Nothing is sent: show the draft to the owner, ask if they want to share it, and give them the link to submit. Never include customer data, order contents, secrets or private code.
integration_connectConnect a provider
Connect Stripe (payments) or Resend (email) with API keys, stored encrypted in Supabase Vault. Stripe: when the project is deployed (public https URL) the webhook endpoint is created in Stripe for you; locally run `stripe listen --forward-to <webhooks URL>` and pass its whsec_ as webhook_secret. Use test keys (sk_test_…) until the owner says to go live; live keys (sk_live_…/rk_live_…) need confirm: true after the owner confirms customers will pay real money. Follow next_steps in the response.
integration_testTest a providerread-only
Check that a connected provider works and explain any error.
inventory_adjustAdjust stock
Add or remove stock for a variant with a reason (e.g. +20 "restock", -1 "damaged"). Cannot go below units reserved by open checkouts.
media_addAdd product image
Add an image to a product from a public URL or a local file path (max 5 MB). The first image is the one shown in listings.
order_actionAct on an order
fulfill: mark items shipped with carrier/tracking (omit items to ship everything pending); cancel: cancel an unfulfilled or partially fulfilled order (restocks by default; needs confirm=true; refunding needs order_refund permissions); note: add an internal note; resend_notification: email the confirmation (or "order_shipped") again; payment_link: a link to pay the balance of a deposit order. Confirm cancellations with the owner first.
order_createRecord a manual order
Record a sale made outside the storefront (in person, WhatsApp, phone). payment.mode "paid" with method cash/spei/card/other when the money was already received: needs confirm: true after the owner checks the total. payment.mode "link" to get a Stripe payment link for the customer (the order waits as pending_payment and opens when paid). Stock is taken immediately; unit_price_amount overrides the price for this order only. Services must be booked from the storefront. Money is an integer in minor units: $199.90 MXN is 19990.
order_getGet orderread-only
Full order: items (snapshots), totals, payments, shipping address and timeline.

Show 16 more tools

order_refundRefund an ordercan change or delete data
Refund all or part of an order through the payment provider. Moves real money in live mode: get explicit approval from the owner and pass confirm=true. Needs the refunds:write scope (agent tokens do not have it unless the owner granted it). Money is an integer in minor units: $199.90 MXN is 19990.
orders_searchSearch ordersread-only
Find orders, e.g. to fulfill today: fulfillment_status "unfulfilled". q matches an order number (#1001) or a customer email.
payments_live_checkVerify real payments
After connecting live Stripe keys: creates a Checkout for the smallest amount Stripe allows (10 MXN / 0.50 USD). The OWNER pays it with a real card; when the webhook arrives it is refunded automatically and store_status shows "Live payment check" as ok. Stripe keeps its small fee. Ask the owner before calling (confirm: true), give them the URL, then check store_status.
product_file_uploadAttach file to digital product
Attach the file buyers receive to a digital variant, from a local path (max 10 MB). Buyers get a private, expiring download link by email after paying.
product_getGet productread-only
Full product: variants with price, stock, shipping specs and attached files, plus images.
product_upsertCreate or update product
Create or update a whole product of any type in one call. Send id to update; variants with id are updated, without id are created, missing ones are archived. Every product needs at least one variant (use one titled "Default" when there are no options). Set status "active" to publish. Physical: variants[].physical and variants[].inventory.on_hand. Digital: afterwards attach the file with product_file_upload. Money is an integer in minor units: $199.90 MXN is 19990.
products_bulkBulk product changes
Publish, unpublish (draft), archive or reprice many products at once. Prices: price.mode "percent" in basis points (-1000 = 10% off, 500 = 5% up), "amount" adds minor units (negative lowers), "set" sets the price. Price changes return a preview of old → new prices; only send confirm: true after the owner approves that preview. Money is an integer in minor units: $199.90 MXN is 19990.
products_importImport products from CSV
Import or update many products from a CSV: our template (title,price,sku,stock,status,type,option1 name,option1 value,image), Spanish headers (nombre,precio,existencias…) or a Shopify export. Rows with the same handle become variants; existing products (same handle) are updated and variants match by SKU; variants missing from the file are archived. Services are not imported (use product_upsert). Run with dry_run: true first and show the owner the summary and any row errors.
products_searchSearch productsread-only
List or search products (by title or SKU). Returns compact rows; use product_get for full detail.
report_summarySales summaryread-only
Sales today, last 7 and 30 days (paid minus refunded), daily series, top products, orders waiting to ship and appointments today. Use it to answer "how is the store doing?".
service_setupSet up who delivers a service and when
Create or update a resource (a person, room or equipment) with weekly hours and the service products it delivers. Hours are local times in the store time zone unless `timezone` is given (weekday 0 = Sunday … 6 = Saturday). Optionally block days off with `closed`. Create the service product first with product_upsert (type "service", variants[].service.duration_min).
store_statusStore statusread-only
Use first, and whenever unsure what to do next. Returns the setup checklist (schema, payments, emails, catalog, webhooks) with a hint for each pending item, plus store basics.
store_update_settingsUpdate store settings
Change the store name, contact email, currency, locale, timezone, logo, brand color, tax (settings.tax.rate_bps: 1600 = 16%, mode inclusive|exclusive) and manual shipping (settings.shipping: flat_rate_amount, free_over_amount, pickup.enabled). Money is an integer in minor units: $199.90 MXN is 19990.
storefront_scaffoldPlan the storefrontread-only
Given what the owner wants to sell (e.g. "tienda de playeras", "agenda de citas para mi consultorio", "vender un curso"), returns which storefront components to add (React) or which <sellbase-*> elements to place (any other site, framework "web"), suggested pages and next steps. Run the command in the project, then follow the add-storefront skill.
test_purchaseTest purchase
Buy one active physical and one active digital product in payment TEST mode and report each step (cart, checkout, payment, order, delivery, email, download). Stock is restored afterwards. Run it after setting up the store and after any change to payments or products.
webhook_setupOutbound webhooks
Send store events (orders, refunds, shipments, bookings, products) to another system such as an ERP, a sheet or an automation tool. action "list" shows endpoints and delivery health; "create" needs the webhooks:write scope (agent tokens do not have it unless the owner granted it) and confirm: true after the owner approved the URL and events, since customer and order data will be sent there; it returns the signing secret ONCE (give it to the owner to store in the receiving system, never print it again); "test" sends a signed webhook.test now; "delete" removes one. Receivers verify the Sellbase-…

Signals

Stars: 2
Forks: 0
Open issues: 0
Last commit: Sep 28, 2026 (1 month ago)
Last release: Sep 28, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.jlgavel011/sellbase
Version: 0.3.3
Auth: API key
Packages: npm sellbase
License: MIT
Repository: github.com/jlgavel011/sellbase
Website: jlgavel011.github.io/sellbase/
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

Cite this page

Sellbase MCP server. Agent Mart. https://agentmart.dev/connectors/jlgavel011-sellbase (last updated 2026-10-24)