> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# iCommerce MCP Server

> 719 tools across 63 domains — run the whole commerce engine from an MCP host.

# iCommerce MCP Server

The largest MCP surface StateSet ships: **719 tools across 63 domains**, exposing the embedded
commerce engine to an MCP host.

Three servers come with the CLI:

| Server              | Tools   | Purpose                                                                   |
| ------------------- | ------- | ------------------------------------------------------------------------- |
| `stateset-commerce` | **719** | The commerce engine — orders, inventory, finance, manufacturing, and more |
| `stateset-scaffold` | 13      | Project scaffolding                                                       |
| `stateset-x402`     | 5       | x402 paid API calls                                                       |

## Connect

```json theme={null}
{
  "mcpServers": {
    "stateset-commerce": {
      "command": "npx",
      "args": ["-y", "@stateset/cli@latest", "stateset-mcp-events"],
      "env": { "DB_PATH": "./store.db" }
    }
  }
}
```

`DB_PATH` points at the SQLite database the engine carries. Because the engine is embedded, the
agent operates directly against that file — no server to run and no network hop.

<Tip>
  Point `DB_PATH` at a **copy** of your database the first time you connect an agent. With 287
  write, 47 admin, and 21 delete tools available, a mistaken call is easier to recover from when
  the original is untouched.
</Tip>

## Permission profile

Worth understanding before you hand this to an agent:

| Permission | Tools |
| ---------- | ----- |
| `read`     | 382   |
| `write`    | 287   |
| `admin`    | 47    |
| `delete`   | 21    |

<Warning>
  Roughly **half** the surface mutates state, and 21 tools delete. The engine's own safeguards
  still apply — idempotency keys are required on order and payment writes, and High-Value Action
  thresholds gate large amounts — but scope the agent to the domains it actually needs rather than
  granting the full catalog.
</Warning>

## Domain coverage

The 63 domains span the whole engine:

**Commerce** — customers with address books, products with variants and lifecycle, orders,
carts and checkout, returns and the full RMA workflow, warranties, subscriptions, gift cards,
loyalty, store credits, reviews, wishlists, customer segments.

**Finance** — general ledger with journals and periods, accounts payable and receivable, fixed
assets, revenue recognition, invoices, payments, refunds, tax, prepayments, vendor credits,
price schedules and levels.

**Operations** — inventory and stock snapshots, warehouses and locations, cycle counts,
purchase orders and suppliers, transfer orders, inbound shipments, fulfillment waves and pick
tasks, shipping zones, lots and serial numbers.

**Manufacturing** — bills of materials, work orders, production batches, quality inspections
and NCRs.

**Infrastructure** — activity logs, channels, companies, units of measure, integration and field
mappings, EDI documents, topology snapshots, search config, and ERC-8004 identity, reputation,
and validation.

See [Finance & Accounting](/stateset-icommerce/stateset-icommerce-finance) and
[Bindings](/stateset-icommerce/stateset-icommerce-bindings) for what these domains do.

## Maintenance and recovery

Five tools cover backup and restore, so an agent can back up the engine it carries before doing
something consequential. See [Backup & Restore](/stateset-icommerce/stateset-icommerce-backup-restore)
— in particular that import is content-preserving, not identity-preserving.

## Money values

Every monetary amount crosses as an **exact decimal string** (`"30.01"`), not a float. Don't
parse into a binary float before arithmetic.

<Note>
  This holds for the MCP surface and the newer binding domains. Some older *binding* fields still
  convert to `f64` — see the [money precision warning](/stateset-icommerce/stateset-icommerce-bindings#money-precision).
</Note>

## Related

* [iCommerce Quickstart](/stateset-icommerce/stateset-icommerce-quickstart)
* [CLI Reference](/stateset-icommerce/stateset-icommerce-cli-reference)
* [All MCP servers](/mcp-servers)