Skip to main content
Tools let your AI agent take actions during a conversation – transfer calls, hand the caller to another agent, end calls, call external APIs, or invoke remote MCP servers – based on the context of the conversation and your prompt instructions. When a tool is attached to a workflow node, the LLM decides when to invoke it and what parameters to pass, based on the user’s spoken intent and your node-level instructions.

Tool Types

Bananaflow provides two categories of tools:

Built-in Tools

Pre-configured tools that handle common telephony operations out of the box:
  • Call Transfer – Transfer the active call to a phone number or SIP endpoint
  • Transfer to Agent – Hand the live call to another agent, carrying conversation history as a labeled transcript
  • End Call – Terminate the call when the conversation is complete

Custom Tools

Tools you define to integrate with any external system:
  • HTTP API – Call any REST API endpoint during a conversation (e.g., CRM updates, data lookups, triggering automations)
  • MCP Tool – Connect an external MCP server and expose its remote tools to the LLM during a conversation
  • Calculator – Do arithmetic during the call. It supports +, -, *, /, **, % and parentheses.
  • Integration – Run an action in a connected app, like sending a Gmail email or creating a Google Calendar event. See Integration tools.
  • Reasoner – Hand one hard question, like a bill total or a policy rule, to a slower model that works it out while the agent keeps talking. You do not create it in the Create New Tool dialog. Ask your AI assistant to add it through the MCP server.

Integration tools

An integration tool runs one action in an app you have connected, for example “create a contact” in HubSpot or “send an email” in Gmail.
  1. On the Tools page, click Create Tool and choose Integration.
  2. Search for the app, like Gmail or Slack, then choose an action.
  3. If the app is not connected yet, a sign-in window opens. Finish the sign-in there.
  4. Fill in the arguments and save.
The Connections tab on the Tools page lists every app you have connected. If you disconnect an app, every integration tool built on it stops working at once. Nothing is deleted. Connect the app again and the same tools work again.

Manage your tools

The Tools page has three tabs:
  • Tools – your active tools.
  • Archived – tools you archived. You can bring one back.
  • Connections – the apps behind your integration tools.
Your AI assistant can also change a saved tool for you. With the MCP server, it can rename a tool, rewrite its description, change its start message, change an HTTP tool’s URL, headers and parameters, and archive or bring back a tool. The change reaches every agent that uses the tool from the next call. The details are in Bananaflow MCP Server.

How Tools Work

  1. You define a tool with a name, description, and parameters
  2. You attach the tool to one or more workflow nodes
  3. During a call, the LLM reads your node prompt, the tool description, and the caller’s intent to decide whether to invoke the tool
  4. The tool executes and returns a result that the agent can use to continue the conversation

Best Practices

  • Attach only relevant tools to each node – fewer tools means more reliable invocations
  • Write clear tool descriptions – the LLM uses these to decide when to call the tool
  • Guide the LLM in your node prompt – explicitly describe when a tool should be used
  • Test tool behavior – verify your agent invokes tools at the right moments using web or phone calls, or save the check as an eval