> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hiveinspect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ask Your AI Assistant About Your Inspection Business

> Ask Claude, ChatGPT or Grok about your Hive Inspect inspections, schedule, agents, contacts, payments and agreements. See example questions and what it reads.

> [!NOTE]
>
> **The Hive Inspect API is a work in progress.** It is available to a small group of accounts today, and the release for everyone is coming very soon. To ask for early access, message us from the chat bubble in your dashboard.

Once your assistant is [connected](https://docs.hiveinspect.com/api/mcp.md), you can ask it about your business in plain language. It looks up the answer in your Hive account.

This part is **read-only**. The assistant can't create, change or delete anything with these tools. Every connection has it, with no box to tick.

## What you can ask

### Your schedule

* "Show my inspections for next week and who is assigned."
* "What do I have on Thursday, and where?"
* "Which inspections this month are still not confirmed?"

### Agents and referrals

* "Which agents sent me the most inspections this year?"
* "Which agents haven't booked with me in the last 90 days?"
* "List the agents at Summit Realty and how many inspections each sent."

### Clients and contacts

* "Find the contact for Maria Lopez and show her phone and email."
* "Which contacts have the VIP tag?"
* "Which clients have a birthday in December?"

### Money

* "How many inspections did I do last month, and what was the revenue?"
* "Which inspections from last month are still unpaid?"
* "Show the invoice, payments and refunds for 12 Oak Street."

### One inspection

* "Find the inspection at 12 Oak Street. Is the agreement signed and is the report published?"
* "Who are the buyer's agent and the client on tomorrow's 9 AM inspection?"
* "What extra documents are attached to the Pine Avenue inspection?"

> [!TIP]
>
> Name an address, a client or a date range. The assistant finds the inspection for you, so you never need an id.

## What it can read

| Area | What it sees |
| - | - |
| **Inspections** | Date and time, address, status, assigned inspectors, the people on it, services, price, payment status, agreement status and report status |
| **Payments** | One inspection's invoice, who pays which share, payments and refunds |
| **Contacts** | Clients, agents and other contacts, with their details and tags |
| **Agent and client stats** | Inspection counts and revenue per agent or client, for a date range |
| **Agencies** | Brokerages and the agents in them |
| **Inspection events** | Extra visits on an inspection, such as a radon drop-off |
| **Attachments** | Names and download links of additional reports and documents |

## What it can't see

* **What is written inside a report.** Comments, defects and photos are only readable when you turn on [Edit reports](https://docs.hiveinspect.com/api/mcp-edit-reports.md).
* **Your templates.** Only with [Edit templates](https://docs.hiveinspect.com/api/mcp-edit-templates.md).
* **Emails and text messages, automations, reviews and business metrics dashboards.** For those, use the [Hive AI Agent](https://docs.hiveinspect.com/how-tos/hive-ai-agent.md) inside Hive.
* **Other companies.** A connection only reaches the company you approved.

## Tips for better answers

* **Give a date range.** "This year" or "last 30 days" is quicker and more accurate than "all time".
* **Ask for a count when you want a count.** "How many" is one quick lookup. "List all" can take several.
* **Check important numbers.** Hive supplies the data. The assistant does the reading and the arithmetic, so confirm figures you will act on in Hive.
* **Download links expire after 1 hour.** Ask again for a fresh link.
* **Dates follow your company's time zone.** See [Limits, dates and privacy](https://docs.hiveinspect.com/api/mcp-limits.md#dates-and-time-zones).

## Tools the assistant gets

| Tool | What it does |
| - | - |
| `list_inspections` | Find inspections by date, status, inspector, contact, payment or address |
| `get_inspection` | Get one inspection |
| `list_inspection_payments` | One inspection's invoice, payer shares, payments and refunds |
| `list_contacts` | Find clients, agents and other contacts |
| `get_contact` | Get one contact |
| `list_contact_stats` | Inspection counts and revenue per agent or client |
| `list_agencies` | List agencies (brokerages) |
| `get_agency` | Get one agency |
| `list_tags` | List contact tags |
| `list_events` | List inspection events, such as a radon drop-off |
| `list_attachments` | List additional reports and documents across inspections |
| `list_inspection_attachments` | List one inspection's attachments |

Each tool returns the same data as the matching [API endpoint](https://docs.hiveinspect.com/api/introduction.md).

## How this differs from the Hive AI Agent

| | Your own assistant (MCP) | Hive AI Agent |
| - | - | - |
| **Where you use it** | In Claude, ChatGPT or Grok | Inside Hive: **Ask Agent** on the dashboard and the mobile app |
| **Who sets it up** | The account owner connects it | Nothing to set up |
| **What it knows** | The areas in the table above | Those, plus messages, automations, reviews, metrics and the help docs |
| **Can make changes** | Yes, in beta, if you allow it | No |

See [Hive AI Agent](https://docs.hiveinspect.com/how-tos/hive-ai-agent.md).

## Where to go next

* [Edit reports with AI](https://docs.hiveinspect.com/api/mcp-edit-reports.md): let the assistant fill in a report.
* [Edit templates with AI](https://docs.hiveinspect.com/api/mcp-edit-templates.md): let the assistant build and change templates.
* [Limits, dates and privacy](https://docs.hiveinspect.com/api/mcp-limits.md): request limits and what is shared.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.