MCP server

Smaregi MCP by usefulapi

io.usefulapi/smaregi

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

20

Token cost

About 9,284 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.smaregi]
url = "https://smaregi.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"smaregi":{"httpUrl":"https://smaregi.usefulapi.io/mcp"}}}

Cursor

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

VS Code

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

Antigravity

agy mcp add smaregi https://smaregi.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"smaregi","server_url":"https://smaregi.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"smaregi","server_url":"https://smaregi.usefulapi.io/mcp"}

Tools

• smaregi_adjust_stock ~284 tokens
  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.
• smaregi_create_customer ~967 tokens
  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_create_product ~880 tokens
  WRITE: create a product. categoryId, productName and price are required. Not idempotent. POST /products.
• smaregi_get_category ~188 tokens
  One product category by id. GET /categories/{category_id}.
• smaregi_get_customer ~230 tokens
  One customer by id, optionally with the contract's custom fields. Contains personal data. GET /customers/{customer_id}.
• smaregi_get_product ~299 tokens
  One product by id, optionally with store prices, bundled items, store assignments, reserved stock, attribute items and order settings. GET /products/{product_id}.
• smaregi_get_staff ~183 tokens
  One staff member by id. GET /staffs/{staff_id}.
• smaregi_get_store ~181 tokens
  One store by id. GET /stores/{store_id}.
• smaregi_get_transaction ~216 tokens
  One transaction (receipt) by its transaction id (transactionHeadId), optionally with line items, discounts and payments. Contains personal data. GET /transactions/{transaction_id}.
• smaregi_list_categories ~288 tokens
  List product categories (departments): id, code, name, parent, level. Use the ids when creating or filtering products. GET /categories.
• smaregi_list_customers ~577 tokens
  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_list_products ~565 tokens
  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_list_staffs ~274 tokens
  List staff members: id, code, name, role, e-mail. Passwords are never returned. GET /staffs.
• smaregi_list_stock ~486 tokens
  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 ~493 tokens
  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_stores ~288 tokens
  List the stores (shops) of the Smaregi contract: id, code, name, address, phone. Use the ids to filter stock and transactions. GET /stores.
• smaregi_list_transactions ~676 tokens
  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_set_stock ~274 tokens
  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_update_customer ~985 tokens
  WRITE: change fields of one customer (only the fields you pass are changed). Overwrites the old values. PATCH /customers/{customer_id}.
• smaregi_update_product ~950 tokens
  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}.

Browse

• Email
• Payments

Related MCP servers

• Sapo MCP by usefulapi
  Read Sapo store products, orders, customers and stock levels; edit order notes and stock.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Cin7 Core MCP by usefulapi
  Read Cin7 Core products, stock by location, sales, purchases, customers, suppliers and transfers.
• Ecwid MCP by usefulapi
  Read store products, orders, customers, categories and coupons; adjust inventory and update orders.
• Foxy.io MCP by usefulapi
  Read Foxy transactions, subscriptions, customers, carts and coupons; update customers and subs.
• Veeqo MCP by usefulapi
  Read Veeqo orders, products, stock, warehouses, customers and POs; add notes, tag, set stock.
• Laudus MCP by usefulapi
  Read Laudus ERP customers, sales, purchases, stock and accounting reports; create customers.
• Lightspeed Retail (X-Series) MCP by usefulapi
  Read Lightspeed X-Series products, stock, sales, customers, stock orders; one-call sales reports.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/smaregi.svg)](https://aptlynx.net/servers/io.usefulapi/smaregi)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents