MCPTool reference
Contact Properties
BlueSuite MCP tools for contact properties
See connection and authentication and workflow rules before calling these tools.
Related REST API and behavior.
list_properties
List properties (service addresses) across the workspace with optional search by street, city, state, or zip code. Returns linked contact IDs.
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
search | string | No | Search by street, city, state, or postal code |
property_type | "single-family", "apartment", "complex", "townhouse", "land", "commercial", "other" | No | Filter by property type |
page | integer | No | Page number (default: 1) |
per_page | integer | No | Results per page (default: 25) minimum: 1. maximum: 100. |
sort_by | "id", "property_type", "created_at", "modified_at" | No | Field to sort by |
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. |
list_contact_properties
List all properties (service addresses) for a contact
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
contact_id | integer | Yes | Contact ID |
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_contact_property
Add a property (service address) to a contact
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
contact_id | integer | Yes | Contact ID |
address | object | Yes | Property address |
address.street | string | No | Street address line 1 |
address.street_2 | string | No | Street address line 2 |
address.city | string | No | City |
address.state | string | No | State/province |
address.postal_code | string | No | Postal/zip code |
address.country | string | No | Country |
property_type | "single-family", "apartment", "complex", "townhouse", "land", "commercial", "other" | No | Property type (default: single-family) |
role | "owner", "tenant", "manager", "agent", "other" | No | Contact role for this property (default: owner) |
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_contact_property
Update a property for a contact
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
contact_id | integer | Yes | Contact ID |
property_id | JSON value | Yes | Property ID |
address | object | No | Property address |
address.street | string | No | Street address line 1 |
address.street_2 | string | No | Street address line 2 |
address.city | string | No | City |
address.state | string | No | State/province |
address.postal_code | string | No | Postal/zip code |
address.country | string | No | Country |
property_type | "single-family", "apartment", "complex", "townhouse", "land", "commercial", "other" | No | Property type |
role | "owner", "tenant", "manager", "agent", "other" | No | Contact role for this property |
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_contact_property
Delete a property from a contact
Parameters
| Field | Type / accepted values | Required | Details |
|---|---|---|---|
contact_id | integer | Yes | Contact ID |
property_id | JSON value | Yes | Property 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.