Bind ERP MCP by usefulapi is an MCP server published by io.usefulapi, hosted at bind-erp.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 26 tools, including binderp_get_account, binderp_list_catalog, binderp_list_clients, binderp_get_client, binderp_get_client_addresses.
Read Bind ERP clients, products, inventory, invoices, orders; create prospects, clients, orders.
4,167 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The Bind ERP user and company this API key belongs to: user name, email, roles, branches (locations), company name, RFC (tax id), legal/commercial name, fiscal type and address. GET /api/UserProfile and /api/CompanyProfile.
No parameters.
{
"name": "binderp_get_account",
"title": "Get account",
"description": "The Bind ERP user and company this API key belongs to: user name, email, roles, branches (locations), company name, RFC (tax id), legal/commercial name, fiscal type and address. GET /api/UserProfile and /api/CompanyProfile.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List one of the reference catalogs whose ids other tools need: locations (branches), warehouses, price_lists, currencies, bank_accounts (with balances), users (employees) or categories. GET /api/Locations, /api/Warehouses, /api/PriceLists, /api/Currencies, /api/BankAccounts, /api/Users, /api/Categories.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. Name eq 'Main'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| catalog * | string | Which catalog. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_catalog",
"title": "List catalog (branches, warehouses, price lists, currencies, bank accounts, users, categories)",
"description": "List one of the reference catalogs whose ids other tools need: locations (branches), warehouses, price_lists, currencies, bank_accounts (with balances), users (employees) or categories. GET /api/Locations, /api/Warehouses, /api/PriceLists, /api/Currencies, /api/BankAccounts, /api/Users, /api/Categories.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"catalog"
],
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. Name eq 'Main'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"catalog": {
"enum": [
"locations",
"warehouses",
"price_lists",
"currencies",
"bank_accounts",
"users",
"categories"
],
"type": "string",
"description": "Which catalog."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List catalog",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List customers: id, number, name, legal name, RFC, email, phone, next contact date and branch. Filter with OData, e.g. substringof('acme', ClientName). GET /api/Clients.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. substringof('acme', ClientName). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_clients",
"title": "List clients",
"description": "List customers: id, number, name, legal name, RFC, email, phone, next contact date and branch. Filter with OData, e.g. substringof('acme', ClientName). GET /api/Clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. substringof('acme', ClientName). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List clients",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One customer with credit terms (days and limit), payment method, price list, branch, sales and credit contacts, discount, account number and addresses. GET /api/Clients/{id}.
| Parameter | Type | Description |
|---|---|---|
| client_id * | string | Client id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_client",
"title": "Get client",
"description": "One customer with credit terms (days and limit), payment method, price list, branch, sales and credit contacts, discount, account number and addresses. GET /api/Clients/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Client id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get client",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The addresses of a customer, with the ids that an order needs as address_id. GET /api/Clients/{id}/Addresses.
| Parameter | Type | Description |
|---|---|---|
| client_id * | string | Client id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_client_addresses",
"title": "Get client addresses",
"description": "The addresses of a customer, with the ids that an order needs as address_id. GET /api/Clients/{id}/Addresses.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id"
],
"properties": {
"client_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Client id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get client addresses",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List sales prospects (leads): id, name, company, email, phone and salesperson. GET /api/Prospects.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. substringof('maria', ProspectName). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_prospects",
"title": "List prospects",
"description": "List sales prospects (leads): id, name, company, email, phone and salesperson. GET /api/Prospects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. substringof('maria', ProspectName). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List prospects",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One prospect: name, company, email, phone, comments, creation date and owner. GET /api/Prospects/{id}.
| Parameter | Type | Description |
|---|---|---|
| prospect_id * | string | Prospect id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_prospect",
"title": "Get prospect",
"description": "One prospect: name, company, email, phone, comments, creation date and owner. GET /api/Prospects/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"prospect_id"
],
"properties": {
"prospect_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Prospect id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get prospect",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List suppliers: id, number, name, legal name, RFC, email, phone and city. GET /api/Providers.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. substringof('acero', ProviderName). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_providers",
"title": "List providers (suppliers)",
"description": "List suppliers: id, number, name, legal name, RFC, email, phone and city. GET /api/Providers.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. substringof('acero', ProviderName). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List providers",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List products: id, code, title, SKU, cost, current inventory, VAT flag, unit, currency and categories. Filter with OData, e.g. substringof('tornillo', Title). GET /api/Products.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. SKU eq 'ABC-1'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_products",
"title": "List products",
"description": "List products: id, code, title, SKU, cost, current inventory, VAT flag, unit, currency and categories. Filter with OData, e.g. substringof('tornillo', Title). GET /api/Products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. SKU eq 'ABC-1'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One product with prices per price list, inventory per warehouse, categories and alternative units. GET /api/Products/{id}.
| Parameter | Type | Description |
|---|---|---|
| product_id * | string | Product id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_product",
"title": "Get product",
"description": "One product with prices per price list, inventory per warehouse, categories and alternative units. GET /api/Products/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Product id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get product",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Products with the price (from one price list) and stock (in one warehouse), VAT/IEPS, min/max and volume prices: the view a point-of-sale or quote needs. Get the ids from binderp_list_catalog. GET /api/ProductsPriceAndInventory.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| warehouse_id * | string | Warehouse id (catalog warehouses) (a GUID, as returned by the list tools). |
| price_list_id * | string | Price list id (catalog price_lists) (a GUID, as returned by the list tools). |
{
"name": "binderp_list_products_with_price_and_stock",
"title": "List products with price and stock",
"description": "Products with the price (from one price list) and stock (in one warehouse), VAT/IEPS, min/max and volume prices: the view a point-of-sale or quote needs. Get the ids from binderp_list_catalog. GET /api/ProductsPriceAndInventory.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"warehouse_id",
"price_list_id"
],
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"warehouse_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Warehouse id (catalog warehouses) (a GUID, as returned by the list tools)."
},
"price_list_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Price list id (catalog price_lists) (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "List products with price and stock",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Stock of every product in one warehouse: current inventory, balance, quantity on client orders and on purchase orders, value and SKU. Filter with OData, e.g. CurrentInventory lt 5 for low stock. GET /api/Inventory?warehouseID=.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. CurrentInventory lt 5. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
| warehouse_id * | string | Warehouse id (catalog warehouses) (a GUID, as returned by the list tools). |
{
"name": "binderp_get_inventory",
"title": "Get inventory by warehouse",
"description": "Stock of every product in one warehouse: current inventory, balance, quantity on client orders and on purchase orders, value and SKU. Filter with OData, e.g. CurrentInventory lt 5 for low stock. GET /api/Inventory?warehouseID=.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"warehouse_id"
],
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. CurrentInventory lt 5. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
},
"warehouse_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Warehouse id (catalog warehouses) (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get inventory",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List sales invoices, with series, number, date, client, RFC, subtotal, discount, taxes, total, payments received, credit notes, expiration date and status. Open balance = Total - Payments - CreditNotes (filter Total gt Payments, then subtract CreditNotes from the rows). GET /api/Invoices.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. Date ge datetime'2026-10-01T00:00:00' and Total gt Payments. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:0… |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_invoices",
"title": "List invoices (sales)",
"description": "List sales invoices, with series, number, date, client, RFC, subtotal, discount, taxes, total, payments received, credit notes, expiration date and status. Open balance = Total - Payments - CreditNotes (filter Total gt Payments, then subtract CreditNotes from the rows). GET /api/Invoices.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. Date ge datetime'2026-10-01T00:00:00' and Total gt Payments. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List invoices",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One sale with client, status, payment terms, branch, warehouse, currency, totals, payments, credit notes and its product and service lines. Takes the invoice GUID or its number. GET /api/Invoices/{idOrNumber}.
| Parameter | Type | Description |
|---|---|---|
| invoice_id_or_number * | string | The invoice GUID or its number. |
{
"name": "binderp_get_invoice",
"title": "Get invoice",
"description": "One sale with client, status, payment terms, branch, warehouse, currency, totals, payments, credit notes and its product and service lines. Takes the invoice GUID or its number. GET /api/Invoices/{idOrNumber}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id_or_number"
],
"properties": {
"invoice_id_or_number": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "The invoice GUID or its number."
}
}
},
"annotations": {
"title": "Get invoice",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}The payments registered against one invoice: date, account, amount, status and who registered them. GET /api/Invoices/Payment/{invoiceID}.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
| invoice_id * | string | Invoice id (a GUID, as returned by the list tools). |
{
"name": "binderp_list_invoice_payments",
"title": "List invoice payments",
"description": "The payments registered against one invoice: date, account, amount, status and who registered them. GET /api/Invoices/Payment/{invoiceID}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"invoice_id"
],
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
},
"invoice_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Invoice id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "List invoice payments",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List customer orders (pedidos): number, date, client, branch, warehouse, salesperson, currency, subtotals, taxes, total and status. GET /api/Orders.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. OrderDate ge datetime'2026-10-01T00:00:00'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_orders",
"title": "List sales orders",
"description": "List customer orders (pedidos): number, date, client, branch, warehouse, salesperson, currency, subtotals, taxes, total and status. GET /api/Orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. OrderDate ge datetime'2026-10-01T00:00:00'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One customer order with address, status, totals and its product and service lines. GET /api/Orders/{id}.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | Order id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_order",
"title": "Get order",
"description": "One customer order with address, status, totals and its product and service lines. GET /api/Orders/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id"
],
"properties": {
"order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Order id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List quotes (cotizaciones): number, date, client, branch, comments, total, currency and status. GET /api/Quotes.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. CreationDate ge datetime'2026-10-01T00:00:00'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_quotes",
"title": "List quotes",
"description": "List quotes (cotizaciones): number, date, client, branch, comments, total, currency and status. GET /api/Quotes.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. CreationDate ge datetime'2026-10-01T00:00:00'. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List quotes",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One quote with client or prospect, totals and its line items. GET /api/Quotes/{id}.
| Parameter | Type | Description |
|---|---|---|
| quote_id * | string | Quote id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_quote",
"title": "Get quote",
"description": "One quote with client or prospect, totals and its line items. GET /api/Quotes/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"quote_id"
],
"properties": {
"quote_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Quote id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get quote",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List purchase orders to suppliers: number, warehouse, provider, date, status, quantity ordered and still missing, total and currency. GET /api/Purchases/GetPurchaseOrders.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. substringof('acero', Provider). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_purchase_orders",
"title": "List purchase orders",
"description": "List purchase orders to suppliers: number, warehouse, provider, date, status, quantity ordered and still missing, total and currency. GET /api/Purchases/GetPurchaseOrders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. substringof('acero', Provider). Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List purchase orders",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}One purchase order with its product lines, quantities received and totals. GET /api/Purchases/{id}.
| Parameter | Type | Description |
|---|---|---|
| purchase_order_id * | string | Purchase order id (a GUID, as returned by the list tools). |
{
"name": "binderp_get_purchase_order",
"title": "Get purchase order",
"description": "One purchase order with its product lines, quantities received and totals. GET /api/Purchases/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"purchase_order_id"
],
"properties": {
"purchase_order_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Purchase order id (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Get purchase order",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}List CRM activities (calls, meetings, tasks): title, start and end, owner, done flag, type and the client or prospect they belong to. GET /api/Activities.
| Parameter | Type | Description |
|---|---|---|
| top | integer | Rows per page, 1-100 (default 25). |
| skip | integer | Rows to skip (default 0). Pass the previous reply's next_skip to get the next page. |
| filter | string | OData $filter, e.g. Done eq false. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'. |
| orderby | string | OData $orderby, e.g. 'Date desc' or 'Title'. |
{
"name": "binderp_list_activities",
"title": "List activities",
"description": "List CRM activities (calls, meetings, tasks): title, start and end, owner, done flag, type and the client or prospect they belong to. GET /api/Activities.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Rows per page, 1-100 (default 25)."
},
"skip": {
"type": "integer",
"maximum": 10000000,
"minimum": 0,
"description": "Rows to skip (default 0). Pass the previous reply's next_skip to get the next page."
},
"filter": {
"type": "string",
"maxLength": 1000,
"minLength": 1,
"description": "OData $filter, e.g. Done eq false. Text uses single quotes, functions such as substringof('abc', Field) and operators eq ne gt ge lt le and or are supported; a GUID is written guid'3f2504e0-4f89-11d3-9a0c-0305e82c3301'. Dates: datetime'2026-10-01T00:00:00'."
},
"orderby": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "OData $orderby, e.g. 'Date desc' or 'Title'."
}
}
},
"annotations": {
"title": "List activities",
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Create a sales prospect (lead) in Bind ERP. Writes a new record visible to the whole team; it is not deduplicated, so check binderp_list_prospects first. No message is sent to the prospect. POST /api/Prospects.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Contact name. |
| string | Email address. | |
| phone | string | Phone number. |
| company | string | Company name. |
| comments | string | Notes. |
| is_public | boolean | Visible to all users (true) or only to the key's user (false). |
| phone_ext | string | Phone extension. |
{
"name": "binderp_create_prospect",
"title": "Create prospect",
"description": "Create a sales prospect (lead) in Bind ERP. Writes a new record visible to the whole team; it is not deduplicated, so check binderp_list_prospects first. No message is sent to the prospect. POST /api/Prospects.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Contact name."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 200,
"description": "Email address."
},
"phone": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Phone number."
},
"company": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Company name."
},
"comments": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Notes."
},
"is_public": {
"type": "boolean",
"description": "Visible to all users (true) or only to the key's user (false)."
},
"phone_ext": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Phone extension."
}
}
},
"annotations": {
"title": "Create prospect",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a customer in Bind ERP. Writes a new customer record (with credit terms) and is not deduplicated: check binderp_list_clients for the RFC first. The RFC must be valid for the tax authority (use XAXX010101000 for a generic public customer). No message is sent. Get price_list_id and location_id from binderp_list_catalog. POST /api/Clients.
| Parameter | Type | Description |
|---|---|---|
| rfc * | string | RFC (Mexican tax id). |
| string | Email address. | |
| address | object | Fiscal address. |
| comment | string | Notes. |
| telephone | string | Phone number. |
| legal_name * | string | Legal name (razon social). |
| credit_days | integer | Days of credit (0 = cash). |
| location_id | string | Branch id (catalog locations). |
| credit_amount | number | Credit limit. |
| price_list_id * | string | Price list id (catalog price_lists) (a GUID, as returned by the list tools). |
Add a comment to a Bind ERP record (client, prospect, order, ...) identified by its GUID. The comment becomes part of that record's history and cannot be removed through this API. POST /api/Comments.
| Parameter | Type | Description |
|---|---|---|
| comment * | string | The comment text. |
| external_id * | string | Id of the record to comment on (client, prospect, order...) (a GUID, as returned by the list tools). |
{
"name": "binderp_add_comment",
"title": "Add comment",
"description": "Add a comment to a Bind ERP record (client, prospect, order, ...) identified by its GUID. The comment becomes part of that record's history and cannot be removed through this API. POST /api/Comments.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"external_id",
"comment"
],
"properties": {
"comment": {
"type": "string",
"maxLength": 4000,
"minLength": 1,
"description": "The comment text."
},
"external_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Id of the record to comment on (client, prospect, order...) (a GUID, as returned by the list tools)."
}
}
},
"annotations": {
"title": "Add comment",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Create a customer order (pedido, not an invoice: nothing is stamped or invoiced and no email is sent) with product and/or service lines. It reserves stock and shows up in the sales pipeline, so confirm client, prices and quantities first. Get ids from binderp_list_clients, binderp_get_client_addresses, binderp_list_catalog and binderp_list_products. POST /api/Orders.
| Parameter | Type | Description |
|---|---|---|
| comments | string | Order comments. |
| products | array | Product lines. |
| services | array | Service lines. |
| client_id * | string | Client id (a GUID, as returned by the list tools). |
| address_id * | string | Delivery address id (binderp_get_client_addresses) (a GUID, as returned by the list tools). |
| order_date * | string | Order date, ISO 8601, e.g. 2026-10-24 or 2026-10-24T10:00:00Z. |
| currency_id * | string | Currency id (catalog currencies) (a GUID, as returned by the list tools). |
| location_id * | string | Branch id (catalog locations) (a GUID, as returned by the list tools). |
Tools for Bind ERP, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which invoices are overdue and how much is still unpaid per client?"; "Which products in my main warehouse have fewer than 5 units left?"; "Show last month's sales orders for the client Acme.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Bind ERP data. Free plan: 50 tool calls per month. Run binderp_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run binderp_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run binderp_upgrade without a plan: it returns both plans, each with a payment link for the user to open. binderp_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| commercial_name * | string | Commercial name. |
| default_discount | number | Default discount percent. |
| accounting_number * | string | Accounting account number for the customer (required by the API). |
{
"name": "binderp_create_client",
"title": "Create client",
"description": "Create a customer in Bind ERP. Writes a new customer record (with credit terms) and is not deduplicated: check binderp_list_clients for the RFC first. The RFC must be valid for the tax authority (use XAXX010101000 for a generic public customer). No message is sent. Get price_list_id and location_id from binderp_list_catalog. POST /api/Clients.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"legal_name",
"commercial_name",
"rfc",
"price_list_id",
"accounting_number"
],
"properties": {
"rfc": {
"type": "string",
"maxLength": 13,
"minLength": 10,
"description": "RFC (Mexican tax id)."
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 200,
"description": "Email address."
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"colonia": {
"type": "string",
"maxLength": 120,
"minLength": 1
},
"zip_code": {
"type": "string",
"maxLength": 10,
"minLength": 1
},
"street_name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"exterior_number": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"interior_number": {
"type": "string",
"maxLength": 30,
"minLength": 1
}
},
"description": "Fiscal address."
},
"comment": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Notes."
},
"telephone": {
"type": "string",
"maxLength": 40,
"minLength": 1,
"description": "Phone number."
},
"legal_name": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Legal name (razon social)."
},
"credit_days": {
"type": "integer",
"default": 0,
"maximum": 3650,
"minimum": 0,
"description": "Days of credit (0 = cash)."
},
"location_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Branch id (catalog locations)."
},
"credit_amount": {
"type": "number",
"default": 0,
"maximum": 1000000000000,
"minimum": 0,
"description": "Credit limit."
},
"price_list_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Price list id (catalog price_lists) (a GUID, as returned by the list tools)."
},
"commercial_name": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Commercial name."
},
"default_discount": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Default discount percent."
},
"accounting_number": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "Accounting account number for the customer (required by the API)."
}
}
},
"annotations": {
"title": "Create client",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}| warehouse_id * |
| string |
| Warehouse id (catalog warehouses) (a GUID, as returned by the list tools). |
| exchange_rate | number | Exchange rate when the currency is not the base currency. |
| price_list_id * | string | Price list id (catalog price_lists) (a GUID, as returned by the list tools). |
| purchase_order | string | The customer's purchase order number. |
{
"name": "binderp_create_order",
"title": "Create sales order",
"description": "Create a customer order (pedido, not an invoice: nothing is stamped or invoiced and no email is sent) with product and/or service lines. It reserves stock and shows up in the sales pipeline, so confirm client, prices and quantities first. Get ids from binderp_list_clients, binderp_get_client_addresses, binderp_list_catalog and binderp_list_products. POST /api/Orders.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"address_id",
"currency_id",
"location_id",
"warehouse_id",
"price_list_id",
"order_date"
],
"properties": {
"comments": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Order comments."
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"price",
"qty"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Product id (a GUID, as returned by the list tools)."
},
"qty": {
"type": "number",
"maximum": 1000000000,
"description": "Quantity.",
"exclusiveMinimum": 0
},
"vat": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "VAT percent override."
},
"price": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Unit price before tax."
},
"comments": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
}
},
"maxItems": 200,
"description": "Product lines."
},
"services": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"price",
"qty"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Service (sale concept) id (a GUID, as returned by the list tools)."
},
"qty": {
"type": "number",
"maximum": 1000000000,
"description": "Quantity.",
"exclusiveMinimum": 0
},
"vat": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "VAT percent override."
},
"price": {
"type": "number",
"maximum": 1000000000000,
"minimum": 0,
"description": "Unit price before tax."
},
"title": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "Line title."
},
"comments": {
"type": "string",
"maxLength": 500,
"minLength": 1
}
}
},
"maxItems": 200,
"description": "Service lines."
},
"client_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Client id (a GUID, as returned by the list tools)."
},
"address_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Delivery address id (binderp_get_client_addresses) (a GUID, as returned by the list tools)."
},
"order_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,7})?)?(Z|[+-]\\d{2}:\\d{2})?)?$",
"description": "Order date, ISO 8601, e.g. 2026-10-24 or 2026-10-24T10:00:00Z."
},
"currency_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Currency id (catalog currencies) (a GUID, as returned by the list tools)."
},
"location_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Branch id (catalog locations) (a GUID, as returned by the list tools)."
},
"warehouse_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Warehouse id (catalog warehouses) (a GUID, as returned by the list tools)."
},
"exchange_rate": {
"type": "number",
"maximum": 1000000,
"description": "Exchange rate when the currency is not the base currency.",
"exclusiveMinimum": 0
},
"price_list_id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "Price list id (catalog price_lists) (a GUID, as returned by the list tools)."
},
"purchase_order": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "The customer's purchase order number."
}
}
},
"annotations": {
"title": "Create sales order",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}