---

name: open-commerce description: Open Commerce MCP and AI operations context

Open Commerce Domain Context

What Is Open Commerce?

Open Commerce enables AI-powered commerce operations through the Model Context Protocol (MCP). It allows AI agents to interact with Violet's commerce capabilities using natural language.

Core Capabilities

MCP Server

• Natural language product search
• Order creation and management
• Cart operations
• Customer lookup

AI Operations

• Conversational commerce
• Automated order processing
• Intelligent product recommendations
• Customer service automation

MCP Tools

Tool	Purpose
search_products	Find products by natural language query
get_product	Get detailed product information
create_cart	Start a new shopping cart
add_to_cart	Add products to cart
checkout	Complete purchase
get_order	Retrieve order details
track_order	Get fulfillment status

Example Usage

from mcp import Server

server = Server("violet-commerce")

@server.tool()
async def search_products(query: str, limit: int = 10) -> list:
    """Search for products in the Violet catalog."""
    # Implementation
    pass

@server.tool()
async def create_order(
    customer_email: str,
    items: list[dict],
    shipping_address: dict
) -> dict:
    """Create a new order with the specified items."""
    # Implementation
    pass

Integration Points

• Violet API: Core commerce operations
• AI Agents: Claude, GPT, custom agents
• Chat Platforms: Slack, Discord, custom
• Voice Assistants: Natural language interfaces

Key Patterns

Stateless Operations

Each MCP call is independent - no session state between calls.

Authentication

• API key authentication
• Scoped permissions per tool
• Rate limiting per key

Error Handling

• Clear error messages for AI agents
• Retry guidance in responses
• Graceful degradation

Claude Skill Registry (Data)

This repo contains the archived skill contents (the heavy, browsable skill files).

Canonical layout

• Category folders at repo root (e.g. development/, documents/, data/, ...)
• Each skill lives under a category: <category>/<skill>/SKILL.md + <category>/<skill>/metadata.json
• Case conflicts are resolved with {name}-{owner}-{repo} suffixes (fallback: -{short-hash}).

Archive status

• Live badges above are sourced from claude-skill-registry-core stats.json.
• Counts in this README are intentionally dynamic, not hardcoded.
• If the badges look stale, refresh the core build/index pipeline rather than editing numbers here.

Where the index + site live

• Core repo: https://github.com/majiayu000/claude-skill-registry-core
• Main repo (merged publish artifact): https://github.com/majiayu000/claude-skill-registry