Skip to main content
GET
Report every declared external tool server's health and cost

Response

One entry per declared tool server, in name order.

name
string
required

The name the server was declared under.

status
enum<string>
required

waiting-for-sign-in is a connection attempt held open for a PERSON: the server demanded OAuth, the host put an authorization URL in front of whoever is watching, and nothing else is wrong. It is reported separately from connecting because the two need opposite reactions — connecting resolves itself, this one resolves only when somebody opens signInUrl — and because the alternative was a five-minute "connecting" whose eventual failure read "context canceled" and never named the sign-in.

Available options:
connecting,
connected,
down,
waiting-for-sign-in
tools
integer
required
Required range: x >= 0
attempts
integer
required

Consecutive failures since this server last connected.

Required range: x >= 0
calls
integer<int64>
required

Tool calls this server has been asked to make.

Required range: x >= 0
catalogueBytes
integer
required

Characters of model context this server's catalogue entry spends.

Required range: x >= 0
since
string<date-time>

When the server entered this status — for waiting-for-sign-in, when the host started waiting on the person.

pingMs
integer

Round trip of the live MCP ping taken while answering. Absent when the server is not connected, or when the ping failed — in which case lastError says so.

Required range: x >= 0
lastError
string

Why the last attempt, session or ping failed.

signInUrl
string

The authorization page a person must open to finish this server's sign-in. Present only while status is waiting-for-sign-in.

signInExpiresAt
string<date-time>

When this sign-in window closes. Present only while status is waiting-for-sign-in.