Admin MCP Server
AIControls exposes its own MCP server so you can query governance data directly from Claude Code or any MCP client.
Admin MCP server
AIControls exposes its own MCP server at https://YOUR_ORG.aicontrols.dev/mcp/admin. This lets you query governance data directly from Claude Code or any MCP client:
| Tool | Description |
|---|---|
aicontrols_audit_query | Search audit events by agent, tool, decision, or time range |
aicontrols_cost_summary | Get aggregate cost and token usage by developer or model |
aicontrols_risk_scores | Return computed risk scores for agents |
aicontrols_session_list | List active developer sessions with budget utilization |
aicontrols_hitl_list | List pending human-in-the-loop approval requests |
aicontrols_policy_list | List loaded policies with match statistics |
nirmata_retrieve | Retrieve the original, uncompressed content of a compressed tool response |
nirmata_pre_compact | Return the compression manifest for a session — the list of compressed tool responses that can still be retrieved before compaction discards them |
nirmata_retrieve
Compressed tool responses carry a retrieval hint of the form nirmata_retrieve hash=<sha256>. Call nirmata_retrieve with that hash to get the original content back:
| Parameter | Required | Description |
|---|---|---|
hash | Yes | The SHA-256 hash from the hint appended to a compressed response |
Originals are retained for 7 days after compression, then purged. Retrieving a hash that has expired or was never issued returns a "not found" error rather than failing silently. See Context Optimization for the full retrieval and retention model.
Authenticate to the admin MCP server with an admin-role personal access token. Connect it to Claude Code by adding it to your MCP server list in ~/.claude/settings.json:
{
"mcpServers": {
"aicontrols": {
"url": "https://YOUR_ORG.aicontrols.dev/mcp/admin",
"headers": {
"Authorization": "Bearer YOUR_ADMIN_TOKEN"
}
}
}
}