API Reference
Directory exposes a gRPC API defined with Protocol Buffers. Generated clients and the canonical schema live on buf.build/agntcy/dir.
Protocol surface
| Area | Description |
|---|---|
| Storage | Push, pull, and manage OASF records in the OCI-backed store |
| Routing | Publish skill announcements, list local records, search the network |
| Search | Structured queries over the local index |
| Security | Signing, verification, naming, and validation |
| Sync | Peer synchronization between directory instances |
| Events | Streaming directory events (Events API) |
| Runtime | Runtime discovery for containerized workloads |
Use the Buf schema browser for message types, RPC names, and versioned packages. The Architecture page describes how these APIs map to Directory components.
Clients
- CLI — Directory CLI Reference (
dirctl) - SDKs — Go, Python, and JavaScript libraries
- MCP — MCP Server for tool-based access
For HTTP/gateway access patterns and OIDC, see OIDC Authentication.