list_agents

List agents (infrastructure) for an operator with health and capacity summary.

List agents (infrastructure) for an operator with health and capacity summary.

Read-only · Calls external systems. Safe to call: this tool does not modify data.

Parameters

FieldTypeRequiredDescription
detailbooleanNoReturn full JSON (default: false)
operatorstringYesOperator slug
typestring (cellular | ethernet | smartphone)NoFilter by agent type: cellular, ethernet, smartphone. Omit for all three.
zonestringNoFilter by zone

Example arguments

Illustrative arguments an agent supplies when calling this tool:

{
  "operator": "string"
}

Description

Agents are the hardware/software that runs resources — operator-scoped, not product-scoped.
Three types: cellular (GSM gateways with SIM slots), ethernet (standalone web agents), smartphone (phone hubs).

Returns a capacity summary header showing total online capacity for concurrent tests.
Use get_agent for detail with slots. Use list_resources for product-scoped device info.

What's next?

All MCP tools

Browse the full tool reference by category.

Connect a client

Point Claude, Cursor, or Claude Code at the server.

Last updated on