Package Exports

@barecommercecore/mcp
@barecommercecore/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@barecommercecore/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

BareMCP

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

Quick Start (30 seconds)

1. Install

bun add -g @barecommerce/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

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

@barecommercecore/mcp