Build with AI
Every way to hand Blue Reacher to an AI: the hosted MCP server for agents that act, and machine-readable docs for assistants that write your integration.
There are two jobs an AI can do with Blue Reacher, and each has its own entry point.
Operate the account
The hosted MCP server. Claude, Cursor or any MCP client sends, reads and manages lines as tools.
Write your integration
Plain-text docs and the OpenAPI spec, so a coding assistant builds against the real API.
Connect an agent in one command
The MCP server is hosted, so there is nothing to install or keep running. Try it first with the public sandbox key:
claude mcp add --transport http bluereacher https://api.bluereacher.com/v1/mcp \
--header "Authorization: Bearer brk_test_Dc815ar0WQChF5odYSeB8k2ovmVf1zG2"Nothing real is sent on that key. Swap in your live key when you are ready. Cursor, Claude Desktop and generic client configs, the full tool list and the safety rules are on the MCP server page.
Docs for your assistant
Point a coding assistant at these and it works from the real API instead of guessing.
| What | URL | Use it for |
|---|---|---|
| Docs index | https://docs.bluereacher.com/llms.txt | A map of every page, small enough for any context window |
| Full docs | https://docs.bluereacher.com/llms-full.txt | Every page in one text file |
| Any single page | Add .md to its URL, for example https://docs.bluereacher.com/docs/guides/quickstart.md | Just the page you are working on |
| OpenAPI spec | https://docs.bluereacher.com/openapi.json | Types, request shapes and client generation |
Requesting any /docs page with Accept: text/markdown also returns the markdown version.
Every page on this site has a Copy Markdown button under its title, and the menu next to it opens the page directly in ChatGPT, Claude and other assistants.
A prompt that works
Paste this into your assistant with the files above attached or linked:
Using the Blue Reacher API docs at https://docs.bluereacher.com/llms-full.txt,
write a function that sends an iMessage with an Idempotency-Key, and a webhook
handler that verifies X-BlueReacher-Signature before parsing. Test it against
the public sandbox key brk_test_Dc815ar0WQChF5odYSeB8k2ovmVf1zG2.Keep agents safe
- Build on a test key first. The simulator answers every tool with nothing real sent.
- Give the agent its own key, so one revoke stops it without touching your production integration.
- Keep bulk sends human-approved. Drafting and research are safe to automate; approving outbound to real people is a product decision.
- Pacing and opt-outs are enforced underneath, so an over-eager agent queues rather than burns a line, and it cannot message a contact who opted out.
Key concepts
The object model and the ideas the whole API hangs off: lines, contacts, conversations, drip vs instant, engaged vs cold, and test mode.
MCP Server
Point Claude, Cursor, or any MCP client at the hosted Blue Reacher MCP endpoint and an AI assistant can send, read, react, and manage the account with no package to install.