Dialogbrain MCP Server — 157 Tools with Risk Policies

// ALL 157 DIALOGBRAIN TOOLS

READ 62 tools

Read agents_ask Send a message to an AI agent and get its response. The agent runs with its configured prompt, tools, and ... Read agents_get Get detailed information about a specific AI agent. Returns full agent config including: - Execution confi... Read agents_list List all AI agents configured in the workspace. Returns agents with their basic info, trigger count, and k... Read agents_list_drafts List pending agent drafts awaiting approval. Shows drafts that have been generated by AI agents but not ye... Read agents_list_files List files directly attached to this agent (agent-specific files, not shared collections). Returns file_id... Read agents_trace_get Fetch the full execution detail for a single trace — tool executions, events timeline, LLM call spans (with... Read agents_traces_list List recent execution traces for an agent — the same data as /admin/requests, scoped to one agent and reada... Read agents_traces_stats Aggregated trace statistics for one agent over the last N days — total runs, success rate, avg duration, er... Read ai_filters_list List all AI filters for the current workspace. AI filters are semantic intent-based message filters that u... Read ai_filters_test Test a message against an AI filter to check whether it would match. This tool embeds the provided message... Read ai_tags_list List all personal AI tags. AI tags are automatic message filters: the system runs a lightweight classifier... Read calendar_check_availability Check when you have free time in Google Calendar. Shows busy periods and free slots in a given time range. ... Read calendar_list_events List events from Google Calendar. Shows upcoming events by default. Can filter by date range and search query. Read calls_get_transcript Get the structured transcript and final state of a voice call by call_id. Returns per-turn rows in chronolo... Read calls_list_active List active voice calls in this workspace. Use before calls.make on a Telegram account (only one MTProto ca... Read calls_list_history Search historical voice calls in this workspace by participant name, contact_id, thread, channel, source, a... Read collections_list List all knowledge collections in the workspace. Collections are named groups of files used for RAG search... Read collections_list_files List all files in a knowledge collection with their indexing status and chunk counts. Each returned file ha... Read contacts_find 👤 Search for contacts in your address book by name or username. When to use: - User asks 'find contact X'... Read contacts_profile 👤 Get full profile for a contact: all channel identities, notes, role, capabilities, birthday. When to us... Read files_get_base64 Download one or more files server-side and return their content as base64-encoded strings. Use this to insp... Read files_info Get metadata and download URLs for files by their IDs. When to use: - After messages_read_history returns ... Read files_read Read **text content** of an attached file. Works for: .txt, .md, .json, code files, and PDFs (after files.i... Read group_list List groups you've found and joined in this workspace. Lifecycle values: - discovered: found but not yet e... Read group_preview_messages Read recent public messages from a group without joining it. Only works for groups where can_preview_histor... Read group_scan Scan a group to evaluate its quality before joining. Fetches recent messages, analyzes activity, spam, and ... Read group_search Search for public groups or channels by topic on Telegram (or other channels). Returns matching groups with... Read images_search Searches images in this workspace by visual content using vector embeddings (Voyage multimodal-3). Pass a t... Read instagram_list_media List photos and Reels on the connected Instagram Business/Creator account. Returns id, caption, media_type,... Read job_read_context Read the current job context. Returns the full state of your active job including assignments, escalations,... Read kg_find_entity Find an entity by name in the Knowledge Graph. USE WHEN user mentions a person, project, company by name a... Read kg_get_relationships Get relationships for a specific entity from Knowledge Graph. USE WHEN: - 'Кто работает над X?' - filter b... Read knowledge_query Answer questions using knowledge base (uploaded documents, handbooks, files). Use for QUESTIONS that need ... Read linkedin_get_company Get a LinkedIn company profile by company ID or vanity name. Returns company name, description, industry, s... Read linkedin_get_profile Get a LinkedIn user profile by ID, public identifier (vanity name), or profile URL. Returns name, headline,... Read linkedin_list_connections List your LinkedIn connections, sorted by most recently added. Read linkedin_list_invitations_sent List your pending sent connection invitations on LinkedIn. Read linkedin_list_reactions List all reactions (likes, celebrates, etc.) on a specific LinkedIn post. Read linkedin_search Search LinkedIn for people, companies, jobs, or posts. Supports filtering by keywords, location, industry, ... Read linkedin_search_filters Get LinkedIn search filter parameter IDs. LinkedIn uses internal IDs instead of text for search filters (lo... Read messages_read_history Read messages from a conversation thread. Use text_contains to find specific messages by content. Returns t... Read notes_recall Recall notes from your notebook. By default returns only your own notes (all scopes, newest first). Pass fi... Read notes_search Full-text search in your notebook. By default searches only your own notes. Pass filter_agent_id=<int> to s... Read prompts_get Get full content of a prompt template: system instructions (prompt_text) and auto-reply rules. Run prompts... Read prompts_list List all prompt templates in this workspace. Returns id + name + description + category so you know which ... Read reminder_list List your active reminders (both one-time and recurring). Read search_files Search files and attachments across the workspace — by content, filename, document type, or origin. For mes... Read search_links Search links/URLs shared across the workspace — by type, owner, or associated contact. For files use search... Read search_messages Search message content across all chats — semantic + keyword. Use to find what was said: quotes, topics, in... Read search_threads Find or list chat threads/conversations — by topic, participant, unread/unanswered status, or recency. Omit... Read tasks_list List your tasks, or another agent's tasks (read-only) using from_agent_id. Use filters to narrow results. Read vision_query Look at the screen currently being shared in a meeting and answer a question about it. Returns a natural-la... Read web__local_search Multi-source web research with citations. Returns a synthesized answer with numbered [^1] markers and a cit... Read web_fetch Fetches a single URL and returns its content. Use this when you have a specific URL in mind — for example, ... Read web_search Search the web for current information, news, facts, prices, or events. Use this when the user asks about s... Read widgets_get Get full configuration of a single livechat widget. Returns all settings including theme, identification, ... Read widgets_get_embed_code Get the embed code snippet for a livechat widget. Returns HTML/JavaScript code to add to your website. The... Read widgets_list List all livechat widgets. Returns widgets with their configuration, embed code, and status. Use this whe... Read workspace_list List every workspace the caller is a member of, with `is_current` marking the workspace this MCP key is cur... Read youtube_list_comments List comment threads on a YouTube video. Pass video_id (e.g. 'dQw4w9WgXcQ') or channel_ref ('youtube:video:... Read youtube_list_videos List videos on the connected YouTube channel. Returns id, title, published_at, view_count. Paginate via pag... Read youtube_video_query Ask Gemini about a YouTube video. Pass a video URL and any prompt — verbatim transcript with timestamps, su...

WRITE 70 tools

Write agent_handoff Delegate a multi-step task (research, composing messages, booking, scheduling) to the full agentic planner.... Write agent_silence End this turn without sending any message. Use when the thread is owned by a human operator after job.escal... Write agents_add_file Attach a file to this agent's private knowledge (agent-specific files, not shared with other agents). Work... Write agents_approve_draft Approve a pending agent draft and send the message. The draft will be sent to the conversation it was gene... Write agents_create Create a new AI agent in the workspace. Execution modes: - ai_assisted (default, recommended): Two-phase A... Write agents_prompt_history List past versions of an agent's `prompt_text`. Every edit to the agent's prompt is snapshotted to an appen... Write agents_prompt_restore Restore a past version of an agent's `prompt_text` by version_number. Creates a new version pointing at the... Write agents_reject_draft Reject a pending agent draft without sending. The draft will be marked as rejected and won't be sent. Use ... Write agents_task_complete Report that a Claude Code agent task has been completed. Call this when you finish processing an agent_task... Write agents_update Update an existing AI agent's configuration. All parameters are optional — only provided fields will be up... Write agents_update_from_template Update a forked agent's instructions (prompt) to the latest version of the system template it was created f... Write ai_filters_create Create a new AI filter for semantic intent-based message matching. AI filters use vector embeddings (via V... Write ai_filters_update Update an existing AI filter's name, description, threshold, or active state. When to use: - User wants to... Write ai_tags_add_to_thread Apply one or more AI tags to a thread (manually). When to use: - User wants to label a conversation with o... Write ai_tags_create Create a new AI tag (automatic message filter). AI tags are lightweight classifiers that run on every inco... Write ai_tags_update Update an existing personal AI tag's name, description, icon, color, or active state. When to use: - User ... Write calendar_create_event Create a new event in Google Calendar. Specify the title, start time, end time, and optionally invite atten... Write calendar_update_event Update an existing event in Google Calendar. Can modify title, time, location, description, and attendees. ... Write calls_hangup Hang up an active voice call by call_id. Use after calls.make when the agent decides to terminate before th... Write calls_make Place an outbound AUDIO/VOICE phone call via Twilio (PSTN) or Telegram (MTProto 1:1 call). Use this any tim... Write calls_send_to_meet Dispatch a workspace AI agent into an active Google Meet call. The agent joins as a participant — it can he... Write calls_send_to_telegram_call Dispatch a workspace AI agent into a live Telegram GROUP voice chat OR an encrypted call-link conference. F... Write channels_connect_telegram_bot 🤖 Connect a Telegram Bot (Bot API) channel from its bot token. When to use: - After a bot was created via... Write collections_add_file Add a file to a knowledge collection. The file must be uploaded and indexed first (files_upload + files_in... Write collections_assign_agent Assign a knowledge collection to an AI agent. Once assigned, the agent's knowledge.query will automaticall... Write collections_create Create a named knowledge collection. Collections group files for RAG search. After creating, add files wit... Write contacts_add_channel 🔗 Link a new channel identity (email, phone, LinkedIn, etc.) to an existing contact. When to use: - User ... Write contacts_discover Search for a contact on a live channel (Telegram, WhatsApp, etc.) before adding them. Use this to look up a... Write contacts_sync Add a discovered contact and open a conversation thread. Returns thread_id for the new conversation. Call c... Write contacts_update ✏️ Update a contact's profile: name, notes, role, capabilities, birthday, preferred channel. When to use: ... Write documents_create Render a document (PDF / HTML / PPTX / DOCX) and save it to the workspace. This tool has two input pipelin... Write feedback_save Save a behavioral rule, preference, or correction that should guide future agent behavior. Use this when th... Write files_ingest Save and index a file into the knowledge base. Use this when the user asks to save, store, or remember a do... Write files_upload Upload a file to DialogBrain and get a file_id for use in messages_send. When to use: - User wants to send... Write folders_create 📁 Create a new inbox folder to organize threads. When to use: - User wants to create a folder to group re... Write group_add Add a specific group to your discovery list by @username or invite link (t.me/...). Groups and channels on... Write group_add_member Add a member to an existing group on Telegram or WhatsApp. What this does: - Adds the specified member to ... Write group_create Create a new group on a channel (Telegram or WhatsApp). Returns the new group's chat ID and invite link. W... Write group_promote_admin Promote a member to admin in an existing group on Telegram or WhatsApp. What this does: - Gives the specif... Write images_generate Generates a PNG image from a text prompt using Gemini 2.5 Flash Image. Returns a file_id consumable by mess... Write instagram_publish_media Publish a photo (IMAGE) or video (REELS) from workspace files to a connected Instagram Business/Creator acc... Write instagram_update_media Update the caption of a published Instagram photo or Reel. Only caption is editable after publish (Instagra... Write job_complete Mark the job as completed. This sanitizes PII from the context and records a completion summary. Use when a... Write job_escalate Escalate the job to a human. Use when you cannot resolve an issue, someone is not responding, or a situatio... Write job_update_context Update the job context by merging new data. Existing keys are preserved unless explicitly overwritten. Use ... Write linkedin_add_comment Add a comment to a LinkedIn post. Use post_id from search results or thread data. Write linkedin_invite Send a connection invitation to a LinkedIn user. Optionally include a personalized message (max 300 charact... Write linkedin_raw_request Send an arbitrary LinkedIn API request via Unipile's magic route. Only GET and POST methods are allowed. WA... Write linkedin_update_profile Update the authenticated user's own LinkedIn profile. Supports adding/editing experience entries (role, com... Write messages_forward Forward a message from one thread to another. Supports native Telegram forwarding (preserves original sende... Write messages_send Send a message to a thread, channel, or contact. Supports Telegram, Email, LinkedIn, and other connected ch... Write messages_send_email Compose and send an email — with subject, CC/BCC, and attachments. Use for email; for chat messages (Telegr... Write notes_save Save a fact or note into the agent's memory. Use scope to choose visibility: 'workspace' = visible to every... Write present_tab Share the agent's browser tab on the live call so everyone sees it as a real screen-share. Pass the page_id... Write prompts_prompt_history List past versions of a prompt template's `prompt_text`. Every edit is snapshotted to an append-only table ... Write prompts_prompt_restore Restore a past version of a prompt template by version_number. Creates a new version pointing at the restor... Write prompts_update Update a prompt template's name, system instructions, or auto-reply rules. Changes affect every agent usin... Write reminder_set Schedule a reminder. One-time reminders fire at a specific datetime. Recurring reminders fire on a schedule... Write tasks_create Create a new task in your to-do list. Write tasks_update Update an existing task. Set status='done' to complete it, 'cancelled' to cancel. Use summary for completio... Write threads_update ✏️ Update a conversation thread: rename it, add notes/description, or move to a folder. When to use: - Use... Write videos_generate Generate a short video (5-10s) from a text prompt using BytePlus Seedance. Optionally accepts up to 12 imag... Write widgets_create Create a new livechat widget for your website. The widget will be created with default settings. You can c... Write widgets_update Update an existing livechat widget configuration. You can change name, theme, auto-reply mode, and other s... Write workspace_current Return the workspace this MCP API key is currently routed to, with the caller's role inside it. Use this to... Write workspace_switch Re-point the active MCP API key to a different workspace. Pass exactly one of `workspace_id` or `slug` (fin... Write youtube_moderate_comment Apply a moderation status to a YouTube comment. Allowed status values: heldForReview, published, rejected, ... Write youtube_post_comment_reply Post a comment on a YouTube video, or reply to an existing comment. Pass video_id for a top-level comment, ... Write youtube_update_video Update title, description, privacy, or tags on a YouTube video. Costs 1600 quota units. Only fields provide... Write youtube_upload_video Upload a workspace-owned video file (file_id) to the connected YouTube channel. Returns video_id + thread_i...

DESTRUCTIVE 18 tools

Destructive agents_delete Permanently delete an AI agent. WARNING: This cannot be undone. The agent and all its triggers will be rem... Destructive agents_remove_file Remove a file from this agent's private knowledge. The file itself is not deleted — it's just detached fro... Destructive agents_trigger_delete Delete a trigger from an AI agent. WARNING: This cannot be undone. Destructive ai_filters_delete Permanently delete an AI filter. When to use: - User wants to remove a filter they no longer need This ac... Destructive ai_tags_delete Delete a personal AI tag. All thread associations are removed automatically. When to use: - User wants to ... Destructive ai_tags_remove_from_thread Remove a specific AI tag from a thread. When to use: - User wants to un-label or remove a specific tag fro... Destructive calendar_delete_event Delete an event from Google Calendar. This action cannot be undone. Use with caution. Destructive collections_delete Delete a knowledge collection. If the collection is assigned to agents, prompts, or channels, pass force=t... Destructive collections_remove_file Remove a file from a knowledge collection. The file itself is not deleted — only the collection membership... Destructive collections_unassign_agent Remove a knowledge collection from an AI agent. The collection and its files are not deleted — only the ag... Destructive folders_delete 🗑️ Delete an inbox folder. Threads inside become unfiled (not deleted). When to use: - User wants to remo... Destructive messages_delete Delete a message from a thread. Supports Telegram, WhatsApp, and other connected channels. Note: Some chann... Destructive notes_delete Delete a note by ID from the target notebook. Same identity rules as notes.save — agents can only delete fr... Destructive reminder_cancel Cancel an active reminder by its trigger ID. Destructive tasks_delete Delete a task from your to-do list by its ID. Destructive widgets_delete Delete a livechat widget permanently. This will remove the widget and its embed code will stop working. Ex... Destructive youtube_delete_comment Permanently delete a YouTube comment by id (or 'youtube:comment:<id>'). Cannot be undone. Costs 50 quota un... Destructive youtube_delete_video Permanently delete a YouTube video by id (or 'youtube:video:<id>'). Cannot be undone. Costs 50 quota units....

EXECUTE 7 tools

Execute agents_activity See what you — or another agent in your workspace — actually did over a time window: messages sent, documen... Execute agents_simulate_inbound Replay an inbound message on a thread through the real trigger pipeline and return what would have happened... Execute agents_trigger_create Create a new trigger for an AI agent. Triggers determine when the agent activates. Trigger types: - incom... Execute agents_trigger_update Update an existing AI agent trigger. All parameters are optional — only provided fields will be updated. Execute calls_wait Block until a voice call ends (status changes from 'active') or timeout elapses. Returns ended=true with fi... Execute group_join Join a group and start syncing its messages to your inbox. The group must be in your discovery list (use gr... Execute system_sleep Pause execution for a given number of seconds (max 30). Use when you need to wait for an external process t...

// FAQ

How many tools does the Dialogbrain MCP server have? +

The Dialogbrain MCP server exposes 157 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Dialogbrain tools? +

Route the Dialogbrain server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Dialogbrain tools fall into? +

Dialogbrain tools are categorised as Read (62), Write (70), Destructive (18), Execute (7). Each category has a recommended default policy.

DIALOGBRAIN TOOLS

Let agents act without letting them run wild.