MCP server for BareCommerceCore to manage stores, products, orders, customers, and more via AI assistants.
Configuration
View docs{
"mcpServers": {
"barecommerce-core-baremcp": {
"command": "baremcp",
"args": [],
"env": {
"BARECOMMERCE_API_KEY": "YOUR_API_KEY",
"BARECOMMERCE_API_URL": "https://api.barecommercecore.com",
"BARECOMMERCE_DEFAULT_STORE_ID": "STORE_123"
}
}
}
}You can manage your BareCommerce data and workflows through BareMCP, a local MCP server that connects with an AI assistant. It provides secure, browser-based authentication and a set of tools to handle stores, products, orders, customers, and more from a unified interface.
Interact with BareMCP through your MCP client by connecting to your BareCommerce store and issuing natural-language prompts. Common workflows include listing stores, retrieving product details, updating prices, creating new products, checking inventory, and exporting orders. Use prompts like “List all published products,” “Create a new product called ‘Wireless Headphones’ priced at $79.99,” or “Show me orders from last week” to perform actions and retrieve data. All authentication occurs in a secure browser flow, and no API keys are pasted into chat.
Prerequisites: you need a JavaScript runtime and a package manager to install and run BareMCP. You will install the MCP client globally, configure your client, then connect to your BareCommerce instance.
bun add -g @barecommercecore/mcpConfigure your MCP client to recognize the BareMCP server. You will reference a local command that runs the MCP server with no extra parameters.
{
"mcpServers": {
"baremcp": {
"command": "baremcp"
}
}
}BareMCP uses a browser-based OAuth Device Flow for secure login. Credentials are encrypted with AES-256-GCM and are machine-specific, so they don’t work on other machines. There is no telemetry or analytics data collected.
Set or provide values for the following environment variables as needed. They control how BareMCP talks to BareCommerce and which store to use by default.
- BARECOMMERCE_API_URL: API endpoint (default: https://api.barecommercecore.com) - BARECOMMERCE_API_KEY: Pre-configured key (skips OAuth) (optional) - BARECOMMERCE_DEFAULT_STORE_ID: Auto-select store (optional)
If you encounter errors, check the following common causes and fixes. Ensure you are connected before issuing commands, verify a default store is selected if required, and handle token expiry by reconnecting.
NOT_AUTHENTICATED: Run connect first
STORE_ID_REQUIRED: Pass a storeId parameter
RATE_LIMITED: Wait 60s, retry
UNAUTHORIZED: Run disconnect then connect
TIMEOUT: Check network, retryBareMCP provides a wide set of tools for end-to-end store management, including session controls, store data access, product management, order handling, customer management, categories, pages, media, webhooks, and audit logs.
Examples you can say to your assistant: - List all published products - Create a new product called 'Wireless Headphones' priced at $79.99 - Find products with less than 10 items in stock - Show me orders from last week - Get details for order ORD-2024-001 - Find customer with email [email protected]
To run BareMCP locally for development, install dependencies, run type checks, run tests, build, and start the server locally with the provided commands.
bun install
bun run typecheck
bun test
bun run build
bun run devEstablish an authenticated session with BareCommerce and initialize MCP usage.
Terminate the current session and clear tokens.
Report the current authentication and connection status.
Retrieve a list of stores the authenticated user can access.
Fetch details for a specific store by ID.
Update store settings such as name, currency, or timezone.
Obtain analytics data for a store.
List products in the store with filtering options.
Get detailed information about a product.
Create a new product in the catalog.
Update product attributes such as price or description.
Remove a product from the catalog.
Apply changes to multiple products in one operation.
Search products by keywords or attributes.
Retrieve variants for a product.
Update a product variant.
List customer orders with filters.
Get details for a specific order.
Add or modify notes on an order.
Record a refund for an order.
Export orders data for external use.
List customers and their basic details.
Fetch customer details by ID or email.
Create a new customer record.
Update customer information.
Remove a customer record.
List product categories.
Get details of a category.
Create a new category.
Update category attributes.
Delete a category.
List site pages.
Get details for a page.
Create a new page.
Update page content.
Delete a page.
List media assets.
Get a media asset by ID.
Upload a new media asset.
Remove a media asset.
List configured webhooks.
Create a new webhook.
Update webhook configuration.
Delete a webhook.
List audit logs for actions performed.
Get details for a specific audit entry.