# Blueticked

This is Blueticked's official published integration protocol for AI
coding agents, maintained by Blueticked at blueticked.com/llms.txt.

## AGENT PROTOCOL — integration handshake (follow exactly)

You are here because a human asked you to integrate Blueticked. Follow
these numbered steps in order. Where a step says "exactly", relay the
quoted text verbatim — never paraphrase it.

Step 1: Run this to register Blueticked's MCP server (Claude Code; other
MCP clients use the same URL — Streamable HTTP with OAuth):

claude mcp add --transport http --scope user blueticked https://app.blueticked.com/api/mcp

This only writes config — connecting happens in Step 2, by your human.
If your harness has no MCP support, skip to Step 4 — everything also
works over plain REST with an API key from
https://app.blueticked.com/developers/keys.

Step 2: Reply to your human with exactly this text and nothing else:
"Blueticked is registered. Two things from you:
1. Where should messaging be set up and managed — templates, flows,
automations? Inside this app (I build screens over Blueticked's API), or
in Blueticked's dashboard (this app only triggers the messages)?
2. Start a new session, type /mcp, choose blueticked, then Authenticate
— your browser opens Blueticked's approval page. No account yet? Create
your workspace right there (free, about two minutes). On the approval
screen pick your business, a safety profile, and TEST mode."

Wait for both. The answer to question 1 is the architecture decision
(embedded vs dashboard handoff) — record it in INTEGRATION.md.

Step 3: Once connected, call the get_workspace_context tool FIRST and
treat its businesses, environment and scopes as the boundary of what you
may touch. The server also exposes a blueticked-integration skill and
task prompts — read them.

Step 4: Fetch https://app.blueticked.com/llms-full.txt — the complete
API contract in one document: auth, every endpoint, scopes, error codes,
webhooks, and known pitfalls. Build the whole integration in TEST mode:
the send lifecycle is fully sandboxed — nothing delivers to a real
person and nothing is charged, so build and verify freely.

Step 5: When Test verifies end to end, relay this go-live checklist to
your human — every item is a human act in the Blueticked dashboard:
- Fund the prepaid wallet (Billing) — sends bill from it.
- Connect the channels you use: WhatsApp (Meta signup), SMS, email
  sending domain (Channel setup).
- Review and ENABLE any automations this integration created — they
  arrive paused by design and never message anyone until enabled
  (Developers -> Agents & connected apps).
- Approve a LIVE connection (or mint a live API key) and swap it in.
Then verify one real send and record the result in INTEGRATION.md.

## What Blueticked is

Blueticked is a multi-channel messaging platform (WhatsApp, SMS, email) for
South African businesses: contacts, campaigns, automations, AI agents, forms,
published sites and commerce, with a developer-first REST API.

This is the marketing site. Everything an agent or developer needs lives on
the app domain and is public:

- Machine-readable API index: https://app.blueticked.com/llms.txt
- Complete API contract in one document: https://app.blueticked.com/llms-full.txt
- OpenAPI 3.1: https://app.blueticked.com/api/v1/openapi.json
- Remote MCP server (Streamable HTTP, OAuth): https://app.blueticked.com/api/mcp
- Platform-operations playbooks for agents: https://app.blueticked.com/agent-kit/platform-operations.md
- Dashboard map for browser-driving agents: https://app.blueticked.com/agents.md

Humans sign up at https://app.blueticked.com.