List Phoenix Agents

phoenix_list_agents — discover/browse Phoenix agents & workflows available to invoke. Each row returns the agent's instance id (a UUID), name, description, allowed tools, and input schema — the id and input schema are exactly what phoenix_invoke_agent needs. These are Phoenix's own orchestration agents/workflows (e.g. an Account Research Brief that assembles a cited deliverable), NOT the raw HG data tools and NOT the org's stored artifacts. Use this when you need to discover which agents exist or look up an agent_id / its expected inputs before starting a run. Optional name (case-insensitive contains), sort (recently_published default, name, created), limit and offset filter the published list. Do NOT use this to query company/firmographic/technographic data (call the relevant HG data tool directly) or to browse already-produced deliverables — use phoenix_list_artifacts.

Credits

Free — No credits consumed. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
name	string	-	Case-insensitive contains match on the agent name, e.g. 'zoom'. Omit to list every published agent.
sort	string	-	Order of the list: recently_published (default, newest publish first), name (A-Z) or created (newest first).
limit	integer	-	Max agents to return, 1-100 (default 50).
offset	integer	-	Number of agents to skip, for paging (default 0).

Use Cases

• Discover which HG Agents an organization has published before invoking one
• Look up the agent_id (UUID) to pass to phoenix_invoke_agent
• Inspect an agent's expected input schema so you can build a valid inputs object
• Check which HG data tools a given agent is allowed to call

Example Usage

List all published agents for this org

{
  "tool": "phoenix_list_agents",
  "arguments": {}
}

Find an agent by name

{
  "tool": "phoenix_list_agents",
  "arguments": {
    "name": "zoom"
  }
}

Page through agents by name

{
  "tool": "phoenix_list_agents",
  "arguments": {
    "sort": "name",
    "limit": 20,
    "offset": 20
  }
}

Response Format

Field	Type	Description
agents	array	Published agents available to the authenticated organization
agents[].id	string	Agent instance ID
agents[].name	string	Agent name
agents[].description	string	Agent description
agents[].version	string	Current published version ID
agents[].version_number	integer	Published version number within the template version
agents[].published_at	string	When the current version was published
agents[].based_on	object	Template this agent was forked from
agents[].based_on.name	string
agents[].based_on.version	integer
agents[].tools	array	Available tools
agents[].inputs	object	Expected input schema
count	number	Total number of published agents matching the filters, before limit/offset
message	string	Set when a name search matches no published agent

Related Tools

phoenix_invoke_agent, phoenix_get_run_status, phoenix_list_artifacts, phoenix_onboarding