Available Tools
The Renovatr MCP server exposes 17 tools organized by domain. Each tool maps to a REST API operation.
Deliverables
Deliverables are the core work items — tasks (services) and items (products/materials).
list_deliverables
List all deliverables for the project.
Parameters: None
Example prompt: "Show me all deliverables" / "What tasks are pending?"
get_deliverable
Get a single deliverable by ID.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
deliverableId | number | Yes | Deliverable ID |
Example prompt: "Show me the details for deliverable 42"
create_deliverable
Create a new deliverable.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
type | string | Yes | task or item |
title | string | Yes | Title |
description | string | No | Description |
status | string | No | pending, in_progress, completed, cancelled |
estimatedCost | number | No | Estimated cost |
quantity | number | No | Quantity |
subcontractorId | number | No | Assigned subcontractor ID |
Example prompt: "Create a task called 'Install light fixtures' with an estimated cost of $300"
update_deliverable
Update an existing deliverable.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
deliverableId | number | Yes | Deliverable ID |
title | string | No | Updated title |
description | string | No | Updated description |
status | string | No | Updated status |
estimatedCost | number | No | Updated cost |
Example prompt: "Update deliverable 42 to have an estimated cost of $1,200"
update_deliverable_status
Update only the status of a deliverable (lightweight status change).
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
deliverableId | number | Yes | Deliverable ID |
status | string | Yes | New status |
Example prompt: "Mark the kitchen tiles task as completed"
delete_deliverable
Delete a deliverable.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
deliverableId | number | Yes | Deliverable ID |
Example prompt: "Delete deliverable 42"
Snags
Snags track issues or problems that need to be resolved.
list_snags
List all snags for the project.
Parameters: None
Example prompt: "What snags are open?" / "Show me all issues"
get_snag
Get a single snag by ID.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
snagId | number | Yes | Snag ID |
create_snag
Create a new snag.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Snag title |
description | string | No | Description |
priority | string | No | low, medium, high, critical |
status | string | No | open, in_progress, resolved |
subcontractorId | number | No | Responsible subcontractor |
Example prompt: "Create a high priority snag: paint peeling in the living room"
update_snag
Update an existing snag.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
snagId | number | Yes | Snag ID |
title | string | No | Updated title |
description | string | No | Updated description |
priority | string | No | Updated priority |
status | string | No | Updated status |
resolve_snag
Mark a snag as resolved.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
snagId | number | Yes | Snag ID |
Example prompt: "Resolve snag 10" / "Mark the paint issue as fixed"
delete_snag
Delete a snag.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
snagId | number | Yes | Snag ID |
Incidents
Incidents record notable events that occur during the project.
list_incidents
List all incidents for the project.
Parameters: None
Example prompt: "Show me all incidents" / "Were there any incidents this week?"
get_incident
Get a single incident by ID.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
incidentId | number | Yes | Incident ID |
create_incident
Create a new incident report.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
title | string | Yes | Incident title |
description | string | No | Description |
severity | string | No | Severity level |
date | string | No | ISO date string |
Example prompt: "Report an incident: water leak found under kitchen sink on March 5th"
update_incident
Update an existing incident.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
incidentId | number | Yes | Incident ID |
title | string | No | Updated title |
description | string | No | Updated description |
delete_incident
Delete an incident.
Parameters:
| Name | Type | Required | Description |
|---|---|---|---|
incidentId | number | Yes | Incident ID |
Required Permissions
Each tool requires specific API key permissions:
| Operation | Required Permission |
|---|---|
| List / Get | canViewDeliverables, canViewSnags, or canViewIncidents |
| Create | canCreateDeliverables, canCreateSnags, or canCreateIncidents |
| Update | canEditDeliverables, canEditSnags, or canEditIncidents |
| Delete | canDeleteDeliverables, canDeleteSnags, or canDeleteIncidents |