Mandate Labs Documentation
Everything you need to authorize AI agent transactions with real-time decision trust scoring and configurable spending mandates.
Start building
Get up and running with the Mandate Labs platform in minutes. Choose a guide based on what you want to accomplish.
Quickstart
Set up your development environment, install the SDK, and authorize your first agent transaction in under 5 minutes.
Decision Trust Scoring
Understand how the KYA Score engine evaluates agent behavior across six anomaly dimensions and assigns trust zones.
Authorization Engine
Deep dive into the real-time authorization pipeline: mandate checks, risk scoring, gate evaluation, and decisions.
Webhooks
Receive real-time notifications for gate firings, trust zone changes, session terminations, and more.
Platform overview
Mandate Labs provides infrastructure for authorizing autonomous AI agent spending in real time. The platform combines traditional payment controls (spending limits, merchant restrictions) with novel decision trust scoring that monitors agent behavior quality.
Key components
- Clients — The contracting organization (tenant). A Client is vetted through KYB, holds the API credential (
cli_), and onboards Principals and Agents under it - Programs — A card or crypto program (
prg_) operated under a Client - Principals — A person or merchant (
prn_) onboarded by a Client; a Principal owns one or more Agents - Agents — AI systems (
agt_) registered with specific capabilities and behavioral profiles - Mandates — Configurable spending constraints (
mnd_) on an agent: amounts, frequencies, merchant categories - Authorization Engine — Real-time decision pipeline evaluating every transaction
- Decision Trust Score (DTS) — Multi-dimensional behavioral assessment determining agent autonomy levels
- Webhooks — Event-driven notifications for monitoring and alerting
SDKs
The canonical interface to Mandate Labs is the HTTP API — every operation is a plain REST call with your Client API key in the X-API-Key header against https://api.mandatelabs.ai. Official Python and Node.js client libraries are in beta; until they reach general availability, we recommend calling the API directly (see the Quickstart for curl, Python httpx, and Node fetch examples).