The AGNTCY Agent Directory Service: Architecture and Implementation
Luca Muscariello, Vijoy Pandey, Ramiz Polic · 2025
Read The AGNTCY Agent Directory Service: Architecture and Implementation by Luca Muscariello, Vijoy Pandey, Ramiz Polic (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2509-18787.txt.
Introduction
AI agents need a directory: a place to find what other agents can do and where they came from. Luca Muscariello, Vijoy Pandey, and Ramiz Polic describe the AGNTCY Agent Directory Service in this 2025 paper. The service supports discovery across mixed multi-agent systems. It rests on an open schema framework for agent records.
Records are stored by content address, sorted by layered taxonomies, and signed for proof of origin. A two-level map splits capability indexing from content location, run over a distributed hash table. Existing container infrastructure handles artifact delivery, and a signing system supplies provenance. The design is schema-driven, so new agent kinds, from prompt agents to tool servers, can join. The paper sets out the architecture, storage and discovery layers, and security traits. It also places the service among other emerging agent registries.
Catalog record
| CREATOR | Luca Muscariello, Vijoy Pandey, Ramiz Polic |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 48 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2509-18787
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
The AGNTCY Agent Directory Service: Architecture and Implementation Luca Muscariello, Vijoy Pandey, Ramiz Polic Abstract The Agent Directory Service (ADS) is a distributed directory for the discovery of AI agent capabilities, metadata, and provenance. It leverages content-addressed storage, hierarchical taxonomies, and cryptographic signing to enable efficient, verifiable, and multi-dimensional discovery across heterogeneous Multi-Agent Systems (MAS). Built on the Open Agentic Schema Framework (OASF), ADS decouples capability indexing from content location through a two-level mapping realized over a Kademlia-based Distributed Hash Table (DHT). It reuses mature OCI / ORAS infrastructure for artifact distribution, integrates Sigstore for provenance, and supports schema-driven extensibility for emerging agent modalities (LLM prompt agents, MCP servers, A2A-enabled components). This paper formalizes the architectural model, describes storage and discovery layers, explains security and performance properties, and positions ADS within the broader landscape of emerging agent registry and interoperability initiatives. K eywords Agent Directory Service \cdot Multi-Agent Systems \cdot Capability Discovery 1 Introduction Multi-Agent Systems (MAS) increasingly rely on composable AI agents that encapsulate specialized capabilities such as natural language processing, reasoning, computer vision, domain analytics, orchestration, or tool mediation. As ecosystems diversify, discovery shifts from ad-hoc curation to infrastructure that can answer questions such as: “Which agents can perform regulated clinical summarization with streaming JSON output?” or “Which reasoning agents have signed provenance and acceptable latency profiles?” The AGNTCY Agent Directory Service (ADS) addresses this by providing: (i) a structured, extensible schema layer (OASF) for expressing agent capabilities, operational traits, and evaluation signals; (ii) a distributed storage and indexing substrate reusing OCI registry semantics for durability and interoperability; (iii) a taxonomy-driven discovery model enabling hierarchical capability queries; and (iv) cryptographic integrity, provenance, and verifiability via content addressing and Sigstore-based signing. Rather than prescribing a fixed agent execution architecture, ADS treats agent definitions as immutable, content-addressed records enriched by extensions (e.g., MCP server descriptors, evaluation metrics, prompt templates, feature flags). This design maintains flexibility while supporting convergence toward standard representational forms. Capability-based search is accelerated by a two-level mapping: skills (and other taxonomic dimensions) to Content Identifiers (CIDs), and CIDs to storage peers. This separation permits horizontal scaling, adaptive replication, and low-latency intersection queries across multiple classification axes. The reference specification [ 6 ] and implementation ( https://github.com/agntcy/dir ) emphasize reuse of proven components: OCI distribution for artifact transport, Kademlia DHT for routing [ 4 ] , and Sigstore for cryptographic provenance. ADS complements parallel efforts in agent registries, identity, and interoperability (e.g., MCP [ 5 ] , A2A [ 3 ] , and decentralized naming discussions harkening back to Zooko’s Triangle [ 18 ] ). In parallel, the NANDA suite of indexing and resolution proposals [ 14 ] [ 13 ] [ 19 ] [ 17 ] [ 16 ] explores DNS-inspired, adaptive resolver, enterprise governance, and comparative survey dimensions of an Internet-scale agent naming fabric; ADS focuses instead on capability-centric, content-addressed discovery and can interoperate with such name resolution layers. Contributions. This paper: C1 Defines ADS architectural principles and layered model (schema, storage, indexing, distribution, security). C2 Details the two-level discovery mapping and taxonomy strategy for scalable capability search. C3 Explains integration of OCI / ORAS for artifact organization and transport. C4 Formalizes security properties: integrity, provenance, trust boundaries, and threat mitigation. C5 Presents performance and replication strategies (on-demand retrieval, proactive caching, strategic replication). C6 Situates ADS among related interoperability and registry initiatives. Organization. Section 2 states design goals. Section 3 overviews the architecture. Section 4 covers content-addressed storage and ORAS integration. Section 5 details discovery, taxonomies, and DHT mappings. Section 6 presents the security model. Section 7 discusses optimizations. Section 8 summarizes implementation and SDKs. Section 9 reviews related work. Section 10 outlines future directions and Section 11 concludes. 2 Design Goals The design of the Agent Directory Service (ADS) is driven by a set of interrelated goals intended to balance openness, verifiability, and operational pragmatism. We articulate these goals along with resulting architectural constraints. G1 Extensible Schema Surface. The core representation MUST support forward-compatible evolution without invalidating previously published records. OASF extensions (e.g., MCP server descriptors, evaluation metrics, prompt bundles) SHOULD compose additively and remain ignorable by nodes that do not implement them. This motivates a loosely coupled extension registry and strongly typed, versioned schema identifiers. G2 Capability-Centric Discovery. Discovery performance MUST scale sub-linearly with the total number of records for common capability queries (skills, domains, features). This necessitates a separation between capability indices and physical storage location (two-level mapping) and encourages hierarchical taxonomies to bound combinatorial explosion. G3 Verifiable Integrity and Provenance. All records MUST be immutable and addressable by cryptographic digest (CID). Optional signing layers (Sigstore) SHOULD provide provenance without imposing key management burden on casual publishers. Integrity verification MUST NOT require trusted intermediaries. G4 Interoperability via Reuse. The system SHOULD reuse existing, widely deployed distribution substrates (OCI registries, ORAS tooling) to avoid bespoke artifact transport stacks and to leverage existing caching, access control, and scanning ecosystems. G5 Federated Operation. Distinct organizations MUST be able to operate autonomous registries while participating in a shared discovery plane. Federation SHOULD NOT require global consensus on non-critical metadata nor impose a single root of trust. G6 Multi-Dimensional Query Composition. Queries combining at least one skill plus optional domain and feature filters MUST be executable through efficient index intersections. Domain- or feature-only queries are intentionally disallowed to preserve index locality and predictable complexity bounds. G7 Elastic Replication Strategies. Deployments SHOULD flexibly choose between on-demand retrieval, proactive caching, and strategic replication depending on workload latency and availability requirements. The architecture MUST not hard-code a single replication policy. G8 Security-in-Depth. Threat mitigation (supply chain tampering, spoofing, targeted DoS amplification) SHOULD rely on layered primitives: content addressing, transparent signatures, decentralized lookups, cache isolation. No single compromised component SHOULD yield undetectable data forgery. G9 Operational Observability. Index accuracy, replication lag, signature verification failure rates, and cache effectiveness SHOULD be observable through exportable metrics to enable adaptive policy tuning (future work elaborates evaluative telemetry extensions). Resulting Constraints. • Mutable metadata (e.g., dynamic performance measurements) are represented as new versioned records or referrer objects, never in-place edits. • All capability-bearing identifiers map first to CIDs; peer discovery is a subsequent step (precluding location-dependent indexing shortcuts). • Extension collision avoidance requires globally unique (namespace, name, version) triples. • Discovery latency targets favor bounded taxonomy depth over arbitrarily deep ontologies. These goals collectively justify the layered decomposition detailed in Sections 3 and 4 . 3 System Architecture Overview The AGNTCY Agent Directory Service (ADS) is architected as a layered, federated system for scalable agent capability discovery and artifact distribution. Its main components and flows are: Layered Model. ADS is organized into the following layers: • Schema Layer: Defines agent records using the Open Agentic Schema Framework (OASF), supporting extensible, versioned metadata for skills, domains, features, and evaluation signals. • Indexing Layer: Maintains capability-centric indices mapping skills, domains, and features to sets of agent record CIDs [ 2 ] . Indices are published as immutable OCI artifacts and distributed via a DHT. • Storage Layer: Stores agent records and referrers as OCI artifacts in one or more registries, backed by object storage (e.g., S3, GCS, Azure Blob). Records are content-addressed by cryptographic digest (SHA-256) [ 2 ] . • Distribution Layer: Uses mature OCI registry protocols