Tools API

Tools are the actions an agent can perform. They’re defined by the integrating application (e.g. ROL) and registered in Kernel Service.

List Tools

GET /api/v1/tools

Returns all tools available to your tenant with full input/output schemas.

Example Response

{
  "tools": [
    {
      "name": "rol.leads.get",
      "description": "Fetch a lead's details from ROL",
      "input_schema": {
        "type": "object",
        "properties": {
          "lead_id": {"type": "string"}
        },
        "required": ["lead_id"]
      },
      "execution_mode": "immediate",
      "idempotent": true
    }
  ],
  "total": 7
}

Get Tool Detail

GET /api/v1/tools/{tool_name}

Returns the full schema plus an implementation guide for building the tool endpoint.

Tool Contract

When you build a tool connector, your app exposes HTTP endpoints that Kernel calls:

POST {your_base_url}/kernel/v1/tools/{tool_path}
Headers:
  X-Tenant-ID: {tenant_id}
  X-Kernel-Request-ID: {request_uuid}
  Authorization: Bearer {service_token}
Body: (matches tool input_schema)
Response: (matches tool output_schema)

See Building Tool Connectors for a complete guide.