# DialogBrain

DialogBrain gives AI agents access to all your messaging channels — Telegram, WhatsApp, Instagram, Email, and more — through a single MCP interface. Read conversations, send messages, search contacts…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add dialogbrain/dialogbrain

# Browse available tools
npx -y @smithery/cli@latest tool list dialogbrain/dialogbrain

# Get full schema for a tool
npx -y @smithery/cli@latest tool get dialogbrain/dialogbrain contacts_find

# Call a tool
npx -y @smithery/cli@latest tool call dialogbrain/dialogbrain contacts_find '{}'
```

## Direct MCP Connection

Endpoint: `https://dialogbrain--dialogbrain.run.tools`

## Tools (16)

- `contacts_find` — 👤 Search for contacts in your address book by name or username.
- `contacts_discover` — Search for a contact on a live channel (Telegram, WhatsApp, etc.) before adding them. Use this to look up a person by u…
- `contacts_sync` — Add a discovered contact and open a conversation thread. Returns thread_id for the new conversation. Call contacts.disc…
- `files_ingest` — Save and index a file into the knowledge base. Use this when the user asks to save, store, or remember a document. The …
- `files_read` — Read the contents of an attached file directly. Use this when the user asks 'what is in this file?' or 'read this docum…
- `files_upload` — Upload a file to DialogBrain and get a file_id for use in messages_send.
- `files_info` — Get metadata and download URLs for files by their IDs.
- `files_get_base64` — Download one or more files server-side and return their content as base64-encoded strings. Use this to inspect images, …
- `messages_read_history` — Read messages from a conversation thread in chronological order. Returns the most recent messages, including sender inf…
- `threads_list` — 💬 List conversation threads/chats with previews and metadata.
- `messages_send` — Send a message to a thread, channel, or contact. Supports Telegram, Email, and other connected channels. Can automatica…
- `messages_delete` — Delete a message from a thread. Supports Telegram, WhatsApp, and other connected channels. Note: Some channels have tim…
- `kg_find_entity` — Find an entity by name in the Knowledge Graph.
- `kg_get_relationships` — Get relationships for a specific entity from Knowledge Graph.
- `web_search` — Search the web for current information, news, facts, prices, or events. Use this when the user asks about something tha…
- `workspace_search` — Universal multi-search across workspace: files, links, chats, messages.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get dialogbrain/dialogbrain <tool-name>
```