Skip to main content
Glama
barecommerce-core

BareMCP

by barecommerce-core
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

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

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/barecommerce-core/baremcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server