status · git:20260804.c8a22f2 · 2026-08-04 · sha256 34bfce3fd64bdccd
status git:20260804.c8a22f2A
Immutable. This exact content never changes and is served at /api/v1/blob/34bfce3fd64bdccd.
---
name: status
description: Report AgentGuards guardrail status for a self-hosted appliance. Use when the user asks whether AgentGuards is active, healthy, or correctly configured in Copilot CLI.
---
# AgentGuards status — self-hosted
There is no `health_check` MCP tool in this variant (see the `guardrails`
skill for why). Check status directly instead:
1. **Confirm both required variables are set** in the environment:
`AGENTGUARDS_URL` and `AGENTGUARDS_API_KEY`. If either is missing, stop
here and point the user at the `setup` skill — the hooks fail closed
without them.
2. **Check the appliance is reachable**, using the actual configured value:
```
curl -s -o /dev/null -w '%{http_code}\n' "$AGENTGUARDS_URL/health"
```
`200` means the appliance is up. A connection failure or a certificate
error means the hooks will fail closed too — see the `setup` skill's TLS
step.
3. **Confirm the key is accepted**, not just present:
```
curl -s -o /dev/null -w '%{http_code}\n' "$AGENTGUARDS_URL/v1/guardrails/evaluate-input" \
-H "X-API-Key: $AGENTGUARDS_API_KEY" -H 'Content-Type: application/json' \
-d '{"text":"status check"}'
```
`200` means it's accepted. `401` means the key is wrong or was revoked on
the appliance's own Keys page.
4. **Report plainly**: which of the two variables are set, the `/health`
status code, and the evaluate-input status code. Do not speculate beyond
what these three checks actually showed.