Tools & Integrations

Connect external APIs, webhooks, and tool integrations

Tools let agents call external APIs or MCP servers during a conversation — CRM lookups, appointment booking, sending messages, or any HTTP endpoint or MCP server.

Endpoints

MethodPathDescription
GET/tools/List all tool integrations
POST/tools/Create a new HTTP or MCP tool
GET/tools/{uuid}Get a tool's configuration
PUT/tools/{uuid}Update a tool
DELETE/tools/{uuid}Archive a tool (soft delete)
POST/tools/{uuid}/unarchiveRestore an archived tool
POST/tools/{uuid}/mcp/refreshRe-discover an MCP tool's server catalog
GET/tools/assignmentsList which agents use each tool

List Tools

GET
/tools/
ParameterTypeRequiredDescription
statusstringOptionalFilter: "active", "archived", or "all"
categorystringOptionalFilter by tool category

Create a Tool

POST
/tools/

HTTP Tool

Response
json
{
  "name": "CRM Lookup",
  "type": "http",
  "description": "Look up a customer record by phone number",
  "url": "https://api.mycrm.com/contacts/lookup",
  "method": "POST",
  "headers": {
    "Authorization": "Bearer {{crm_api_key}}",
    "Content-Type": "application/json"
  },
  "body_template": {
    "phone": "{{phone_number}}"
  }
}

MCP Tool

Response
json
{
  "name": "Calendar MCP",
  "type": "mcp",
  "description": "Manage calendar events and availability",
  "mcp_url": "https://mcp.mycalendar.com",
  "mcp_headers": {
    "X-API-Key": "your-mcp-key"
  }
}

Refresh MCP Schema

POST
/tools/{uuid}/mcp/refresh

Re-fetches the tool catalog from the remote MCP server. Use after the remote server's tool list changes.

Was this page helpful?
Open Dashboard →
PreviousKnowledge BaseNextCredentials