---
title: "get_agent"
description: "Get detailed information about a single agent, including slots (cellular/smartphone) or capacity (ethernet)."
sidebarTitle: "get_agent"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Get detailed information about a single agent, including slots (cellular/smartphone) or capacity (ethernet).

<Note>
  **Read-only · Calls external systems.** Safe to call: this tool does not modify data.
</Note>

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `agent` | string | Yes | Agent hostname or UUID (from list_agents) |
| `type` | string (cellular \| ethernet \| smartphone) | No | Agent type. Only needed to narrow the lookup; a hostname resolves its own type. |

## Example arguments

Illustrative arguments an agent supplies when calling this tool:

```json
{
  "agent": "string"
}
```

## Description

```text
Cellular agents show SIM card slots with IMEI and attached SIM status.
Smartphone agents show connected phones with USB paths and status.
Ethernet agents show capacity (max parallel tests).

Identify the agent with either of its identifiers — the hostname list_agents shows, or its UUID.
```

## Related

- [`list_agents`](/mcp/tools/agent/list_agents)

## What's next?

<Columns cols={2}>
  <Card title="All MCP tools" icon="robot" href="/mcp/tools/overview">
    Browse the full tool reference by category.
  </Card>
  <Card title="Connect a client" icon="plug" href="/mcp/connect">
    Point Claude, Cursor, or Claude Code at the server.
  </Card>
</Columns>