> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Business Tools
> Manage businesses, profiles, offerings, and online and physical presences
The Bizzy MCP server provides 20 tools for managing businesses, their profile,
offerings, and online and physical presences. These tools are organized into
five categories: businesses, business profile, offerings, online presences, and
physical presences.
## Businesses
Core tools for reading and updating businesses. Businesses are provisioned with
the organization, so there are no `create` or `delete` tools.
### getBusiness
Get details for a specific business by ID.
**Permission:** `businesses:read`
**Parameters:**
| Name | Type | Required | Description |
| ------------ | ------------- | -------- | ------------------------------ |
| `businessId` | string (UUID) | Yes | ID of the business to retrieve |
**Returns:** Business object, or `null` if not found.
***
### listBusinesses
List all businesses in the organization.
**Permission:** `businesses:read`
**Parameters:**
| Name | Type | Required | Default | Description |
| ----------- | ------ | -------- | ------- | --------------------------------------------- |
| `limit` | number | No | 10 | Maximum number of items to return (max: 100) |
| `offset` | number | No | 0 | Number of items to skip for pagination |
| `sortOrder` | string | No | "desc" | Sort order by creation date ("asc" or "desc") |
**Returns:**
```json theme={null}
{
"businesses": [...],
"count": 3,
"limit": 10,
"offset": 0
}
```
***
### updateBusiness
Update an existing business by ID.
**Permission:** `businesses:write`
**Parameters:**
| Name | Type | Required | Description |
| ------ | ------------- | -------- | ---------------------------- |
| `id` | string (UUID) | Yes | ID of the business to update |
| `name` | string | No | The name of the business |
Stripe Connect-related fields on the business record are managed by the
Stripe integration — do not pass them in here, as they are overwritten or
ignored.
**Returns:** The updated business object.
***
## Business Profile
Tools for reading and updating the descriptive profile of a business. The
profile is created alongside the business, so there is no `create`, `list`, or
`delete` tool — there is exactly one profile per business.
### getBusinessProfile
Get the detailed profile of a business by ID.
**Permission:** `businesses.profiles:read`
**Parameters:**
| Name | Type | Required | Description |
| ------------ | ------------- | -------- | ----------------------------------------------------------------------------- |
| `businessId` | string (UUID) | Yes | ID of the business whose profile to retrieve (profile shares the business ID) |
**Returns:** Business profile object, or `null` if not found.
***
### updateBusinessProfile
Update the profile information of a business.
**Permission:** `businesses.profiles:write`
**Parameters:**
| Name | Type | Required | Description |
| ------------- | -------------------------------- | -------- | ------------------------------------------------------ |
| `id` | string (UUID) | Yes | The ID of the business profile to update |
| `description` | string \| null | No | A new detailed description of the business (optional) |
| `industries` | string\[] \| null | No | New industries the business operates in (optional) |
| `data` | Record\ \| null | No | Additional business data as key-value pairs (optional) |
**Returns:** The updated business profile object.
***
## Offerings
Tools for managing the products and services a business offers.
### createBusinessOffering
Create a new product or service offering for a business.
**Permission:** `businesses.offerings:write`
**Parameters:**
| Name | Type | Required | Description |
| ------------- | --------------- | -------- | -------------------------------------------------------------- |
| `businessId` | string (UUID) | Yes | The ID of the business this offering belongs to |
| `name` | string | Yes | The name of the offering |
| `description` | string \| null | No | A description of the offering (optional) |
| `isService` | boolean \| null | No | Whether this is a service (true) or product (false) - optional |
**Returns:** The created business offering object.
***
### getBusinessOffering
Get details of a specific business offering by ID.
**Permission:** `businesses.offerings:read`
**Parameters:**
| Name | Type | Required | Description |
| ---- | ------------- | -------- | ------------------------------------------- |
| `id` | string (UUID) | Yes | The ID of the business offering to retrieve |
**Returns:** Business offering object, or `null` if not found.
***
### listBusinessOfferings
List all products and services offered by a business.
**Permission:** `businesses.offerings:read`
**Parameters:**
| Name | Type | Required | Default | Description |
| ------------ | ------------- | -------- | ------- | -------------------------------------------- |
| `businessId` | string (UUID) | Yes | - | The ID of the business to list offerings for |
| `limit` | number | No | 100 | Maximum number of results |
| `offset` | number | No | 0 | Offset for pagination |
**Returns:**
```json theme={null}
{
"offerings": [...],
"count": 12,
"limit": 100,
"offset": 0
}
```
***
### updateBusinessOffering
Update details of an existing business offering.
**Permission:** `businesses.offerings:write`
**Parameters:**
| Name | Type | Required | Description |
| ------------- | --------------- | -------- | -------------------------------------------------------------- |
| `id` | string (UUID) | Yes | The ID of the business offering to update |
| `name` | string | No | The new name for the offering (optional) |
| `description` | string \| null | No | A new description for the offering (optional) |
| `isService` | boolean \| null | No | Whether this is a service (true) or product (false) - optional |
**Returns:** The updated business offering object.
***
### deleteBusinessOffering
Delete a business offering (soft delete).
**Permission:** `businesses.offerings:delete`
**Parameters:**
| Name | Type | Required | Description |
| ---- | ------------- | -------- | ----------------------------------------- |
| `id` | string (UUID) | Yes | The ID of the business offering to delete |
**Returns:** The deleted business offering object.
***
## Online Presences
Tools for managing a business's online presence — websites, social media
profiles, marketplace listings, and similar.
### createBusinessOnlinePresence
Create a new online presence for a business (website, social media, marketplace,
etc.).
**Permission:** `businesses.online-presences:write`
**Parameters:**
| Name | Type | Required | Description |
| ------------- | -------------- | -------- | ---------------------------------------------------------------------------------------- |
| `businessId` | string (UUID) | Yes | The ID of the business this online presence belongs to |
| `name` | string | Yes | The name of the online presence (e.g., "Company Website", "Facebook Page") |
| `url` | string \| null | No | The URL of the online presence (optional) |
| `description` | string \| null | No | A description of the online presence (optional) |
| `type` | string \| null | No | The type of online presence (e.g., "website", "social\_media", "marketplace") (optional) |
| `provider` | string \| null | No | The provider or platform (e.g., "facebook", "linkedin", "amazon") (optional) |
**Returns:** The created business online presence object.
***
### getBusinessOnlinePresence
Get details of a specific business online presence by ID.
**Permission:** `businesses.online-presences:read`
**Parameters:**
| Name | Type | Required | Description |
| ------------------ | ------------- | -------- | -------------------------------------------------- |
| `onlinePresenceId` | string (UUID) | Yes | The ID of the business online presence to retrieve |
**Returns:** Business online presence object, or `null` if not found.
***
### listBusinessOnlinePresences
List all online presences for a specific business.
**Permission:** `businesses.online-presences:read`
**Parameters:**
| Name | Type | Required | Default | Description |
| ------------ | ------------- | -------- | ------- | --------------------------------------------------- |
| `businessId` | string (UUID) | Yes | - | The ID of the business to list online presences for |
| `limit` | number | No | 100 | Maximum number of results |
| `offset` | number | No | 0 | Offset for pagination |
**Returns:**
```json theme={null}
{
"onlinePresences": [...],
"count": 4,
"limit": 100,
"offset": 0
}
```
***
### updateBusinessOnlinePresence
Update an existing business online presence - all fields are optional except
onlinePresenceId.
**Permission:** `businesses.online-presences:write`
**Parameters:**
| Name | Type | Required | Description |
| ------------------ | -------------- | -------- | ------------------------------------------------ |
| `onlinePresenceId` | string (UUID) | Yes | The ID of the business online presence to update |
| `name` | string | No | Update the online presence name |
| `url` | string \| null | No | Update the URL |
| `description` | string \| null | No | Update the description |
| `type` | string \| null | No | Update the type of online presence |
| `provider` | string \| null | No | Update the provider or platform |
**Returns:** The updated business online presence object.
***
### deleteBusinessOnlinePresence
Delete a business online presence (soft delete).
**Permission:** `businesses.online-presences:delete`
**Parameters:**
| Name | Type | Required | Description |
| ------------------ | ------------- | -------- | ------------------------------------------------ |
| `onlinePresenceId` | string (UUID) | Yes | The ID of the business online presence to delete |
**Returns:** The deleted business online presence object.
***
## Physical Presences
Tools for managing a business's physical locations — offices, stores,
warehouses, and similar.
### createBusinessPhysicalPresence
Create a new physical location (office, store, warehouse, etc.) for a business.
**Permission:** `businesses.physical-presences:write`
**Parameters:**
| Name | Type | Required | Description |
| ------------- | -------------- | -------- | ------------------------------------------------------------------------- |
| `businessId` | string (UUID) | Yes | The ID of the business this physical location belongs to |
| `name` | string | Yes | The name of the physical location (e.g., "Main Office", "Downtown Store") |
| `description` | string \| null | No | A description of the physical location (optional) |
| `address` | string \| null | No | The full address of the physical location (optional) |
**Returns:** The created business physical presence object.
***
### getBusinessPhysicalPresence
Get details of a specific business physical location by ID.
**Permission:** `businesses.physical-presences:read`
**Parameters:**
| Name | Type | Required | Description |
| -------------------- | ------------- | -------- | ---------------------------------------------------- |
| `physicalPresenceId` | string (UUID) | Yes | The ID of the business physical presence to retrieve |
**Returns:** Business physical presence object, or `null` if not found.
***
### listBusinessPhysicalPresences
List all physical locations (offices, stores, etc.) for a business.
**Permission:** `businesses.physical-presences:read`
**Parameters:**
| Name | Type | Required | Default | Description |
| ------------ | ------------- | -------- | ------- | ----------------------------------------------------- |
| `businessId` | string (UUID) | Yes | - | The ID of the business to list physical locations for |
| `limit` | number | No | 100 | Maximum number of results |
| `offset` | number | No | 0 | Offset for pagination |
**Returns:**
```json theme={null}
{
"physicalPresences": [...],
"count": 2,
"limit": 100,
"offset": 0
}
```
***
### updateBusinessPhysicalPresence
Update an existing business physical location - all fields are optional except
physicalPresenceId.
**Permission:** `businesses.physical-presences:write`
**Parameters:**
| Name | Type | Required | Description |
| -------------------- | -------------- | -------- | -------------------------------------------------- |
| `physicalPresenceId` | string (UUID) | Yes | The ID of the business physical presence to update |
| `name` | string | No | Update the physical location name |
| `description` | string \| null | No | Update the description |
| `address` | string \| null | No | Update the address |
**Returns:** The updated business physical presence object.
***
### deleteBusinessPhysicalPresence
Delete a business physical location (soft delete).
**Permission:** `businesses.physical-presences:delete`
**Parameters:**
| Name | Type | Required | Description |
| -------------------- | ------------- | -------- | -------------------------------------------------- |
| `physicalPresenceId` | string (UUID) | Yes | The ID of the business physical presence to delete |
**Returns:** The deleted business physical presence object.
***
## Next Steps
Manage customers and their relationships with your business
Learn how MCP clients authenticate to the server