Brainchat for AI assistants
Run your AI voice agents from Claude, ChatGPT and other assistants: check how calls are going, read transcripts, look up customers, start and pause calling campaigns, and set up what your voice agent can do — with live cards and charts right in the chat.
Server URL
https://portal.brainchat.cloud/mcp- Before you start
- Connect
- Sign-in and access
- Example prompts
- All tools
- In-chat views
- Safety
- Disconnect
- Troubleshooting
- Support
Before you start
- A Brainchat account that the Brainchat team has approved. Sign up or sign in.
- You must be an owner or admin of the workspace you connect. Members can’t connect a workspace.
- Placing calls and running campaigns uses the workspace’s call credit, and needs a caller ID number assigned to the workspace.
- An assistant that supports remote MCP connectors (custom connectors on paid plans of most assistants).
Connect
Claude
- Settings → Connectors → Add custom connector (or find Brainchat in the directory).
- Paste the server URL above and select Add, then Connect.
- Sign in to Brainchat and select Allow.
On Team and Enterprise plans an owner may need to add the connector for the organisation first.
ChatGPT
- Settings → Apps & Connectors (or find Brainchat in the app directory).
- For a custom connection: Advanced settings → turn on Developer mode → Create, paste the URL, authentication OAuth.
- Sign in to Brainchat and select Allow.
Gemini
- Where your plan offers custom MCP connected apps: add a new connected app / MCP server.
- Paste the server URL and complete the Brainchat sign-in.
Answers appear as text; Gemini doesn’t show the interactive cards.
Grok
- grok.com/connectors → New Connector → Custom.
- Paste the server URL and complete the Brainchat sign-in.
Other MCP clients
Any client that speaks MCP over Streamable HTTP with OAuth 2.1 works: it discovers sign-in from /.well-known/oauth-protected-resource, registers itself (dynamic client registration) and uses PKCE. Partner-branded portals serve the same connector at https://<your-portal-domain>/mcp.
Sign-in and access
- When you connect, a Brainchat sign-in page opens. Sign in (or use your open portal session), pick the workspace to start in, and select Allow.
- The assistant can act, as you, in every workspace you own or administer — including ones you get later. Ask it to switch (“switch to my Dhaka shop”) or name the workspace in a request (“compare this week’s calls in both workspaces”). If you stop being an owner or admin of a workspace, access to it ends straight away.
- Access tokens last one hour and renew automatically for up to 60 days of inactivity; each renewal replaces the old token.
- An owner or admin can disconnect the assistant from one workspace in Settings → AI assistants; it keeps working in the person’s other workspaces.
Example prompts
How did our calls go today?Workspace overview: credit, today’s calls, answer rate, active campaigns.
Show my running campaigns and pause the Gulshan one.Campaign list with progress, then pauses it after you confirm.
Create a campaign called “October leads” for these numbers, starting tomorrow at 10am.Creates and schedules it after you confirm the details.
Compare answered and fulfilled calls over the last 30 days.Call statistics with a per-day chart and the most common results.
What did Karim say on his last call?Finds the customer, opens the call: summary, collected details and transcript.
Move +8801711000001 to “site visit” in the CRM.Sets the customer’s sales stage.
Add these 40 packages from our WordPress site to Brainchat: https://example.com/toursReads the list, fills each package’s destination, duration and price, and adds them all at once.
Which products are running low? Set the black panjabi in XL to 20.Lists low stock, then changes that option’s stock.
Book the Bangkok trip, single room, for Rahim (01711000000) and mark it paid.Creates the booking for the right option, then moves it along.
Import our API from https://api.example.com/openapi.json and give the agent the order-lookup endpoints.Lists the endpoints with warnings, then imports and tests the ones you choose.
Add a tool that checks stock at https://stock.example.com/check by unit code.Creates an HTTP tool for the voice agent, then tests it.
All tools
Every tool is marked for the assistant as Read (looks only), Write (changes something — the assistant asks you first) or Destructive (can’t be undone).
| Tool | What it does | Type |
|---|---|---|
| Workspaces (shown when you own or administer more than one) | ||
list_workspaces | The workspaces the connection reaches, and which one is current. Every other tool takes an optional workspace (name or id). | Read |
switch_workspace | Make another workspace the current one for this connection. | Write |
| Overview and campaigns | ||
get_overview | Today at a glance: call credit, today’s and this week’s calls, active campaigns. | Read |
list_campaigns | Campaigns with progress — numbers called, answered, fulfilled. Filter by status. | Read |
get_campaign | One campaign: status, progress, callbacks, talk time, settings and latest results. | Read |
create_campaign | Create a calling campaign from a list of numbers, now or scheduled. Uses call credit. | Write |
duplicate_campaign | Run an earlier campaign again — all numbers or only the unreached ones. | Write |
pause_campaign | Pause a running or scheduled campaign. | Write |
resume_campaign | Resume a paused campaign. | Write |
cancel_campaign | Stop a campaign for good; numbers not yet called are skipped. | Destructive |
place_ai_call | Have the AI agent phone one person right now. | Write |
call_for_me | Have the AI agent phone someone as your personal assistant, with a goal — by number or a CRM contact’s name. | Write |
get_call_result | How a call placed from the chat went: goal reached, what they said and agreed, the transcript. | Read |
| Calls and customers | ||
get_call_stats | Totals, answer rate, fulfilled, talk time, cost and a per-day series for any period or campaign. | Read |
list_calls | Recent calls with result, length and the AI’s summary. Filter by period, campaign, answered or number. | Read |
get_call | One call: transcript, summary and the details collected. | Read |
find_customer | Look up customers by phone, name or anything they said: details, stage, calls. | Read |
set_customer_stage | Move a customer to a CRM sales stage, with a note. | Write |
| Catalog and orders (Social) — named for your business: products and orders for a shop, packages and bookings for a travel agency, courses and enrolments for a school… | ||
list_products | The catalog with price, stock, category and each item’s details. Search, filter by category or low stock, page through. | Read |
get_product | One item with its description, details and every option (variant) with price and stock. | Read |
add_products | Add one item or up to 500 at once — from a website, a sheet or a pasted list — with options, prices, stock, details and photos from links. Can update items that already exist. | Write |
update_product | Change an item’s name, description, details, category, tags, prices or stock. | Write |
archive_product | Take an item out of the catalog (past orders keep it). | Destructive |
list_orders | Orders with how many are in each status. Filter by status or period; search by number, customer or item. | Read |
get_order | One order: customer, items, totals, payment and status. | Read |
create_order | Place an order for a customer; it holds the stock and starts as pending. | Write |
update_order_status | Confirm, ship, deliver or cancel an order, or mark it paid. The customer gets the shop’s usual message. | Write |
| Train and set up the AI | ||
list_knowledge | The documents the AI answers from (calls and chats), their size and whether they are indexed. | Read |
add_knowledge | Train the AI on a document: web pages by link (up to 20 at once), or text — FAQs, prices, policies, or a file you share in the chat. | Write |
get_knowledge_doc | Read one knowledge document in full. | Read |
set_knowledge_always | Keep a short document in every prompt, even when a big knowledge base is searched. | Write |
delete_knowledge_doc | Remove a document; the AI stops answering from it. | Destructive |
search_knowledge | Ask a customer’s question and see which pieces of the knowledge the AI would answer from. | Read |
update_agent | Change the agent’s name, business, about, greeting, languages, speaking style, voice, closing and rules. | Write |
get_widget | The website call / chat widget’s settings, the sites it runs on and its embed code. | Read |
update_widget | Customise the widget: calls or chat, panel, colours, position, texts, suggested questions, theme, allowed sites. | Write |
list_channels | Connected chat channels (Facebook, Instagram, Telegram, TikTok, Google) and which can be connected. | Read |
connect_channel | Connect Telegram with its bot token; for Facebook, Instagram, TikTok and Google, the link to sign in. | Write |
disconnect_channel | Disconnect a channel; its conversations stay in the inbox. | Destructive |
| The voice agent and its tools | ||
get_agent | The agent’s name, voice, languages, greeting, style and guardrails. | Read |
list_agent_tools | Built-in tools, custom HTTP tools and connected MCP servers, with status and usage. | Read |
create_agent_tool | Give the agent a new HTTP tool it can call during calls. | Write |
update_agent_tool | Change a custom tool’s description, URL, parameters, headers or settings. | Write |
set_agent_tool_status | Switch a tool on or off (custom or switchable built-in). | Write |
delete_agent_tool | Delete a custom tool. | Destructive |
test_agent_tool | Call a tool for real with sample input; tools that change data only with your consent. | Write |
preview_api_import | Read an OpenAPI / Swagger file, Postman collection or cURL command and list its endpoints with warnings. Saves nothing. | Read |
import_api_tools | Turn chosen endpoints into tools; read-only ones are tested first, anything that changes data starts switched off. | Write |
connect_mcp_server | Connect another MCP server so the agent can use its tools. | Write |
set_mcp_server_tool | Switch a connected MCP server’s tool on or off. | Write |
remove_mcp_server | Disconnect an MCP server from the agent. | Destructive |
In-chat views
In Claude, ChatGPT and other assistants that support interactive views, answers come with a card: stat tiles and a calls-per-day chart for the overview and statistics, campaign cards with Pause, Resume and Cancel buttons, call cards with the transcript, customer cards, and tool lists with Turn on / Turn off. Cards follow the assistant’s light or dark theme and need no extra permissions — buttons work through the same tools. Where cards aren’t supported you get the same information as text.
Safety
- You confirm real-world actions. Starting campaigns, placing AI calls, switching tools on, deleting and testing tools that change data are marked as write or destructive, and the connector asks the assistant to confirm with you first.
- Secrets stay in Brainchat. API keys and tokens saved for tools or MCP servers are never shown back in the chat. Keys you type into a chat are visible to that assistant — you can enter them in the portal instead (AI Agent → Tools).
- Same rules as the portal: at most 25 custom tools, tools can’t call private networks, every tool change is checked before it reaches live calls, and requests are rate-limited per connection.
- Read the privacy policy for what is shared with the assistant.
Disconnect
- In Brainchat: Settings → AI assistants lists every assistant connected to the workspace — select Disconnect. Workspace owners and admins can disconnect any of them.
- Or remove the connector in the assistant’s own settings.
Troubleshooting
| What you see | What to do |
|---|---|
| “Only owners and admins of a workspace can connect it” | Ask the workspace owner to make you an admin (Settings → Team), or to connect it themselves. |
| “Your account is waiting for approval” | New accounts are approved by the Brainchat team; you can connect once approved. |
| The assistant says it was signed out | Connect again. This happens after 60 days without use, after a disconnect, or if your role changed. |
| “No call credit left” / “No caller ID” | Top up from My profile, or ask Brainchat (or your partner) to assign a caller ID. |
| New tools don’t show up in the assistant | Refresh or reconnect the connector so the assistant reloads the tool list. |
| “Too many requests” | Wait a minute — each connection can make a few hundred requests per minute. |
Support
Email ariyantheguy@gmail.com with your workspace name and what you asked the assistant. Privacy questions: see the privacy policy.