BareMCP

MCP server for BareCommerceCore e-commerce management via AI assistants.

Quick Start (30 seconds)

1. Install

bun add -g @barecommercecore/mcp

2. Configure Claude Desktop

Add to your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "baremcp": {
      "command": "baremcp"
    }
  }
}

3. Connect

Say to Claude: "Connect to my BareCommerce store"

A browser window opens for secure OAuth login. No API keys in chat.

Security

Never paste API keys into chat. BareMCP uses browser-based OAuth Device Flow.

• Credentials encrypted with AES-256-GCM at ~/.baremcp/credentials.json
• Machine-specific encryption (credentials don't work on other machines)
• No telemetry, no analytics — see PRIVACY.md

Environment Variables

Variable	Required	Default	Description
BARECOMMERCE_API_URL	No	https://api.barecommercecore.com	API endpoint
BARECOMMERCE_API_KEY	No	—	Pre-configured key (skips OAuth)
BARECOMMERCE_DEFAULT_STORE_ID	No	—	Auto-select store

Troubleshooting

Error	Cause	Fix
NOT_AUTHENTICATED	Not connected	Run connect tool first
STORE_ID_REQUIRED	No default store	Pass storeId parameter
RATE_LIMITED	Too many requests	Wait 60s, retry
UNAUTHORIZED	Invalid/expired token	Run disconnect then connect
TIMEOUT	Request took >30s	Check network, retry

See docs/TROUBLESHOOTING.md for complete error reference.

Features

• 46 Tools for complete store management
• 4 Resources for quick data access
• 6 Prompts for guided workflows
• Multi-tenant — users authenticate at runtime

Tools by Category

Category	Tools
Session	connect, disconnect, status
Store	list_stores, get_store, update_store, get_store_analytics
Products	list_products, get_product, create_product, update_product, delete_product, bulk_update_products, search_products, get_product_variants, update_variant
Orders	list_orders, get_order, update_order_notes, record_refund, export_orders
Customers	list_customers, get_customer, create_customer, update_customer, delete_customer
Categories	list_categories, get_category, create_category, update_category, delete_category
Pages	list_pages, get_page, create_page, update_page, delete_page
Media	list_media, get_media, upload_media, delete_media
Webhooks	list_webhooks, create_webhook, update_webhook, delete_webhook
Audit	list_audit_logs, get_audit_log

Resources

URI	Description
store://config	Store settings, currency, timezone, contact info
store://schema	Product attribute and metafield definitions
store://categories	Hierarchical category tree

Prompts

Name	Description
create-product	Guided product creation workflow
sales-report	Generate sales summary for date range
inventory-check	Find low stock products
customer-lookup	Find customer and order history
bulk-price-update	Update prices across products
product-catalog-export	Export catalog data

Usage Examples

Products

"List all published products" "Create a new product called 'Wireless Headphones' priced at $79.99" "Find products with less than 10 items in stock"

Orders

"Show me orders from last week" "Get details for order ORD-2024-001"

Customers

"Find customer with email john@example.com"

Analytics

"Give me a sales report for this month"

Documentation

• Configuration Reference
• Security Model
• Troubleshooting Guide
• Privacy Policy
• Changelog

Development

# Install dependencies
bun install

# Type check
bun run typecheck

# Run tests
bun test

# Build
bun run build

# Run locally
bun run dev

License

MIT — see LICENSE

Links

• BareCommerceCore
• MCP Specification
• Claude Desktop