Skip to main content

List Phoenix Agents

Coming soon

The v2 MCP API is in preview and not yet generally available. These pages document its tools and request/response shapes; live data access is limited to enrolled organizations until v2 is released.

List the Phoenix AI agents this organization has published and can 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. 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.

Parameters​

This tool does not require any parameters.

Use Cases​

  • Discover which Phoenix 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": {}
}

phoenix_invoke_agent, phoenix_get_run_status, phoenix_list_artifacts, phoenix_onboarding