MCPTool reference
Tax Rates
BlueSuite MCP tools for tax rates
See connection and authentication and workflow rules before calling these tools.
Related REST API and behavior.
list_tax_rates
List tax rate presets for the workspace. These can be applied 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", "rate", "created_at", "modified_at" | No | Field to sort by. Unknown values fall back to the default sort. |
sort_direction | "asc", "desc" | No | Sort direction |
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_tax_rate
Create a new tax rate preset. Once created, it can be applied to quotes, jobs, and invoices.
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
name | string | Yes | Tax rate name (e.g. "Sales Tax", "VAT") |
description | string | No | Description of the tax rate. Omit when not needed. |
rate | number | Yes | Tax rate percentage. Pass the percent itself (e.g. 8.25 for 8.25%, not 0.0825). Must be between 0 and 100. minimum: 0. maximum: 100. |
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_tax_rate
Get a single tax rate preset by ID
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Tax rate 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_tax_rate
Update an existing tax rate preset
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Tax rate ID |
name | string | No | Tax rate name |
description | string | No | Description of the tax rate. |
rate | number | No | Tax rate percentage. Pass the percent itself (e.g. 8.25 for 8.25%, not 0.0825). Must be between 0 and 100. minimum: 0. maximum: 100. |
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_tax_rate
Delete a tax rate preset by ID
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
id | integer | Yes | Tax rate 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.