Integration

Brainbase Labs integration

Brainbase Labs runs enterprise AI agents (workers) whose behaviour is written as flows in the Based language and deployed on phone numbers, chat and website chat widgets. Manage workers, flows and flow versions, voice, chat and chat-embed deployments and their parameters, start or stop outbound batch calls and campaigns, read call and chat logs, sessions and voice usage, export logs, and manage phone numbers, Twilio integrations, tags, business hours and knowledge-base folders and links. Not exposed: Echo testing, worker tests, LLM and runtime-error logs, SMS and WhatsApp logs, custom voices, custom webhooks, default checks, Voice V1 deployments, phone-number purchase, knowledge-base file upload, the Twilio subaccount credentials and internal webhook receivers. Authentication is a team API key sent in the x-api-key header.

Connect Brainbase Labs How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Brainbase Labs.Built from the 96 Brainbase Labs tools below, on the connection you add once.

What you can do with Brainbase Labs

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Chat, 7 operations

create_chat_deploymentCreate chat deploymentPOSTCreates a chat deployment that serves a flow. name and flowId are required; allowedUsers, welcome message, LLM model, extractions and success criteria are optional.
delete_chat_deploymentDelete chat deploymentDELETEDeletes a chat deployment of a worker.
get_chat_deploymentGet chat deploymentGETReturns one chat deployment of a worker: allowed users, welcome message, LLM model, model settings and chat agent id.
get_chat_logGet chat logGETReturns one chat conversation log of a worker: user, messages, rating, feedback, message count and duration.
list_chat_deploymentsList chat deploymentsGETLists a worker's chat deployments with allowed users, welcome message, LLM model, model settings and chat agent id.
list_chat_logsList chat logsGETLists the chat conversation logs of a worker, optionally for one deployment or flow: user, messages, rating, feedback, message count and duration.
update_chat_deploymentUpdate chat deploymentPATCHUpdates a chat deployment: name, flow or pinned version, allowed users, welcome message, LLM model and settings, extractions or success criteria.

Chat embed, 7 operations

create_chat_embed_deploymentCreate chat embed deploymentPOSTCreates a chat-embed deployment, a chat widget for websites that serves a flow. name and flowId are required; welcome message, agent name and logo, color and styling are optional.
delete_chat_embed_deploymentDelete chat embed deploymentDELETEDeletes a chat-embed deployment of a worker.
get_chat_embed_deploymentGet chat embed deploymentGETReturns one chat-embed deployment of a worker: embed id, welcome message, agent name and logo, color and styling.
get_chat_embed_logGet chat embed logGETReturns one chat-widget conversation log of a worker: session, messages, status, origin URL, user agent, tool calls and latency.
list_chat_embed_deploymentsList chat embed deploymentsGETLists a worker's chat-embed deployments (a chat widget for websites): embed id, welcome message, agent name and logo, color and styling.
list_chat_embed_logsList chat embed logsGETLists the chat-widget conversation logs of a worker, optionally for one deployment, flow or session: messages, status, origin URL, tool calls and latency.
update_chat_embed_deploymentUpdate chat embed deploymentPATCHUpdates a chat-embed deployment: name, flow or pinned version, welcome message, agent name and logo, color or styling.

Tag, 7 operations

add_worker_tagAdd worker tagPOSTAssigns an existing team tag to a worker. Assigning a tag the worker already has is refused.
create_tagCreate tagPOSTCreates a team tag with a label and a color. A label that already exists in the team is refused.
delete_tagDelete tagDELETEDeletes a team tag, identified by its id from list_tags.
list_tagsList tagsGETLists the team's tags (label and color), which can be assigned to workers.
list_worker_tagsList worker tagsGETLists the team tags assigned to one worker.
remove_worker_tagRemove worker tagDELETERemoves a tag from a worker; the tag itself stays in the team.
update_tagUpdate tagPATCHChanges the label or the color of a team tag.

Voice, 7 operations

create_voice_deploymentCreate voice deploymentPOSTPuts a flow on a phone number as a voice deployment. name, phoneNumber and flowId are required; flowVersionId pins a committed version.
delete_voice_deploymentDelete voice deploymentDELETEDeletes a voice deployment of a worker.
get_voice_deploymentGet voice deploymentGETReturns one voice deployment of a worker: phone number, voice provider and voice, backup number and message, and allowed countries.
get_voice_logGet voice logGETReturns one call log of a worker: numbers, direction, status, duration, transcription, messages, recording URL, call data with latency metrics and transfer details.
list_voice_deploymentsList voice deploymentsGETLists a worker's voice deployments, the phone channel of its flows: phone number, voice provider and voice, backup number and allowed countries.
list_voice_logsList voice logsGETLists a worker's call logs with filters (deployment, flow, direction, numbers, status, transcript text, start or end time, duration) and page or cursor paging. Pass fields to return only some fields.
update_voice_deploymentUpdate voice deploymentPATCHUpdates a voice deployment: name, phone or backup number, flow or pinned version, voice settings, extractions, success criteria or custom webhooks. changeComment describes the change.

Flow, 6 operations

create_flowCreate flowPOSTCreates a flow in a worker from Based code. name, label and code are required; set validate to true to have Brainbase validate the code.
delete_flowDelete flowDELETEDeletes a flow from a worker.
get_flowGet flowGETReturns a flow by id without its worker id. Accepts the same versionId and deploymentId options as get_worker_flow.
get_worker_flowGet worker flowGETReturns one flow of a worker with its code and variables. Pass versionId to read a committed version, or deploymentId to also get that deployment's parameters merged in _mergedParameters.
list_flowsList flowsGETLists the flows of a worker. A flow holds an agent's behaviour as Based code; each item carries its code, variables, version number and last editor.
update_flowUpdate flowPATCHUpdates the name, label, Based code or variables of a flow. validate and commitMessage are optional; commit_flow_version records a numbered version.

Business hour, 5 operations

create_business_hoursCreate business hoursPOSTCreates a business-hours schedule: hours (a JSON object of opening hours), a timezone and optional primary and secondary tags.
delete_business_hoursDelete business hoursDELETEDeletes a business-hours schedule.
get_business_hoursGet business hoursGETReturns one business-hours schedule by id: hours, timezone and tags.
list_business_hoursList business hoursGETLists the team's business-hours schedules (opening hours, timezone and tags), which check_callable uses to decide whether a number may be called.
update_business_hoursUpdate business hoursPUTUpdates the hours, timezone or tags of a business-hours schedule.

Folder, 5 operations

create_folderCreate folderPOSTCreates a knowledge-base folder in a worker to group link and file resources.
delete_folderDelete folderDELETEDeletes a knowledge-base folder of a worker.
get_folderGet folderGETReturns one knowledge-base folder of a worker by id.
list_foldersList foldersGETLists the knowledge-base (RAG) folders of a worker.
update_folderUpdate folderPUTRenames a knowledge-base folder or changes its description.

Outbound campaign, 5 operations

create_outbound_campaignCreate outbound campaignPOSTCreates an outbound call campaign on a voice deployment from contact rows (data), with a batch size (default 1) and minutes between batches (default 2).
delete_outbound_campaignDelete outbound campaignDELETEDeletes an outbound campaign of a voice deployment.
get_outbound_campaignGet outbound campaignGETReturns one outbound campaign of a voice deployment: contact data, batch settings, status and dates.
list_outbound_campaignsList outbound campaignsGETLists the outbound call campaigns of a voice deployment with contact data, batch settings and status.
update_outbound_campaignUpdate outbound campaignPATCHUpdates an outbound campaign: name, description, status, contact data, batch settings, additional data or telephony provider configuration.

Team phone hour, 5 operations

create_team_phone_hoursCreate team phone hoursPOSTLinks a phone number to a business-hours schedule (hoursId) for the team (teamId from get_team).
delete_team_phone_hoursDelete team phone hoursDELETEDeletes a link between a phone number and a business-hours schedule.
get_team_phone_hoursGet team phone hoursGETReturns one link between a phone number and a business-hours schedule.
list_team_phone_hoursList team phone hoursGETLists the links between team phone numbers and business-hours schedules, optionally for one phone number or team.
update_team_phone_hoursUpdate team phone hoursPUTChanges the phone number, schedule or team of a team phone hours link.

Worker, 5 operations

create_workerCreate workerPOSTCreates a worker, the agent that owns flows, deployments and a knowledge base. name, description and status are required.
delete_workerDelete workerDELETEDeletes a worker, identified by its id from list_workers.
get_workerGet workerGETReturns one worker by id: name, description, status, engine version, icon and dates.
list_workersList workersGETLists every worker (agent) of the team with name, description, status, engine version, icon and dates.
update_workerUpdate workerPATCHChanges the name, description or status of a worker.

Param, 4 operations

create_deployment_paramCreate deployment paramPOSTAdds a named parameter with a string value to a deployment.
delete_deployment_paramDelete deployment paramDELETEDeletes a parameter from a deployment.
list_deployment_paramsList deployment paramsGETLists the parameters of a deployment: named string values that get_flow merges into the flow's parameters when given that deploymentId.
update_deployment_paramUpdate deployment paramPATCHChanges the value or description of a deployment parameter.

Export, 3 operations

create_log_exportCreate log exportPOSTQueues a background export of deployment logs to a CSV or JSON file, for at most 90 days. Returns the export id with status PENDING; read the result with get_log_export. One active export per team.
get_log_exportGet log exportGETReturns the status of a log export (PENDING, PROCESSING, COMPLETED, FAILED or EXPIRED). Once it is COMPLETED, downloadUrl holds a presigned link to the file, valid for 24 hours.
list_log_exportsList log exportsGETLists the team's 20 most recent log exports with status, format, log type, row count, file size, creation and expiry dates.

Integration, 3 operations

get_integrationGet integrationGETReturns one integration of the team by id: name, description, app type and dates. Stored credentials are not returned.
list_integrationsList integrationsGETLists the team's integrations (such as connected Twilio accounts): id, name, description, app type and dates. Stored credentials are not returned.
update_integrationUpdate integrationPATCHRenames an integration or changes its description; nothing else about it can be changed here.

Resource, 3 operations

delete_resourceDelete resourceDELETEDeletes a knowledge-base resource (a link or a file) of a worker.
get_resourceGet resourceGETReturns one knowledge-base resource (a link or a file) of a worker by id.
list_folder_resourcesList folder resourcesGETLists the knowledge-base resources (links and files) inside one folder.

Version, 3 operations

commit_flow_versionCommit flow versionPOSTSnapshots the current code and variables of a flow as a new numbered version with a commit message. A deployment can pin that version through flowVersionId.
get_flow_versionGet flow versionGETReturns one committed version of a flow with its code, variables, commit message and author.
list_flow_versionsList flow versionsGETLists the committed versions of a flow, highest version number first, with total and hasMore for paging.

Delete, 2 operations

delete_phone_numberDelete phone numberDELETERemoves a registered phone number from the team. Refused while a voice deployment uses the number.
delete_twilio_integrationDelete twilio integrationDELETEDeletes a Twilio integration. Refused while phone numbers imported from it are still registered; remove them first with delete_phone_number.

Link, 2 operations

create_link_resourceCreate link resourcePOSTAdds a web page to a worker's knowledge base from its URL, with an update frequency and an optional folder. Brainbase processes it in the background; status shows its progress.
list_link_resourcesList link resourcesGETLists the web-link resources of a worker's knowledge base with URL, update frequency, folder and processing status.

By embed, 1 operation

get_chat_embed_deployment_by_embedGet chat embed deployment by embedGETFinds a chat-embed deployment from its embed id, without the worker id.

Check callable, 1 operation

check_callableCheck callablePOSTTells whether a phone number may be called at a UTC Unix timestamp: the time is converted to the timezone of the number's business hours and checked against that day's hours.

Create, 1 operation

create_twilio_integrationCreate twilio integrationPOSTConnects a Twilio account to the team from its Account SID and Auth Token (Brainbase encrypts the token before storing it). Refused when an integration with the same Account SID exists.

Deployment, 1 operation

get_deploymentGet deploymentGETReturns any deployment (voice, chat, chat embed or another channel) by id without its worker id: name, type, status, worker, flow, pinned version and that channel's own settings. include adds parameters, success criteria or sentinel assignments.

File, 1 operation

list_file_resourcesList file resourcesGETLists the files of a worker's knowledge base with file name, MIME type, size, folder and processing status. Adding files is not available in this integration.

History, 1 operation

list_deployment_historyList deployment historyGETLists the change history of a deployment (flow version, config, voice settings, status and parameter changes) with previous and new values, paged by limit and offset.

Log, 1 operation

get_logGet logGETReturns any deployment log (a call, chat or other conversation record) by id without its worker or deployment id: type, worker, deployment, flow, extracted data, metadata, transfer data and the channel's own fields (transcript, messages, numbers).

Make batch call, 1 operation

make_batch_callsMake batch callsPOSTPlaces real outbound phone calls from a voice deployment, one per row of data, in batches of batch_size every batch_interval_minutes. stop_batch_calls or stop_campaign_calls removes calls still queued.

Move, 1 operation

move_resourceMove resourcePOSTMoves a knowledge-base resource to another folder, or out of any folder when folderId is null.

Phone number, 1 operation

list_phone_numbersList phone numbersGETLists the phone numbers registered to the team: number, provider, Twilio integration, worker, country code, caller name and A2P verification. Pass integrationId to list one integration's numbers.

Query, 1 operation

query_resourcesQuery resourcesPOSTSearches a worker's knowledge base with a natural-language query (vector search), optionally limited to some resources or one folder, and returns the result data from the RAG service.

Register phone number, 1 operation

register_phone_numberRegister phone numberPOSTRegisters a phone number that a connected Twilio account owns, so deployments can use it. Refused when the number is already registered or is not owned by that Twilio account.

Session, 1 operation

get_sessionGet sessionGETReturns one session of a worker: status, start and end, minutes, input and output tokens, state, messages, trace and error.

Stop batch call, 1 operation

stop_batch_callsStop batch callsPOSTRemoves every batch call still queued for a voice deployment and returns the removed queue items and their count.

Stop campaign, 1 operation

stop_campaign_callsStop campaign callsPOSTRemoves the queued calls of one campaign of a voice deployment and returns the removed queue items and their count.

Team, 1 operation

get_teamGet teamGETReturns the Brainbase team that owns the API key: id, name, owner and creation dates. Its id is the teamId that create_team_phone_hours needs.

Voice analysis, 1 operation

get_voice_analysisGet voice analysisPOSTReports voice usage for a date range: calls, minutes and transfers in total, per period (daily to yearly) and per deployment, plus each call when includeCallDetails is true.

Use Brainbase Labs from Claude Code, Cursor or Codex

Connect Brainbase Labs in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Brainbase Labs operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Brainbase Labs

Create your workspace
Sign up free. Nothing to install.
Connect Brainbase Labs once
Add your Brainbase Labs connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.