Skip to main content

MCP Integration Overview

The Model Context Protocol (MCP) is an open standard that lets AI assistants like Claude interact with external tools. Renovatr provides an MCP server that gives Claude direct access to your project data.

What Can You Do?​

With MCP connected, you can ask Claude things like:

  • "List all pending deliverables in my project"
  • "Create a new snag for the cracked tile in the master bathroom"
  • "Mark the kitchen cabinet installation as completed"
  • "What incidents were reported this week?"
  • "Create a task for plumbing inspection, estimated cost $500"

How It Works​

The Renovatr MCP server is a bridge that runs locally on your machine:

  1. Claude Desktop launches the MCP bridge as a child process
  2. The bridge receives tool calls from Claude via stdin/stdout (stdio transport)
  3. It forwards each call as an HTTP request to your Renovatr instance's MCP endpoint
  4. Your API key authenticates the request and scopes it to your project
  5. Results flow back to Claude
Claude Desktop ↔ (stdio) ↔ MCP Bridge ↔ (HTTPS) ↔ Renovatr API

Available Tools​

The MCP server exposes 17 tools across three domains:

DomainToolsOperations
Deliverables6List, get, create, update, update status, delete
Snags6List, get, create, update, resolve, delete
Incidents5List, get, create, update, delete

See Available Tools for the complete reference.

Prerequisites​

  • An active Renovatr project
  • An API key with appropriate permissions (at minimum: view permissions for the resources you want to read)
  • Claude Desktop (or any MCP-compatible client)
  • Node.js 18+ installed

Next Steps​