# Smaregi MCP by usefulapi

> Smaregi MCP by usefulapi is an MCP server. Read Smaregi stores, products, customers, stock and transactions; manage customers, products, stock. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/smaregi/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/smaregi
- **MCP Registry name:** io.usefulapi/smaregi
- **Listing updated:** 2026-11-13

## About

Read Smaregi stores, products, customers, stock and transactions; manage customers, products, stock.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http smaregi https://smaregi.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://smaregi.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "smaregi": {
      "url": "https://smaregi.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "smaregi": {
      "type": "http",
      "url": "https://smaregi.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "smaregi": {
      "serverUrl": "https://smaregi.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "smaregi": {
      "type": "http",
      "url": "https://smaregi.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `smaregi_list_stores`: List the stores (shops) of the Smaregi contract: id, code, name, address, phone. Use the ids to filter stock and transactions. GET /stores.
- `smaregi_get_store`: One store by id. GET /stores/{store_id}.
- `smaregi_list_staffs`: List staff members: id, code, name, role, e-mail. Passwords are never returned. GET /staffs.
- `smaregi_get_staff`: One staff member by id. GET /staffs/{staff_id}.
- `smaregi_list_categories`: List product categories (departments): id, code, name, parent, level. Use the ids when creating or filtering products. GET /categories.
- `smaregi_get_category`: One product category by id. GET /categories/{category_id}.
- `smaregi_list_products`: List products with id, category, code, name, price, cost and update time. Filter by category, code, group code, display flag or update time (a 31-day maximum range). GET /products.
- `smaregi_get_product`: One product by id, optionally with store prices, bundled items, store assignments, reserved stock, attribute items and order settings. GET /products/{product_id}.
- `smaregi_list_customers`: List customers (members): id, code, number, name, phone, e-mail, address. Smaregi cannot search by name, phone or e-mail: filter by customer code, member number, id range or update time, or page through. Contains shoppers' personal data. GET /customers.
- `smaregi_get_customer`: One customer by id, optionally with the contract's custom fields. Contains personal data. GET /customers/{customer_id}.
- `smaregi_list_stock`: List stock levels per store and product (stockAmount, reserved amount). Filter by store or product. Smaregi only lists a product once its quantity has changed at least once. An update-time filter needs both bounds (31 days at most). GET /stock.
- `smaregi_list_stock_changes`: The stock change history of one product in one store: date, amount, division (sale, purchase, transfer, adjustment...). GET /stock/changes/{product_id}/{store_id}.
- `smaregi_list_transactions`: List sales transactions (receipts) in a time window of at most 31 days: id, date-time, division (1 = normal sale, 2 = deposit, 3 = withdrawal...), store, terminal, customer, totals. Optionally with the line items (limit 100 then). Contains shoppers' personal data. GET /transactions.
- `smaregi_get_transaction`: One transaction (receipt) by its transaction id (transactionHeadId), optionally with line items, discounts and payments. Contains personal data. GET /transactions/{transaction_id}.
- `smaregi_create_customer`: WRITE: create a customer (member). customerCode, firstName and lastName are required; the contract's own required-column settings may demand more. Not idempotent: calling twice with a different code creates two customers. POST /customers.
- `smaregi_update_customer`: WRITE: change fields of one customer (only the fields you pass are changed). Overwrites the old values. PATCH /customers/{customer_id}.
- `smaregi_create_product`: WRITE: create a product. categoryId, productName and price are required. Not idempotent. POST /products.
- `smaregi_update_product`: WRITE: change fields of one product (only the fields you pass are changed), for example its price or name. Overwrites the old values. PATCH /products/{product_id}.
- `smaregi_set_stock`: WRITE: set the absolute stock quantity of one product in one store, replacing the current quantity. Use smaregi_adjust_stock for a relative change. PATCH /stock/{product_id}.
- `smaregi_adjust_stock`: WRITE: add (positive) or subtract (negative) a quantity to the stock of one product in one store. Not idempotent: a repeat applies the change again. POST /stock/{product_id}/add.

## FAQ

### How do I add Smaregi MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http smaregi https://smaregi.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/smaregi-mcp-by-usefulapi
