Project Blue developer resources

Project Blue exposes a REST API and a remote MCP server so agents and applications can send iMessage and SMS, check iMessage availability, manage Workflows, start FaceTime Audio calls, and read call outcomes on dedicated business lines.

When to use Project Blue

Reach for Project Blue when the job is:

1. Send a blue-bubble iMessage (with automatic SMS fallback) from a dedicated line.
2. Look up whether a destination is iMessage-capable before choosing a channel.
3. Enroll or cancel a contact in a Workflow after an inbound reply.
4. Start or inspect a FaceTime Audio call and retrieve the AI transcript later.
5. Connect Claude, Cursor, or ChatGPT via MCP instead of hand-writing HTTP.

Do not use Project Blue as a 10DLC SMS aggregator, a shared short-code provider, or a general email/WhatsApp API. It is not consumer-to-consumer iMessage and it is not a bulk SMS blaster.

How an agent should call us

1. Read this page and api.tryprojectblue.com/openapi.json.
2. Prefer the MCP server at https://api.tryprojectblue.com/api/mcp (Streamable HTTP). Discover OAuth from app.tryprojectblue.com/.well-known/oauth-authorization-server.
3. For raw HTTP, use api.tryprojectblue.com with Authorization: Bearer <token>.
4. Errors are JSON. On the product API the body includes error, code, and hint.

Catalog

• Product OpenAPI: https://api.tryprojectblue.com/openapi.json
• Human docs: https://api.tryprojectblue.com
• Markdown index: https://api.tryprojectblue.com/llms.txt
• MCP card: https://api.tryprojectblue.com/.well-known/mcp.json
• This site's OpenAPI (lead/quiz helpers only): /openapi.json
• llms.txt: /llms.txt

About · Contact · Home