Get MCP health
Whether users can reach an MCP right now: a broken setup, a problem limited to some users, or nothing to report. Computed from the last 24 hours of audit events, so it needs the audit permission and names users.
Whether users can reach an MCP right now: a broken setup, a problem limited to some users, or nothing to report. Computed from the last 24 hours of audit events, so it needs the audit permission and names users.
ApiKeyAuthAuthorizationBearer <token>Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.
Required permission
view_auditmcp_id*stringuuidThe request has succeeded.
application/json- response
Who can and cannot reach an MCP over the last 24 hours, judged per user by their latest failure or success.
state*McpHealthStateWhether users can reach an MCP.
"ok""partial""broken"working_user_count*integerUsers whose latest attempt succeeded: a tool call or a first connection.
int32failure_groups*array<>The failing users grouped by reason and error code, largest group first, then newest.
first_failure_at?stringThe earliest failure in the last 24 hours.
date-timelast_worked_at?stringThe most recent tool call or first connection on the MCP, by any user, in the last 24 hours.
date-timecurl -X GET 'https://your-org.aisecurity.services.us.connect.secureauth.com/api/v1/mcps/497f6eca-6276-4993-bfeb-53cbbbba6f08/health'{ "state": "ok", "working_user_count": 0, "failure_groups": [ { "user_count": 0, "latest_at": "2019-08-24T14:15:22Z", "configuration_error": true, "reason": "id_jag", "served_stored_tools": true, "id_jag": { "step": "exchange", "code": "string", "description": "string", "hint": "string" }, "upstreams": [ { "id": "string", "name": "string", "status": "connected", "failure": { "reason": "id_jag", "id_jag": { "step": "exchange", "code": "string", "description": "string", "hint": "string" }, "served_stored_tools": true } } ], "users": [ { "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5", "display_name": "string", "last_failure_at": "2019-08-24T14:15:22Z", "agent_slug": "string" } ] } ], "first_failure_at": "2019-08-24T14:15:22Z", "last_worked_at": "2019-08-24T14:15:22Z"}