Tools reference
Complete reference of tools available in each node type
Tools are the building blocks that give your agents superpowers. They enable agents to interact with users, navigate conversations, access knowledge, and integrate with external systems. Each node type comes with a carefully selected set of tools designed for its specific purpose.
💡 Pro tip: Reference tools by their exact names in your prompts to help the agent understand when to use them.
Messaging tools
Tools for communicating with users and managing conversation flow.
send_notification_to_user
Send a one-way notification message to the user.
Parameters:
message
(string, required): The notification text to send
Usage: Inform users without expecting a response
Available in: All node types
AskUserForInput
Ask the user a question and wait for their response. This tool pauses execution until the user replies.
Parameters:
message
(string, required): The question to ask. Must end with a question mark (?)
Usage: Gather specific information from users
Available in: All node types
Navigation tools
Tools for controlling conversation flow between nodes.
MoveToNextNode
Navigate to another node in the agent graph based on edge conditions.
Parameters:
next_node
(string, optional): Target node name. If not specified, follows edge conditions
Usage: Direct conversation flow based on logic or user responses
Available in: All node types
State management tools
Tools for managing conversation state.
EnterIdleState
Pause the conversation by entering an idle state. The agent can send a final message before idling.
Parameters:
message
(string, optional): Final message to send before idling
Usage: Gracefully end conversations or wait for external events
Available in: All node types
Knowledge base tools
Tools for retrieving information from configured knowledge sources.
kb_retrieval
Search and retrieve relevant information from knowledge bases.
Parameters:
query
(string, required): The search querykb_id
(string, optional): Specific knowledge base ID to search
Usage: Find answers from documentation or reference materials
Available in: KnowledgeBaseNode, SubagentNode
WhatsApp tools
Tools for sending WhatsApp-specific messages.
SendWhatsappTemplateMessage
Send pre-approved WhatsApp template messages.
Parameters:
template_name
(string, required): Name of the approved templateparameters
(object, optional): Template parameter values
Usage: Send notifications using WhatsApp Business templates
Available in: WhatsappTemplateNode, SubagentNode
Webhook tools
Dynamic webhook tools
Make HTTP requests to external APIs and services. These tools are created dynamically based on your node configuration.
Parameters: Defined by the webhook configuration in your node
Usage: Integrate with external systems, fetch data, trigger actions
Available in: WebhookNode, SubagentNode
Features:
- Custom naming (e.g.,
check_order_status_webhook
) - Support for all HTTP methods (GET, POST, PUT, PATCH, DELETE)
- Mock responses for testing
- JMESPath transformations for responses
MCP server tools
MCP server tools
Model Context Protocol (MCP) enables seamless integration with external systems through standardized server connections.
Parameters: Defined by each MCP server’s available tools
Usage: Access databases, external APIs, custom business logic, and third-party services
Available in: SubagentNode
Configuration:
- Server URL (e.g.,
https://api.example.com/mcp
) - Transport Kind (Streamable HTTP or SSE)
- Optional JMESPath queries for response transformation
Context tools
Tools for accessing execution context and metadata.
get_execution_metadata
Get contextual information about the current agent execution.
Parameters: None
Returns:
agent_id
(string): The ID of the current agentagent_execution_id
(string): The unique execution ID for this conversationcontact_information
(object): Contact details including phone number and broadcast contextwhatsapp_conversation_id
(string): The WhatsApp conversation ID (if applicable)
Usage: Access execution context for logging, tracking, or conditional logic
Available in: All node types
Need MCP servers?
Check out MCP Composio for instant access to 100+ managed servers with built-in authentication. Skip the setup and connect to fully managed MCP servers instantly.