Model Context Protocol (stdio) server that wraps the Airlock gateway REST API. Use it from MCP-compatible hosts (Claude Desktop, Cursor, etc.).
| Tool | Maps to |
|---|---|
airlock_health |
GET /health (subsystems, queue depth, optional Redis, etc.) |
airlock_resolve |
POST /resolve |
airlock_reputation |
GET /reputation/{did} |
airlock_session |
GET /session/{id} (optional session_view_token from handshake ACK) |
airlock_feedback |
POST /feedback (signed JSON string from Python SDK) |
airlock_metrics |
GET /metrics (requires AIRLOCK_SERVICE_TOKEN when gateway enforces it) |
airlock_introspect_trust_token |
POST /token/introspect (same bearer as metrics when enforced) |
airlock_handshake |
POST /handshake (pass JSON string built/signed elsewhere) |
AIRLOCK_GATEWAY_URL— gateway base URL (defaulthttp://127.0.0.1:8000)AIRLOCK_SERVICE_TOKEN— Bearer forairlock_metricsandairlock_introspect_trust_tokenwhen the gateway hasAIRLOCK_SERVICE_TOKENset (always in production)
From repository root:
npm install
npm run build:mcpRun locally:
node integrations/airlock-mcp/dist/index.jsAdd a stdio server entry pointing at airlock-mcp (or node /absolute/path/to/integrations/airlock-mcp/dist/index.js) with AIRLOCK_GATEWAY_URL in env.