Summary
A production-grade remote MCP that pipes WhatsApp, Telegram, Instagram, email, livechat, and voice calls into a single inbox your AI can read from and write to. You get 156 tools covering message history, sending, search, contact sync, and workspace knowledge graph queries. It also orchestrates AI agents, so you can trigger workflows, simulate inbound messages, or approve drafts programmatically. Authentication is OAuth 2.0 with dynamic client registration, and every tool ships with proper MCP hints for read-only, destructive, and open-world operations. Reach for this when you need Claude or another MCP client to manage real customer conversations across channels or tap into a team's unified communication history without building integrations yourself.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
16 tools
contacts_find👤 Search for contacts in your address book by name or username. When to use: - User asks 'find contact X' or 'who is Y?' - User wants to know someone's username or ID - Before sending a message to verify contact exists - To get contact's channel reference for messaging Exampl...3 params
👤 Search for contacts in your address book by name or username. When to use: - User asks 'find contact X' or 'who is Y?' - User wants to know someone's username or ID - Before sending a message to verify contact exists - To get contact's channel reference for messaging Exampl...
Parameters* required
channelstringFilter by channel (telegram, email, whatsapp, sms, slack)one of
telegram · email · whatsapp · sms · slacklimitintegerMaximum number of results to returndefault: 10
querystringName or username to search for (supports partial matches)
contacts_discoverSearch for a contact on a live channel (Telegram, WhatsApp, etc.) before adding them. Use this to look up a person by username or phone number before calling contacts.sync.2 params
Search for a contact on a live channel (Telegram, WhatsApp, etc.) before adding them. Use this to look up a person by username or phone number before calling contacts.sync.
Parameters* required
channelstringChannel name: telegram, whatsapp, etc.
querystringUsername, phone, or name to search for
contacts_syncAdd a discovered contact and open a conversation thread. Returns thread_id for the new conversation. Call contacts.discover first to verify the contact exists.2 params
Add a discovered contact and open a conversation thread. Returns thread_id for the new conversation. Call contacts.discover first to verify the contact exists.
Parameters* required
channelstringChannel name: telegram, whatsapp, etc.
identifierstringUsername or phone number to add
files_ingestSave and index a file into the knowledge base. Use this when the user asks to save, store, or remember a document. The file will be processed (OCR if needed) and indexed for future search.5 params
Save and index a file into the knowledge base. Use this when the user asks to save, store, or remember a document. The file will be processed (OCR if needed) and indexed for future search.
Parameters* required
descriptionstringOptional description of the file contents.
file_idintegerID of the file to ingest (from attachment_file_ids in context).
tagsarrayOptional list of tags for categorization (e.g., ['presentation', 'dextrade']).
thread_idintegerOptional thread ID to associate the file with. If not provided, uses context thread.
titlestringHuman-readable title for the file (e.g., 'Project Presentation', 'Q1 Report'). If not provided, uses original filename.
files_readRead the contents of an attached file directly. Use this when the user asks 'what is in this file?' or 'read this document'. Works for text files (.txt, .md, .json, code files, etc.). For PDFs and images, suggests using knowledge.answer after indexing.4 params
Read the contents of an attached file directly. Use this when the user asks 'what is in this file?' or 'read this document'. Works for text files (.txt, .md, .json, code files, etc.). For PDFs and images, suggests using knowledge.answer after indexing.
Parameters* required
encodingstringText encoding to use (default: utf-8).default: utf-8
file_idintegerID of the file to read (from attachment_file_ids in context).
max_charsintegerMaximum characters to return (default: 10000). Use smaller values for large files.default: 10000
summarizebooleanIf true, generate AI summary instead of returning raw content. Use for 'summary', 'summarize', 'краткое содержание' requests.default: false
files_uploadUpload a file to DialogBrain and get a file_id for use in messages_send. When to use: - User wants to send a file/image to a contact - Before calling messages_send with an attachment Returns: file_id (integer) to pass to messages_send attachments parameter.5 params
Upload a file to DialogBrain and get a file_id for use in messages_send. When to use: - User wants to send a file/image to a contact - Before calling messages_send with an attachment Returns: file_id (integer) to pass to messages_send attachments parameter.
Parameters* required
contentstringBase64-encoded file bytes. Either content OR source_url is required.
filenamestringFilename with extension (e.g. 'photo.png')default: upload
mime_typestringMIME type (e.g. 'image/png', 'application/pdf')default: application/octet-stream
source_urlstringPublic URL to fetch file from. Either content OR source_url is required.
titlestringOptional display title
files_infoGet metadata and download URLs for files by their IDs. When to use: - After messages_read_history returns attachment_file_ids - To get a presigned download URL to read a received file Returns: filename, mime_type, byte_size, download_url (1-hour presigned URL).1 params
Get metadata and download URLs for files by their IDs. When to use: - After messages_read_history returns attachment_file_ids - To get a presigned download URL to read a received file Returns: filename, mime_type, byte_size, download_url (1-hour presigned URL).
Parameters* required
file_idsarrayList of file IDs (max 20)
files_get_base64Download one or more files server-side and return their content as base64-encoded strings. Use this to inspect images, PDFs, or any binary file attached to messages when you cannot access presigned S3 URLs directly. Supports up to 5 files per call, max 5 MB each. For large fil...1 params
Download one or more files server-side and return their content as base64-encoded strings. Use this to inspect images, PDFs, or any binary file attached to messages when you cannot access presigned S3 URLs directly. Supports up to 5 files per call, max 5 MB each. For large fil...
Parameters* required
file_idsarrayList of file IDs to fetch as base64 (max 5). Get IDs from files.info or message attachment_file_ids.
messages_read_historyRead messages from a conversation thread in chronological order. Returns the most recent messages, including sender info and timestamps. Usage: 1. Get thread_id from threads.list first, OR 2. Use contact_name to auto-resolve thread_id Examples: - User: 'show me messages from c...5 params
Read messages from a conversation thread in chronological order. Returns the most recent messages, including sender info and timestamps. Usage: 1. Get thread_id from threads.list first, OR 2. Use contact_name to auto-resolve thread_id Examples: - User: 'show me messages from c...
Parameters* required
contact_namestringContact/thread name to search for (optional if thread_id provided). Example: 'Jane Smith', 'John Doe'
include_outgoingbooleanInclude messages sent by you (default: true)default: true
limitintegerMaximum number of messages to return (default: 10, max: 100)default: 10
offsetintegerNumber of messages to skip (for pagination, default: 0)default: 0
thread_idstringThread ID to read messages from (e.g., '571' or 'telegram:571'). Optional if contact_name provided.
threads_list💬 List conversation threads/chats with previews and metadata. When to use: - User asks 'show my chats' or 'list my conversations' - User asks 'who did I chat with recently?' - Before using messages.read_history to get thread_id - To discover available conversations Examples:...12 params
💬 List conversation threads/chats with previews and metadata. When to use: - User asks 'show my chats' or 'list my conversations' - User asks 'who did I chat with recently?' - Before using messages.read_history to get thread_id - To discover available conversations Examples:...
Parameters* required
channelstringFilter by channel typeone of
telegram · email · whatsapp · sms · slackinclude_archivedbooleanInclude archived threadsdefault: false
kindstringFilter by conversation type: 'dm' (direct message), 'group', 'channel'one of
dm · group · channellimitintegerMaximum number of threads to returndefault: 20
max_inactive_daysintegerFilter threads where YOUR last message is within N days. Use this for 'recently contacted', 'active conversations'. Example: max_inactive_days=7 means you sent a message within last 7 days.
min_inactive_daysintegerFilter threads where YOUR last message is older than N days. Use this for 'not contacted in X days', 'dormant conversations', etc. Example: min_inactive_days=5 means you haven't sent a message in 5...
min_last_message_daysintegerFilter threads where the LAST MESSAGE (from anyone) is older than N days. Use this for 'chats where last message was more than X days ago'. Example: min_last_message_days=5 means no messages in 5+...
only_unreadbooleanOnly return threads with unread messages (unread_count > 0)default: false
orderstringSort order: 'desc' (newest first, default) or 'asc' (oldest first)one of
desc · ascdefault: descorder_bystringSort results by: 'last_message_at' (default), 'message_count', 'created_at'one of
last_message_at · message_count · created_atdefault: last_message_atparticipant_namestringFilter threads by participant name (optional)
user_sent_messagebooleanFilter: only threads where you have sent at least one message. Use this to exclude threads where you never participated.
messages_sendSend a message to a thread, channel, or contact. Supports Telegram, Email, and other connected channels. Can automatically resolve recipients and channels when not specified.11 params
Send a message to a thread, channel, or contact. Supports Telegram, Email, and other connected channels. Can automatically resolve recipients and channels when not specified.
Parameters* required
attachmentsarrayUploaded file IDs to attach (from /api/files)
bccarrayEmail addresses to BCC (blind carbon copy). Only for email channel.
ccarrayEmail addresses to CC (carbon copy). Only for email channel.
formatstringMessage formatone of
text · markdown · htmldefault: textrecipient_emailstringEmail address to send to (e.g., 'john@example.com'). Creates new email thread. Only for email channel.
recipient_namestringName of person to send to (e.g., 'Jane', 'John'). Tool will auto-resolve channel. Optional if thread_id provided.
reply_to_message_idstringID of message to reply to (optional)
silentbooleanSend without notificationdefault: false
subjectstringEmail subject line. Required for new emails, optional for replies (auto-generates 'Re: ...').
textstringMessage text to send. Optional if attachments provided.default:
thread_idstringThread/channel ID to send to (e.g., 'telegram:123456'). Optional if recipient_name provided.
messages_deleteDelete a message from a thread. Supports Telegram, WhatsApp, and other connected channels. Note: Some channels have time limits on message deletion.2 params
Delete a message from a thread. Supports Telegram, WhatsApp, and other connected channels. Note: Some channels have time limits on message deletion.
Parameters* required
message_idstringID of the message to delete
thread_idstringThread/channel ID containing the message
kg_find_entityFind an entity by name in the Knowledge Graph. USE WHEN user mentions a person, project, company by name and you need: - To resolve a name to entity_id for subsequent queries - 'Кто работает над X?' → find X first - 'Расскажи про Y' → find Y first RETURNS entity_id for use in...3 params
Find an entity by name in the Knowledge Graph. USE WHEN user mentions a person, project, company by name and you need: - To resolve a name to entity_id for subsequent queries - 'Кто работает над X?' → find X first - 'Расскажи про Y' → find Y first RETURNS entity_id for use in...
Parameters* required
entity_typestringFilter by entity type:
- 'person': People, contacts
- 'project': Projects, tasks
- 'organization': Companies, teams
- 'event': Meetings, deadlines
- 'topic': Discussion topics
- 'workspace': User's...one of
person · project · organization · event · topic · workspacelimitintegerMaximum results to return (1-10). Default: 5default: 5
namestringEntity name to search for. Can be in any language (Russian, English, etc.) - transliteration is automatic.
kg_get_relationshipsGet relationships for a specific entity from Knowledge Graph. USE WHEN: - 'Кто работает над X?' - filter by works_on - 'С кем общался Y?' - filter by discussed_with - 'Кто из компании Z?' - filter by member_of - 'Что связано с W?' - no filter, get all REQUIRES: entity_id from...4 params
Get relationships for a specific entity from Knowledge Graph. USE WHEN: - 'Кто работает над X?' - filter by works_on - 'С кем общался Y?' - filter by discussed_with - 'Кто из компании Z?' - filter by member_of - 'Что связано с W?' - no filter, get all REQUIRES: entity_id from...
Parameters* required
directionstringRelationship direction:
- 'outgoing': Entity → Others
- 'incoming': Others → Entity
- 'both': All relationships (default)one of
incoming · outgoing · bothdefault: bothentity_idstringEntity ID from kg.find_entity step. Use {{step_N.entity_id}} reference.
limitintegerMaximum relationships to return (1-50). Default: 20default: 20
relation_typesarrayFilter by relationship types (optional):
People: works_on, works_for, member_of, manages, knows, client_of, provides_service
Communication: discussed_with, participated_in, mentioned_in
Org/Project...
web_searchSearch the web for current information, news, facts, prices, or events. Use this when the user asks about something that requires up-to-date information from the internet, or when internal knowledge base doesn't have the answer. Examples: recent news, stock prices, weather, pr...3 params
Search the web for current information, news, facts, prices, or events. Use this when the user asks about something that requires up-to-date information from the internet, or when internal knowledge base doesn't have the answer. Examples: recent news, stock prices, weather, pr...
Parameters* required
num_resultsintegerNumber of results to return (1-10).default: 5
querystringSearch query - what to search for on the web.
search_typestringType of search: 'search' for general web, 'news' for news articles.one of
search · newsdefault: searchworkspace_searchUniversal multi-search across workspace: files, links, chats, messages. KEY FEATURE: Can search multiple types in parallel and return sectioned results. Usage options: 1. scope='auto' (default) - tool auto-detects what to search from query 2. scope=['files'] - search only file...28 params
Universal multi-search across workspace: files, links, chats, messages. KEY FEATURE: Can search multiple types in parallel and return sectioned results. Usage options: 1. scope='auto' (default) - tool auto-detects what to search from query 2. scope=['files'] - search only file...
Parameters* required
attachment_extstringFilter by attachment extension (pdf, md, ...).
attachment_namestringFilter by attachment/file name (e.g., 'readme.md').
channelstringFilter by channel (telegram, email, ...).
contact_hintstringName hint to find links associated with a specific contact (for goal='links').
date_fromstringISO8601 date string (YYYY-MM-DD) for time filtering.
Use context variables: {{context.yesterday}}, {{context.today}}, {{context.week_start}}, {{context.month_ago}}
date_tostringISO8601 date string (YYYY-MM-DD) for time filtering end bound.
Use with date_from for date ranges.
days_backintegerFor unanswered threads: only include threads with activity in last N days (default: 90).default: 90
document_typestringFilter files by document type (for goal='files'): invoice, contract, presentation, report, proposal, resume, letter, manual, spreadsheet.one of
invoice · contract · presentation · report · proposal · resumefile_idstringFind file by exact ID. Returns empty if file not found or not owned by user.
file_originstringFilter files by origin (for goal='files'): 'generated' for files I created (invoices from tools), 'received' for files from messages/attachments, 'uploaded' for files I manually uploaded. Use 'gene...one of
generated · received · uploadedgoalstring[LEGACY - use scope instead] Single search target for backward compatibility.
If both scope and goal provided, scope takes precedence.one of
links · messages · threads · fileskindstringFilter by thread type: 'dm' (direct message), 'group', or 'channel'.one of
dm · group · channellimitintegerMaximum number of items to return.default: 10
link_kindstringFilter by link type (for goal='links'): email, calendly, twitter, telegram, linkedin, github, google_doc, google_sheet, google_slides, google_drive, google_meet, instagram, facebook, youtube, tikto...one of
email · calendly · twitter · telegram · linkedin · githubmin_inactive_daysintegerOnly return threads where USER hasn't replied in N days (filters by user's last outgoing message).
min_last_message_daysintegerOnly return threads where LAST MESSAGE (from anyone) is older than N days (dormant/inactive chats).
only_dmsbooleanRestrict to direct messages (shortcut for kind='dm').default: false
only_incomingbooleanFilter to incoming messages only (messages FROM others). Use for 'что писал X', 'сообщения от X'.default: false
only_outgoingbooleanFilter to outgoing messages only (messages YOU sent). Use for 'что я писал', 'мои сообщения'.default: false
only_unansweredbooleanLimit to unanswered threads (last message incoming).default: false
+8 more parameters. See the server's own documentation for the full schema.
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.
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
{
"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 for the registry manifest and 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.
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Registryactive
TransportHTTP
UpdatedMay 17, 2026
