health_check
Verify the MCP server is up, confirm Box connectivity and auth, and check that admin_logs event scope is granted before running leakage detection.
Instructions
Report server version, Box connectivity/auth, and configuration.
Call this at session start (or after a tool-call timeout) to confirm the MCP
is up, see which version is running, verify the Box enterprise token can be
obtained (CCG) and that the admin_logs event scope is actually granted,
and view the org domain allowlist used for external detection. Lightweight:
one token request plus a single-row events probe — it does not scan history.
Always returns the same keys: status (healthy / degraded / error),
service, version, auth_mode (ccg / oauth — the mode in effect,
so an unrecognised BOX_AUTH_MODE reads as ccg, which is what the
server falls back to), box_api_base,
enterprise_id, auth (ok / error / missing-env / needs-login),
events_accessible (bool), allowed_domains, and read_file
(not-configured / ok / misconfigured: whether the opt-in read_file tool is
on, from BOXADM_READ_FOLDER_IDS; misconfigured makes the status degraded).
On a degraded or error result, detail carries the reason.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "health_check"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||