hangar_details
Retrieve configuration and runtime details for any MCP server or group. Use this to inspect health, state, membership, and tool schemas when troubleshooting or auditing.
Instructions
Get configuration and runtime info for a mcp_server or group.
CHOOSE THIS when: you need mcp_server config, health history, or group membership.
CHOOSE hangar_tools when: you need tool schemas for invoking.
CHOOSE hangar_status when: you need quick overview of all mcp_servers.
Side effects: None (read-only).
Args:
mcp_server: str - McpServer ID or Group ID
Returns:
McpServer: {
mcp_server: str,
state: str,
mode: str,
alive: bool,
tools: [{name, description, inputSchema}],
health: {consecutive_failures: int, last_check: str, ...},
idle_time: float,
meta: object,
dead: {reason, since, retry_allowed_at, revived_by} | null
}
Group: {
group_id: str,
description: str,
state: str,
strategy: str,
min_healthy: int,
healthy_count: int,
members_in_rotation_count: int,
total_members: int,
is_available: bool,
circuit_open: bool,
members: [{id, state, in_rotation, weight, priority, consecutive_failures}]
}
A group is the same dict GET /api/groups/{id} returns. healthy_count
counts members that are ready and in rotation;
members_in_rotation_count counts members in rotation in any state.
dead is null unless state is "dead". reason is "given_up",
"crashed", "start_failed" or "capability_blocked" ("unknown" only
for a server restored from an older record). since is when it went
dead; retry_allowed_at is when its backoff ends at the latest, or
null when no call starts it or no backoff applies (ISO 8601 UTC).
revived_by is "call_or_start" (hangar_start, or a call after the
backoff) or "start" (only hangar_start, for capability_blocked).
Never upstream error text.
Error: ValueError with "unknown_mcp_server: <id>"
Example:
hangar_details("math")
# {"mcp_server": "math", "state": "ready", "mode": "subprocess",
# "alive": true, "tools": [...], "health": {"consecutive_failures": 0},
# "idle_time": 12.5, "meta": {}}
hangar_details("llm-group")
# {"group_id": "llm-group", "state": "healthy", "strategy": "round_robin",
# "healthy_count": 2, "total_members": 3, "members": [...]}
hangar_details("unknown")
# Error: unknown_mcp_server: unknown
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mcp_server | Yes |