io.github.hcpapi/housecall-pro-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HCP_API_KEY | No | Your Housecall Pro API key. If not provided, the server starts in keyless mode with only a subset of tools. | |
| HCP_TOOLSETS | No | Comma-separated list of toolset groups to register. Equivalent to --toolsets. | |
| HCP_READ_ONLY | No | Set to '1' to run in read-only mode, registering no write tools. Equivalent to --read-only. | |
| HCP_MCP_PROFILE_PATH | No | Path to the file storing the business profile. Overrides the platform default location. | |
| HCP_MCP_DEFAULTS_PATH | No | Path to the file storing default preferences. Overrides the platform default location. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hcp_render_reportA | Render a findings report into one self-contained, offline, interactive HTML file — sortable and filterable tables, severity-coded sections, collapsible worklists, selectable rows that copy back to chat, light and dark theme, print. This is a presentation tool: it makes no Housecall Pro call and takes findings you already have. Pass a The tool returns the finished HTML. In Claude Code, write it to a |
| hcp_get_business_profileA | Read the business profile stored for this installation: who the shop is, who they buy from, their pricing rules, their payroll rules, and how their outbound messages should sound. Skills read this before asking setup questions, so an interview answered once is never asked twice; missing_sections is what a first run still has to ask, and each stored section carries the date it was last confirmed. The profile is this installation's own file, on this machine, beside the defaults file. Nothing in it is read from Housecall Pro or sent to it, or to anyone else. An empty profile is the ordinary state of a fresh install, not a problem. |
| hcp_set_business_profileA | Store one or more business-profile sections for this installation: shop, vendors, pricing, payroll, comms. Each section replaces the stored section whole, and null clears one - so save a section only after reading the whole section back to the user for a yes. The profile is this installation's own file, on this machine, beside the defaults file. Nothing in it is read from Housecall Pro or sent to it, or to anyone else. The sections hold the shop's own facts, never a customer's, and never credentials: a vendor's account_hint refuses anything that looks like a full account number. |
| hcp_api_notesA | Look up what the Housecall Pro API actually does for a given topic, as opposed to what its published documentation says. Call this BEFORE concluding that something cannot be done, before retrying a route that returned 404, and after any write that reported success but looks like it changed nothing. It answers from a table of verified behaviour: routes the documentation describes that do not exist, writes that are accepted and silently ignored, and fields whose units are not what they appear to be. Ask in plain words - a topic, a route, a field name, or the thing you were trying to do. Omit the topic to read the whole table. This tool reads a table compiled into this server and makes no API call, so it costs nothing and cannot fail. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| hcp-api-quirks | Verified Housecall Pro API behaviour that differs from its published documentation, including the writes that are accepted and silently ignored. |
| hcp-api-phantom-routes | Routes the published Housecall Pro documentation describes which are absent from the API. A 404 on one of these is the route being absent, not a bad request. |
TDQS
Scored across 4 tools
Each tool targets a distinct function: rendering reports, reading/writing the business profile, and looking up API notes. The get/set pair is symmetric and unambiguous, with no overlapping purposes.
Three tools follow a clear verb_noun pattern (render_report, get_business_profile, set_business_profile). One tool (hcp_api_notes) uses a noun phrase instead of a verb, a minor deviation that does not cause confusion.
Four tools is a well-scoped set for this server's purpose: one presentation tool, two profile management tools, and one reference tool. Each earns its place with no redundancy.
The business profile has full get/set/clear lifecycle, report rendering is a single-purpose tool, and API notes provides lookup. There are no obvious gaps given the server's defined scope of not making direct Housecall Pro calls.