MCPTool reference
Services
BlueSuite MCP tools for services
See connection and authentication and workflow rules before calling these tools.
Related REST API and behavior.
list_services
List saved products and services. These are reusable line items that can be added to quotes, jobs, and invoices.
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
page | integer | No | Page number (default: 1) |
per_page | integer | No | Results per page (default: 25) minimum: 1. maximum: 100. |
search | string | No | Search by name or description |
sort_by | "id", "name", "price", "sku", "type", "created_at", "modified_at" | No | Field to sort by. Unknown values fall back to the default sort. |
sort_direction | "asc", "desc" | No | Sort direction |
id_in | array of integer | No | Filter by a specific list of service IDs. |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | array of object | Yes | The matching records for this page. |
pagination | object | No | How many more pages of results exist. Absent when the API returned an unpaged result. |
pagination.page | integer | When parent supplied | Current page number, 1-based. |
pagination.per_page | integer | When parent supplied | Number of results per page. |
pagination.total_pages | integer | When parent supplied | Total number of pages available. |
create_service
Create a new saved product or service. Once created, it can be used as a line item on quotes, jobs, and invoices.
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
name | string | Yes | Service/product name minLength: 1. |
description | string | No | Plain text description of the service or product. Omit when not needed. |
price | number | No | Default price (default: 0) |
sku | string | No | Free-form SKU or product code string. Omit when not needed. |
type | "service", "product" | No | Type: service or product (default: service) |
taxable | boolean | No | Whether this item is taxable (default: true) |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
get_service
Get a single product or service by ID
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Service ID |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
update_service
Update an existing product or service
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Service ID |
name | string | No | Service/product name minLength: 1. |
description | string | No | Plain text description of the service or product. |
price | number | No | Default price |
sku | string | No | Free-form SKU or product code string. |
type | "service", "product" | No | Type: service or product |
taxable | boolean | No | Whether this item is taxable |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
delete_service
Delete a product or service by ID
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Service ID |
Result
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
data | object or null | Yes | The affected record, or the result of the operation. Null when nothing matched. |
The downloadable tool schemas include the full input and output contracts. Tables describe schema-level required fields; cross-field rules still apply.