ghl_agent_studio_list
Lists active agents for a specified location with limit/offset pagination, and optionally filters results to only published production agents.
Instructions
Lists agents (paginated via limit/offset) — not a get-by-id lookup. List Agents Lists all active agents for the specified location. locationId is required parameter to ensure optimal performance. Supports pagination using limit and offset. Optionally filter by isPublished=true to return only agents with a published production version. Endpoint: GET /agent-studio/agent (Version header: v3; source: v3/agent-studio-v3.json) Requires a Sub-Account (location) token. OAuth scopes: agent-studio.readonly Pagination params: limit, offset — pass them to page through full result sets.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"locationId": "<locationId>",
"limit": "<limit>",
"offset": "<offset>"
},
"name": "ghl_agent_studio_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | Yes | Maximum number of agents to return (pagination page size) | |
| offset | Yes | Number of agents to skip before collecting results (pagination offset) | |
| source | No | Origin channel attributed to this read for auditing (e.g. public_api, internal) | |
| locationId | Yes | Location (sub-account) ID to list agents for | |
| isPublished | No | Optional filter to return only agents with a published production version |