# Commercives

> Commercives is a headless commerce PLATFORM (not an agency) that connects manufacturing, marketplaces, and shipping through a single GraphQL API. Built for manufacturers and brands who make products and sell across multiple channels.

## What It Is
- Headless commerce platform with GraphQL API
- Unified hub for production, inventory, orders, and shipping
- Multi-marketplace integration layer
- MCP (Model Context Protocol) server for AI assistant integration

## What It Is NOT
- Not an agency or development shop
- Not a marketplace itself
- Not a traditional e-commerce platform with a storefront

## Who It's For

### Brands & Manufacturers
- Businesses that make their own products
- Sellers on multiple marketplaces (Amazon, eBay, Etsy, Shopify)
- Companies needing production/manufacturing tracking
- Wholesalers with B2B customers

### Agencies & Developers
- Building commerce experiences for clients
- Need a production-ready backend API
- Want to skip building inventory/order/shipping logic from scratch

## Core Capabilities

### Marketplace Integrations
- Amazon, eBay, Etsy, Shopify, WooCommerce, Faire, TikTok Shop
- Real-time inventory sync across all channels
- Unified order management
- Automatic listing updates

### Manufacturing & Production
- Production orders with status workflows
- Bill of Materials (BOM) with recipes
- Component wastage tracking
- Multi-step production processes
- Staff/resource attribution

### Shipping & Fulfillment
- Multi-carrier: Royal Mail, DPD, DHL, UPS, FedEx, Evri
- Rate comparison API
- Batch label generation
- Unified tracking
- Returns portal

### Wholesale & B2B
- Customer-specific pricing
- Credit limits and payment terms (NET_30, NET_60)
- Tiered product visibility
- Scope-based access control

### Technical
- Strictly-typed GraphQL API
- Field-level permissions with scopes
- Webhooks and workflow automation
- MCP server for AI agents (Claude, GPT, custom)

## MCP (Model Context Protocol) Integration

### Overview
The MCP server allows AI assistants to interact with your commerce data using natural language. Available at `/mcp` endpoint with JSON-RPC 2.0 protocol.

### Available Tools (36 total)

#### Orders (5 tools)
- `list_orders` - List orders with filters (status, date, marketplace)
- `get_order` - Get detailed order information
- `create_order` - Create a new order
- `update_order` - Update order status, addresses, notes
- `delete_order` - Delete an order

#### Products (5 tools)
- `list_products` - List products with filters (brand, condition, tags)
- `get_product` - Get detailed product information by SKU
- `create_product` - Create a new product
- `update_product` - Update product details
- `delete_product` - Delete a product

#### Inventory (3 tools)
- `list_inventory` - List inventory levels across warehouses
- `get_inventory` - Get inventory details for a location
- `adjust_inventory` - Adjust stock levels with reason codes

#### Customers (5 tools)
- `list_customers` - List customers with filters
- `get_customer` - Get detailed customer information
- `create_customer` - Create a new customer
- `update_customer` - Update customer details
- `delete_customer` - Delete a customer

#### Shipments (4 tools)
- `list_shipments` - List shipments with filters
- `get_shipment` - Get shipment tracking details
- `create_shipment` - Create a new shipment
- `update_shipment` - Update tracking, status

#### Warehouses (2 tools)
- `list_warehouses` - List all warehouses
- `get_warehouse` - Get warehouse details with stock summary

#### Workflows (3 tools)
- `list_workflows` - List available automations
- `trigger_workflow` - Manually trigger a workflow
- `get_workflow_run` - Check workflow run status

#### Analytics (4 tools)
- `get_sales_summary` - Revenue and order counts by period
- `get_top_products` - Best sellers by revenue or quantity
- `get_low_stock_alerts` - Products below reorder point
- `get_order_stats` - Order counts by status and fulfillment

#### Other (5 tools)
- `list_marketplace_connections` - Connected marketplaces and sync status
- `search` - Unified search across orders, products, customers
- `create_stock_transfer` - Move inventory between warehouses
- `list_stock_transfers` - List pending/completed transfers
- `health_check` - MCP server health status

### MCP Authentication
Use an API key with MCP-specific scopes:
- `mcp:read` - Read-only access to data
- `mcp:write` - Create, update, delete operations
- `mcp:analytics` - Sales and inventory analytics
- `mcp:workflow` - Trigger and monitor workflows
- `mcp:admin` - Full administrative access

### Example Usage (Claude Desktop)
```json
{
  "mcpServers": {
    "mpl": {
      "command": "npx",
      "args": ["@mpl/mcp-server"],
      "env": {
        "MPL_API_KEY": "mpl_your_key_here",
        "MPL_API_URL": "https://api.mplabs.co.uk"
      }
    }
  }
}
```

### Example Queries
- "What orders came in today?"
- "Show me low stock items"
- "How much did we sell this month?"
- "Create an order for customer John Smith"
- "Track shipment SHP-12345"

## Pricing
- Starter: £200/month (1,000 orders, 5 channels)
- Pro: £600/month (10,000 orders, unlimited channels, MCP access)
- Enterprise: Custom pricing
- Agency: £1,000/month (5 client accounts included)

## Company Info
- Company: Marketplace Labs Ltd
- Company Number: 13706932
- Location: 85 Great Portland Street, London, W1W 7LT, UK

## Links
- Website: https://commerciv.es
- For Brands: https://commerciv.es/brands
- For Agencies: https://commerciv.es/agencies
- Pricing: https://commerciv.es/pricing
- Developers: https://commerciv.es/developers
- Contact: https://commerciv.es/contact