MCP server
KiotViet MCP by usefulapi
Read KiotViet products, customers, invoices, orders and stock; create customers and…
- Runs
- Remotely
- Version
- 1.16.0
- Listing updated
- 1 day ago
About KiotViet MCP by usefulapi
KiotViet MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read KiotViet products, customers, invoices, orders and stock; create customers and orders.
Install
Run in a terminal
claude mcp add --transport http kiotviet https://kiotviet.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://kiotviet.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"kiotviet": {
"url": "https://kiotviet.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"kiotviet": {
"type": "http",
"url": "https://kiotviet.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"kiotviet": {
"serverUrl": "https://kiotviet.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"kiotviet": {
"type": "http",
"url": "https://kiotviet.usefulapi.io/mcp"
}
}
}Tools this server provides (29)
Read directly from the server.
- kiotviet_list_products
- List products (code, barcode, name, category, base price, units, attributes). Optionally include stock per branch (include_inventory) and price-book prices. Filter by name, category, branch, active flag or last change. GET /products.
- kiotviet_get_product
- One product by id: code, barcode, name, category, base price, units, attributes, images, stock per branch and price books. GET /products/{id}.
- kiotviet_get_product_by_code
- One product by its product code (SKU). GET /products/code/{code}.
- kiotviet_list_categories
- List product categories (id, name, parent, whether it has children). Set hierarchical to get the category tree. GET /categories.
- kiotviet_get_category
- One product category by id (name, parent, children). GET /categories/{id}.
- kiotviet_list_customers
- List customers (code, name, phone, email, address, debt, total invoiced, reward points, groups). Contains personal data of the shop's customers. Filter by code, name, phone, group or last change. GET /customers.
- kiotviet_get_customer
- One customer by id: contact data, debt, total invoiced, reward points, groups. GET /customers/{id}.
- kiotviet_get_customer_by_code
- One customer by customer code. GET /customers/code/{code}.
- kiotviet_create_customer
- WRITE: create a new customer in the shop (name required; code is generated by KiotViet if omitted). Always check with the user first, and look the customer up by phone before creating a duplicate. POST /customers.
- kiotviet_list_invoices
- List sales invoices (code, date, branch, customer, total, amount paid, status, lines). Filter by branch, customer, status, order, purchase-date range or last change. GET /invoices.
- kiotviet_get_invoice
- One invoice by id with its lines, payments and delivery. GET /invoices/{id}.
- kiotviet_get_invoice_by_code
- One invoice by invoice code (for example HD000123). GET /invoices/code/{code}.
- kiotviet_list_orders
- List sales orders (code, date, branch, customer, total, status, lines, delivery). Filter by branch, customer, status, creation date (from) or last change (from/to). GET /orders.
- kiotviet_get_order
- One sales order by id with its lines, payments and delivery. GET /orders/{id}.
- kiotviet_get_order_by_code
- One sales order by order code (for example DH000123). GET /orders/code/{code}.
- kiotviet_create_order
- WRITE: create a sales order (an order, not an invoice: no invoice is made and no payment is recorded) with lines of existing products in a branch, for an existing customer or none. Always confirm the products, quantities and prices with the user first. POST /orders.
- kiotviet_list_branches
- List the shop's branches (id, name, code, phone, address). Use the ids to filter other tools. GET /branches.
- kiotviet_list_stock
- Stock on hand and reserved quantity per product and branch. Filter by branch or last change. GET /productOnHands.
- kiotviet_list_suppliers
- List suppliers (code, name, phone, email, address, debt, total invoiced). Filter by code, name, phone or last change. GET /suppliers.
- kiotviet_get_supplier
- One supplier by id. GET /suppliers/{id}.
- kiotviet_list_purchase_orders
- List goods receipts from suppliers (nhap hang: code, date, branch, supplier, total, lines). Filter by branch, status or purchase-date range. GET /purchaseorders.
- kiotviet_get_purchase_order
- One goods receipt (nhap hang) by id with its lines. GET /purchaseorders/{id}.
- kiotviet_list_supplier_orders
- List orders placed with suppliers (dat hang nhap: code, date, branch, supplier, status, lines, amount paid). Filter by branch, status, supplier or product text. GET /ordersuppliers.
- kiotviet_list_returns
- List customer returns (code, date, branch, customer, invoice, return total, lines). GET /returns.
- kiotviet_get_return
- One customer return by id with its lines. GET /returns/{id}.
- kiotviet_list_cashflow
- List cash-book entries (receipts and payments: code, branch, method, partner, amount, date, status). Filter by branch, direction or date range. GET /cashflow.
- kiotviet_list_users
- List the shop's staff users (id, username, name, phone, email). GET /users.
- kiotviet_list_price_books
- List price books (bang gia: name, active flag, validity dates, branches, customer groups). GET /pricebooks.
- kiotviet_get_price_book
- The product prices of one price book (product id, code, price), paged. GET /pricebooks/{id}.
KiotViet MCP by usefulapi FAQ
How do I add KiotViet MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http kiotviet https://kiotviet.usefulapi.io/mcp