Examples

The examples in this section are complete, runnable applications that show how Caracal’s authorization patterns — agent sessions, delegation hierarchies, scoped mandates, and provider-specific transport — apply to realistic workloads.

What the examples demonstrate

Each example focuses on patterns that are difficult to grasp from documentation alone:

• How delegation chains form when one agent spawns another
• How scope enforcement works across a hierarchy of agents with different authorities
• How transport works across heterogeneous protocols (REST, gRPC, MCP, SSE) within the same orchestration
• How the session lifecycle integrates with long-running agent workflows
• How ephemeral agents with constrained, single-operation authority differ from long-lived session agents

Available examples

Example	Scenario	Key patterns
Lynx Capital: Autonomous Payouts	Multi-agent swarm processing a weekly invoice batch across 5 regions	Hierarchical spawning, delegation scope, ephemeral payment agents, multi-protocol transport

Prerequisites for all examples

All examples assume a running Caracal stack. Start it with:

cd caracal/infra/docker
docker compose up -d

Verify all services are healthy:

docker compose ps

Each example includes its own setup instructions and environment configuration. Dependencies and startup commands are in the example’s own directory under examples/.