# Brightly AI

> AI appointment setter for home services businesses. Texts, emails, and calls every lead
> within 90 seconds, books jobs onto the calendar, and hands off to a human when it's unsure.
> This file is for AI agents and LLM tools that want to read or act on a Brightly account
> programmatically over plain HTTP.

## API

- [OpenAPI 3.1 spec](https://api.brightlyai.app/api/v1/openapi.json): every `/api/v1` endpoint, generated from the live routers — never hand-maintained.
- [Agent skill file](https://brightlyai.app/AGENTS.md): copy-paste auth + top calls + compliance rules for an agent that already has a shell or HTTP client.
- [Human API docs](https://brightlyai.app/settings/api-docs): the same endpoints with request/response detail, requires a signed-in account.

## Full detail

- [llms-full.txt](https://brightlyai.app/llms-full.txt): every section above, expanded — auth, the highest-value calls, and the opt-out/TCPA rules an agent must respect before sending on a customer's behalf.

## Other ways in

- MCP server (`api.brightlyai.app/mcp`, streamable HTTP) — the same account, tool-call shaped instead of REST, for MCP-native clients (Claude, etc.).
- Official MCP Registry entry: https://registry.modelcontextprotocol.io/v0.1/servers?search=app.brightlyai%2Fbrightly (server name `app.brightlyai/brightly`).
- Grok: there is no Grok connector directory. Add Brightly yourself at grok.com/connectors → add a custom connector → paste `https://api.brightlyai.app/mcp` → sign in to Brightly.