LeadCommerce MCP Server Reference

The LeadCommerce MCP Server exposes inventory, order, and SKU data as tools and resources for AI assistants via the Model Context Protocol.

Tools allow an AI to query live data. Resources provide reference documentation for every API domain so the AI can write raw GraphQL for any operation not covered by a built-in tool.

MCP Endpoint
POST https://mcp.leadcommerce.com/mcp
Health Check
GET https://mcp.leadcommerce.com/health
API Documentation
https://api.leadcommerce.com

Authentication

Every request to /mcp must include your LeadCommerce API key as a Bearer token.

Getting an API Key

Navigate to Settings → System Configuration → Global Settings, or open the link below and click Global Settings:

https://app.leadcommerce.com/general-settings

Under Generate API Keys, select the user and click Generate Key. Copy the key — it is only shown once.

Note: Your user role must have permission to create API Keys. Contact your system administrator if the option is unavailable.

Full API reference: api.leadcommerce.com

Request Header
Authorization: Bearer YOUR_LEADCOMMERCE_API_KEY
cURL Example
curl -X POST https://mcp.leadcommerce.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Tools

Tools allow an AI assistant to query live LeadCommerce data. Each tool call is authenticated with the caller's own API key and returns live results from the GraphQL API.

Tools

search_sales_orders

Search sales orders with optional filters. Returns a list of matching orders.

status:
string

Filter by status name (e.g. "Open", "Closed", "Shipped")

customerName:
string

Filter by customer name (partial match)

referenceNumber:
string

Filter by order reference / PO number

dateFrom:
string

Orders created on or after this date (YYYY-MM-DD)

dateTo:
string

Orders created on or before this date (YYYY-MM-DD)

limit:
number

Max results to return (default 20)

Returns
{ "data": { "salesOrders": [ { "id": 0, "referenceNumber": "string", "status": { "name": "string" }, "customer": { "name": "string" }, "total": 0 } ] } }
Tools

get_sales_order

Fetch a single sales order by ID, including all line items.

id:
number *required

The numeric sales order ID

Returns
{ "data": { "salesOrder": { "id": 0, "referenceNumber": "string", "status": { "name": "string" }, "salesLineItems": [] } } }
Tools

search_skus

Search SKUs (products) with optional filters.

name:
string

Filter by SKU name (partial match)

sku:
string

Filter by SKU code (partial match)

vendorId:
number

Filter by vendor ID

limit:
number

Max results to return (default 20)

Returns
{ "data": { "skus": [ { "id": 0, "name": "string", "sku": "string", "price": 0, "cost": 0, "isActive": true } ] } }
Tools

get_inventory

Get stock levels for SKUs. Returns on-hand, available, allocated, and incoming quantities.

skuId:
number

Filter by a specific SKU ID

warehouseId:
number

Filter by a specific warehouse ID

limit:
number

Max results to return (default 50)

Returns
{ "data": { "stockLevels": [ { "id": 0, "onHand": 0, "available": 0, "allocated": 0, "incoming": 0, "sku": { "name": "string" }, "warehouse": { "name": "string" } } ] } }
Tools

get_work_orders

Search work orders with optional filters. Returns work orders with assembly progress.

status:
string

Filter by status (e.g. "Open", "In Progress", "Completed")

skuId:
number

Filter by the SKU being assembled

limit:
number

Max results to return (default 20)

Returns
{ "data": { "workOrders": [ { "id": 0, "status": { "name": "string" }, "workOrderLineItems": [] } ] } }

Resources

Resources expose the full LeadCommerce API domain reference as readable context. When an AI needs to perform an operation not covered by a built-in tool, it reads the relevant resource to learn the GraphQL query or mutation to use, then calls it directly against the GraphQL endpoint.

Resources use the URI scheme lcx://api/<domain-slug>.

GraphQL Endpoint
https://app.leadcommerce.com/graphql
GraphiQL Explorer
https://app.leadcommerce.com/graphiql
Resources

lcx://api/authentication

How to obtain and use a LeadCommerce API key.

URI
lcx://api/authentication
Resources

lcx://api/accounts

Manage your LeadCommerce account. (query.account)

URI
lcx://api/accounts
Resources

lcx://api/customers

Manage customers. CRUD via query.customers / mutation.createCustomer / updateCustomer / deleteCustomer.

URI
lcx://api/customers
Resources

lcx://api/inventory

Manage SKUs, lots, stock levels, and adjustments. Includes BOM, aggregation, and stock history.

URI
lcx://api/inventory
Resources

lcx://api/sales-orders

Manage sales orders. Create, update, invoice, ship, pay, return, and duplicate orders.

URI
lcx://api/sales-orders
Resources

lcx://api/purchase-orders

Manage purchase orders sent to vendors.

URI
lcx://api/purchase-orders
Resources

lcx://api/work-orders

Assemble finished goods from components. Critical: pass BASE BOM quantity, not total. See resource for full nuances.

URI
lcx://api/work-orders
Resources

lcx://api/shipments

Fetch shipments. Filter by salesOrderIDs, packageIds, isShipped, warehouseIds, date ranges.

URI
lcx://api/shipments
Resources

lcx://api/invoices

Fetch and consolidate invoices. Filter by customerIds, isPaid, statusId, date ranges.

URI
lcx://api/invoices
Resources

lcx://api/payments

Fetch payments. Filter by customerIds, source, date ranges.

URI
lcx://api/payments
Resources

lcx://api/returns

Manage RMAs. Fetch, filter, and receive returns to restock inventory.

URI
lcx://api/returns
Resources

lcx://api/transfers

Manage inventory transfers between warehouses.

URI
lcx://api/transfers
Resources

lcx://api/warehouses

Manage warehouses and their settings.

URI
lcx://api/warehouses
Resources

lcx://api/vendors

Manage vendors.

URI
lcx://api/vendors
Resources

lcx://api/users

Manage users in your account.

URI
lcx://api/users
Resources

lcx://api/ship-station

Get carriers, rates, and sync orders with ShipStation.

URI
lcx://api/ship-station
Resources

lcx://api/line-items

Manage line items (SKU + warehouse combinations). Required before creating work orders.

URI
lcx://api/line-items
Resources

lcx://api/products

Manage products (groupings above SKUs).

URI
lcx://api/products
Resources

lcx://api/bin-locations

Manage bin locations within warehouses.

URI
lcx://api/bin-locations
Resources

lcx://api/cost-rules

Manage cost rules for SKUs.

URI
lcx://api/cost-rules
Resources

lcx://api/price-rules

Manage price rules for SKUs.

URI
lcx://api/price-rules
Resources

lcx://api/labels

Manage labels.

URI
lcx://api/labels
Resources

lcx://api/filters

Manage module filters.

URI
lcx://api/filters
Resources

lcx://api/custom-fields

Manage custom fields.

URI
lcx://api/custom-fields
Resources

lcx://api/history

Audit log of record changes.

URI
lcx://api/history
Resources

lcx://api/user-roles

Manage user roles and permissions.

URI
lcx://api/user-roles
Resources

lcx://api/addresses

Manage addresses.

URI
lcx://api/addresses

MCP Client Configuration

This server implements the Model Context Protocol over HTTP with Streamable HTTP transport. Any MCP-compatible client can connect using the endpoint and auth header below.

Server URL
https://mcp.leadcommerce.com/mcp
Required Header
Authorization: Bearer YOUR_LEADCOMMERCE_API_KEY
MCP Clients

Claude Desktop

Open your Claude Desktop config file and add the leadcommerce entry under mcpServers.

Config file location:

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

Restart Claude Desktop after saving. The LeadCommerce tools will appear in the tools menu.

claude_desktop_config.json
{
  "mcpServers": {
    "leadcommerce": {
      "url": "https://mcp.leadcommerce.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LEADCOMMERCE_API_KEY"
      }
    }
  }
}
MCP Clients

Cursor

Open Cursor Settings → MCP and click Add new MCP server. Set the transport to HTTP, enter the server URL, and add the Authorization header.

Alternatively, add directly to ~/.cursor/mcp.json.

~/.cursor/mcp.json
{
  "mcpServers": {
    "leadcommerce": {
      "url": "https://mcp.leadcommerce.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LEADCOMMERCE_API_KEY"
      }
    }
  }
}
MCP Clients

Windsurf (Codeium)

Open Windsurf Settings → MCP Servers and add a new server, or edit the config file directly at ~/.codeium/windsurf/mcp_config.json.

mcp_config.json
{
  "mcpServers": {
    "leadcommerce": {
      "serverUrl": "https://mcp.leadcommerce.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_LEADCOMMERCE_API_KEY"
      }
    }
  }
}
MCP Clients

n8n

Use the MCP Client Tool node in an n8n AI Agent workflow.

  1. Add an AI Agent node to your workflow
  2. Under Tools, add a MCP Client Tool node
  3. Set SSE URL to https://mcp.leadcommerce.com/mcp
  4. Under Authentication, select Header Auth and set header Authorization to Bearer YOUR_LEADCOMMERCE_API_KEY
MCP Client Tool Node
SSE URL:
  https://mcp.leadcommerce.com/mcp

Authentication: Header Auth
  Name:  Authorization
  Value: Bearer YOUR_LEADCOMMERCE_API_KEY
MCP Clients

Other MCP Clients

Any client supporting MCP over Streamable HTTP transport can connect. Configure with:

  • Transport: Streamable HTTP (or HTTP+SSE)
  • URL: https://mcp.leadcommerce.com/mcp
  • Auth header: Authorization: Bearer YOUR_LEADCOMMERCE_API_KEY

See the MCP transport documentation for details on the protocol.

Test with curl
curl -X POST https://mcp.leadcommerce.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'