# DialogBrain MCP

**Remote MCP server** that connects your AI agent to a unified inbox spanning WhatsApp, Telegram, Instagram, Email, Livechat, and Voice calls — plus a workspace knowledge graph and AI agent orchestration.

- **MCP URL:** `https://api.dialogbrain.com/mcp`
- **Transport:** Streamable HTTP
- **Auth:** OAuth 2.0 (Dynamic Client Registration)
- **Tools:** 156 (read/write across all channels)
- **Product:** https://dialogbrain.com
- **Developer docs:** https://docs.dialogbrain.com

## What you can do

- **Read messages across channels:** `messages.read_history`, `threads.list`, `threads.search`
- **Send messages:** `messages.send`, `messages.forward`, `messages.delete`
- **Manage contacts:** `contacts.find`, `contacts.discover`, `contacts.sync`, `contacts.profile`
- **Query workspace knowledge:** `workspace.search`, `kg.find_entity`, `kg.get_relationships`
- **Trigger AI agents:** `agents.ask`, `agents.simulate_inbound`, `agents.approve_draft`
- **Files, calendar, calls, voice, browser automation, YouTube** — see full tool list in [Developer Docs](https://docs.dialogbrain.com/mcp).

## Quick start

### Claude Desktop / Claude.ai (web)

Add as a Custom Connector with URL `https://api.dialogbrain.com/mcp`. Sign in via OAuth when prompted.

### ChatGPT (Apps)

In the ChatGPT Apps directory, search for "DialogBrain" (pending review). Or add as a Custom MCP Server with the same URL.

### Cursor / generic MCP clients

```json
{
  "mcpServers": {
    "dialogbrain": {
      "url": "https://api.dialogbrain.com/mcp",
      "transport": "streamable-http",
      "auth": "oauth2"
    }
  }
}
```

## Authentication

OAuth 2.0 with Dynamic Client Registration (RFC 7591). Your MCP client registers automatically and is granted an access token scoped to one DialogBrain workspace. Revoke at any time from **Settings → Developer** in app.dialogbrain.com.

## Tool annotations

Every tool exposes accurate MCP hint annotations:

- `readOnlyHint` — true for read tools (`threads.list`, `messages.read_history`, `kg.find_entity`, …)
- `destructiveHint` — true for delete tools (`messages.delete`, `widgets.delete`, …)
- `openWorldHint` — true for tools that touch third-party APIs (`messages.send`, `web.search`, `contacts.sync`, …)
- `idempotentHint` — derived from read-only/delete-by-id semantics

See [server.json](./server.json) for the registry manifest and [gemini-extension.json](./gemini-extension.json) for Gemini CLI integration.

## Privacy & support

- **Privacy policy:** https://dialogbrain.com/privacy
- **Terms:** https://dialogbrain.com/terms
- **Support:** support@dialogbrain.com

## License

MIT — see [LICENSE](./LICENSE).