MCP server

KiotViet MCP by usefulapi

io.usefulapi/kiotviet

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

Read KiotViet products, customers, invoices, orders and stock; create customers and orders.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

29

Token cost

About 7,802 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 kiotviet https://kiotviet.usefulapi.io/mcp

Claude Desktop

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

Codex (config.toml)

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

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add kiotviet https://kiotviet.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":"kiotviet","server_url":"https://kiotviet.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

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

Tools

• kiotviet_create_customer ~436 tokens
  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_create_order Moves money · ~533 tokens
  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_get_category ~107 tokens
  One product category by id (name, parent, children). GET /categories/{id}.
• kiotviet_get_customer ~114 tokens
  One customer by id: contact data, debt, total invoiced, reward points, groups. GET /customers/{id}.
• kiotviet_get_customer_by_code ~96 tokens
  One customer by customer code. GET /customers/code/{code}.
• kiotviet_get_invoice ~107 tokens
  One invoice by id with its lines, payments and delivery. GET /invoices/{id}.
• kiotviet_get_invoice_by_code ~101 tokens
  One invoice by invoice code (for example HD000123). GET /invoices/code/{code}.
• kiotviet_get_order ~105 tokens
  One sales order by id with its lines, payments and delivery. GET /orders/{id}.
• kiotviet_get_order_by_code ~100 tokens
  One sales order by order code (for example DH000123). GET /orders/code/{code}.
• kiotviet_get_price_book ~196 tokens
  The product prices of one price book (product id, code, price), paged. GET /pricebooks/{id}.
• kiotviet_get_product ~126 tokens
  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 ~98 tokens
  One product by its product code (SKU). GET /products/code/{code}.
• kiotviet_get_purchase_order ~115 tokens
  One goods receipt (nhap hang) by id with its lines. GET /purchaseorders/{id}.
• kiotviet_get_return ~101 tokens
  One customer return by id with its lines. GET /returns/{id}.
• kiotviet_get_supplier ~98 tokens
  One supplier by id. GET /suppliers/{id}.
• kiotviet_list_branches ~157 tokens
  List the shop's branches (id, name, code, phone, address). Use the ids to filter other tools. GET /branches.
• kiotviet_list_cashflow ~435 tokens
  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_categories ~313 tokens
  List product categories (id, name, parent, whether it has children). Set hierarchical to get the category tree. GET /categories.
• kiotviet_list_customers ~484 tokens
  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_list_invoices ~667 tokens
  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_list_orders ~704 tokens
  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_list_price_books ~221 tokens
  List price books (bang gia: name, active flag, validity dates, branches, customer groups). GET /pricebooks.
• kiotviet_list_products ~517 tokens
  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_list_purchase_orders ~416 tokens
  List goods receipts from suppliers (nhap hang: code, date, branch, supplier, total, lines). Filter by branch, status or purchase-date range. GET /purchaseorders.
• kiotviet_list_returns ~293 tokens
  List customer returns (code, date, branch, customer, invoice, return total, lines). GET /returns.
• kiotviet_list_stock ~328 tokens
  Stock on hand and reserved quantity per product and branch. Filter by branch or last change. GET /productOnHands.
• kiotviet_list_supplier_orders ~323 tokens
  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_suppliers ~364 tokens
  List suppliers (code, name, phone, email, address, debt, total invoiced). Filter by code, name, phone or last change. GET /suppliers.
• kiotviet_list_users ~147 tokens
  List the shop's staff users (id, username, name, phone, email). GET /users.

Browse

• Email
• Payments
• Invoicing and accounting

Related MCP servers

• Sellasist MCP by usefulapi
  Read Sellasist orders, products, stock, customers, invoices, returns; add order notes, set status.
• Cin7 Core MCP by usefulapi
  Read Cin7 Core products, stock by location, sales, purchases, customers, suppliers and transfers.
• Unleashed Software MCP by usefulapi
  Check products, stock on hand, customers, orders, invoices and quotes, and create records.
• Bind ERP MCP by usefulapi
  Read Bind ERP clients, products, inventory, invoices, orders; create prospects, clients, orders.
• Finale Inventory MCP by usefulapi
  Read Finale Inventory products, stock, orders and shipments; create draft purchase orders.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• Smaregi MCP by usefulapi
  Read Smaregi stores, products, customers, stock and transactions; manage customers, products, stock.
• Sapo MCP by usefulapi
  Read Sapo store products, orders, customers and stock levels; edit order notes and stock.

Badge for your README

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

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