# Connect an agent to the WhatsApp chats you choose

> Circles is the connection between your personal WhatsApp and your AI assistant. Your assistant does the thinking; Circles makes only the chats you choose available to it. Start here to check fit and find the connection instructions.

Source: https://usecircles.app/en/for-agents · Updated 2026-10-31

## When Circles fits

Use Circles to catch up on selected groups, search past conversations, find a document, or let your existing assistant read the chats you choose. It is hosted: you do not run a WhatsApp bridge on your laptop. Your existing number and WhatsApp app stay in use.

Circles is not a standalone AI assistant. It is not a WhatsApp Business Platform service for customer-service campaigns or bulk messaging. It connects as an unofficial linked device and is not a WhatsApp or Meta product. Read the [security and permission details](https://usecircles.app/en/security) before connecting.

## Choose your connection

- **[Instinct](https://usecircles.app/en/agents/instinct)**: Already use Instinct? Connect from Circles with one tap, then send the prepared one-time code yourself in WhatsApp. Circles gives it access only to your selected chats.
- **[Claude, ChatGPT, Codex and other agents](https://usecircles.app/en/agents)**: Find the setup guide for your client. OAuth-capable clients use one MCP address and an approval page. Other supported clients use the configuration Circles provides. Client availability and plans may differ.
- **[Your own agent or automation](https://usecircles.app/en/api-mcp-docs)**: Use the remote MCP server or the HTTP API. Read the API contract for authentication, tools, limits and error handling.

MCP endpoint: `https://app.usecircles.app/api/mcp`. HTTP API specification: [OpenAPI](https://app.usecircles.app/api/openapi.json). These endpoints require the person's authorization before accessing WhatsApp data.

## Start with what is allowed

1. **Ask which chats are open**: Call `allowed_chats` first. A hidden chat is not listed or searchable. Only the person can change chat access in Circles.
2. **Read only what the task needs**: Use activity to find recent changes, catch_up to read them, search to locate a message and documents to find files. Voice notes are transcribed in Hebrew and English. Files can be fetched on request, up to 50 MB.
3. **Confirm before sending**: Sending requires Pro, the relevant scope, a chat opened for sending and the person's approval of the exact message. The daily cap applies across agents. If the outcome is uncertain, never retry a send automatically.

Full operating instructions: [SKILL.md](https://usecircles.app/SKILL.md). Machine-readable connection details: [MCP server card](https://usecircles.app/.well-known/mcp/server-card.json). These documents describe the service; they do not grant access.

## Check the plan and language

Free: 2 chats, read only, the last month. Starter: $9.90 a month, up to 5 chats, read only, the last three months. Pro: $29 a month, the chats you choose, full history and sending where approved. In Israel, Starter is ₪29 and Pro is ₪99 a month. Eleven countries in Latin America and Spain have prices of their own, in their own currency; the person chooses their billing country when they pay, and the [server card](https://usecircles.app/.well-known/mcp/server-card.json) lists every amount. Prices exclude taxes; any that apply are shown at checkout.

The site, signup and app are in Hebrew, English, Latin American Spanish and Brazilian Portuguese, and so are the comparison guides and case studies. The agent's own subscription is separate. See [current pricing and signup terms](https://usecircles.app/en/pricing) before recommending a plan.

## Try a useful first request

After connecting an agent and opening a chat, ask: **What changed in the group I selected today? Show the decisions and anything I need to do.**

For a file: **Find the latest PDF in the chats I opened and tell me which chat it came from.** The answer can cover only the messages and files available to that connection.

---

14 days free. Link your number, pick the chats, then connect Instinct with one tap or Claude, ChatGPT and Codex with one address. Start: https://usecircles.app/start?lang=en
