-What started as a concept became reality in March 2025 when Outshift launched AGNTCY on GitHub with complete code, specifications, and services, alongside Galileo and LangChain as core maintainers. They built the discovery, identity, messaging, and observability components that agents need to find each other, verify their capabilities, and collaborate securely.
+
+
+
AGNTCY Documentation
+
+
+ Open infrastructure for the Internet of Agents.
+
+
+ AGNTCY is an open source collective building the software components and services
+ that let agents discover each other, verify capabilities, communicate securely,
+ and collaborate across frameworks and organizational boundaries.
+
+
-By July 2025, over 75 companies had joined the effort, leading to AGNTCY's donation to the Linux Foundation with Cisco, Dell Technologies, Google Cloud, Oracle, and Red Hat as formative members. What began as one company's vision became the community-owned infrastructure for the Internet of Agents.
+
Explore the Documentation
-## Mission
+
-We are an open source collective committed to build the Internet of Agents to be accessible to all. Our mission is to build a diverse, collaborative space to innovate, develop, and maintain software components and services that solve key problems in the domain of agentic workflows and multi-agent applications.
+- :material-folder-search-outline:{ .lg .middle } **Agent Directory Service**
-## Capabilities
+ ---
-Based on advanced protocols, frameworks, and components, the goal of IoA software infrastructure is to enable and simplify the creation of multi-agent applications through the following steps:
+ Federated registry for publishing, verifying, and discovering agents and multi-agent applications.
-1. **Discover**: Find and evaluate the best agents for the job.
-1. **Compose**: Connect agents into effective workflows across any framework or vendor.
-1. **Deploy**: Run multi-agent systems at scale, securely.
-1. **Evaluate**: Monitor performance and improve efficiency and efficacy over time.
+ [:octicons-arrow-right-24: Directory docs](https://dir.agntcy.org/latest/){:target="_blank"}
-## Technical Objectives
+- :material-message-fast-outline:{ .lg .middle } **Secure Low-Latency Interactive Messaging (SLIM)**
-1. **Interoperability**: Establish a common protocol that enables AI agents from different vendors and platforms to communicate and work together efficiently.
-2. **Security**: Ensure secure interactions between agents through robust authentication, authorization, and encryption mechanisms.
-3. **Scalability**: Design a scalable architecture that leverages the cloud-native stack optimally, supporting a growing number of agents and interactions without compromising performance.
-4. **Standardization**: Develop standardized data models and schemas to ensure consistent data representation and validation across the ecosystem.
+ ---
-## Core Components
+ Secure network-level messaging for multi-agent applications with pub/sub, streaming, and MLS encryption.
-The initial set of IoA components and architecture is outlined below. This is a starting point - as new members join and bring their contributions, the collective will continue to evolve and expand the IoA architecture, components, and interfaces.
+ [:octicons-arrow-right-24: SLIM docs](https://slim.agntcy.org/latest/){:target="_blank"}
-
+- :material-database-outline:{ .lg .middle } **Open Agent Schema Framework (OASF)**
-1. **[Open Agent Schema Framework (OASF)](./oasf/open-agentic-schema-framework.md)**: An OCI based extensible data model allowing to describe agents' attributes and ensuring unique identification of agents. OASF supports the description of A2A agents, MCP servers and can be extended to support other popular formats, such as Copilot agent manifests and many more. Current OASF repo can be found [here](https://github.com/agntcy/oasf), OASF schema documentation can be found [here](https://schema.oasf.outshift.com).
-1. **[Agent Directory](https://dir.agntcy.org/latest/)**: Allows announcing and discover agents or multi-agent applications which are described using OASF. Any organization can run its directory and keep it in sync with others, forming the Internet of Agents inventory. Agent Directory supports A2A agent cards and MCP server descriptions among other data models.
-1. **[Secure Low-Latency Interactive Messaging (SLIM)](https://slim.agntcy.org/latest/)**:
- * **SLIM** (Secure Low-latency Interactive Messaging): A protocol that defines the standards and guidelines for secure and efficient network-level communication between AI agents. SLIM ensures interoperability and seamless data exchange by specifying message formats, transport mechanisms, and interaction patterns.
- * **SLIM Nodes and SDK**: Offers handy secure (MLS and quantum safe) network-level communication services to a group of agents (typically those of a given multi-agent application) through SDK/Libraries. It extends gRPC to support pub/sub interactions in addition to request/reply, streaming, fire & forget and more.
-1. **[Identity](./identity/identity.md)**: A system that leverages decentralized technologies to manage and verify the identities of Agents or Tools issued by any organization, ensuring secure and trustworthy interactions.
-1. **[Observability and Evaluation](./obs-and-eval/observe-and-eval.md)**: Telemetry collectors, tools and services to enable multi-agent application observability and evaluation.
-1. **Security**: Tools and services to trust and protect multi-agent applications.
+ ---
-[CoffeeAGNTCY](./coffee-agntcy/get-started.md) is a reference implementation demonstrating the core components that can be used to build multi-agent applications.
+ Extensible data model for describing agent attributes, skills, and capabilities across A2A, MCP, and more.
-The following diagram shows a simplified architecture of the core components described above.
+ [:octicons-arrow-right-24: OASF overview](oasf/open-agentic-schema-framework.md)
-
+- :material-shield-key-outline:{ .lg .middle } **Identity**
-## Benefits
+ ---
-* **Enhanced Collaboration**: By enabling seamless communication and data exchange, IoA fosters collaboration between AI agents, leading to more sophisticated and integrated solutions.
-* **Improved Efficiency**: Standardized protocols and frameworks reduce the complexity of integrating diverse AI agents, resulting in faster development and deployment of AI-driven applications.
-* **Increased Security**: Robust security mechanisms ensure that interactions between agents are secure, protecting sensitive data, and preventing unauthorized access.
-* **Future-Proof Architecture**: The scalable and flexible design of IoA ensures that the ecosystem can grow and adapt to future advancements in AI technology.
+ Decentralized identity for agents and tools—identifiers, verifiable credentials, and policy-based access.
+
+ [:octicons-arrow-right-24: Identity overview](identity/identity.md)
+
+- :material-chart-line:{ .lg .middle } **Observability and Evaluation**
+
+ ---
+
+ Telemetry collectors, tools, and services for multi-agent observability and performance evaluation.
+
+ [:octicons-arrow-right-24: Observability overview](obs-and-eval/observe-and-eval.md)
+
+- :material-test-tube:{ .lg .middle } **CSIT**
+
+ ---
+
+ Continuous system integration testing for AGNTCY components and multi-agent workflows.
+
+ [:octicons-arrow-right-24: CSIT overview](csit/csit.md)
+
+- :material-coffee-outline:{ .lg .middle } **CoffeeAGNTCY**
+
+ ---
+
+ Reference implementation demonstrating how to build multi-agent applications with AGNTCY components.
+
+ [:octicons-arrow-right-24: Get started](coffee-agntcy/get-started.md)
+
+- :material-book-open-page-variant-outline:{ .lg .middle } **Glossary**
+
+ ---
+
+ Definitions for terms used across AGNTCY documentation.
+
+ [:octicons-arrow-right-24: Glossary](glossary.md)
+
+- :material-hand-heart-outline:{ .lg .middle } **How to Contribute**
+
+ ---
+
+ Guidelines for contributing documentation, code, and community improvements.
+
+ [:octicons-arrow-right-24: Contributing](contributing.md)
+
+
+
diff --git a/docs/stylesheets/custom.css b/docs/stylesheets/custom.css
index 063818cc..fecf3904 100644
--- a/docs/stylesheets/custom.css
+++ b/docs/stylesheets/custom.css
@@ -105,6 +105,14 @@
color: var(--md-typeset-a-color);
}
+.md-copyright--centered,
+.md-copyright--centered .md-copyright__highlight {
+ width: 100%;
+ text-align: center;
+ font-size: 0.75rem;
+ color: var(--md-default-fg-color--light);
+}
+
html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer] {
background-color: var(--md-default-bg-color);
}
diff --git a/docs/stylesheets/landing.css b/docs/stylesheets/landing.css
new file mode 100644
index 00000000..0f4e938b
--- /dev/null
+++ b/docs/stylesheets/landing.css
@@ -0,0 +1,336 @@
+/* Copyright AGNTCY Contributors (https://github.com/agntcy) */
+/* SPDX-License-Identifier: Apache-2.0 */
+
+/* Landing page (home). Adapted from dir.agntcy.org — hero + documentation cards only. */
+
+:root {
+ --agntcy-dark: rgb(0, 20, 43);
+ --agntcy-yellow: rgb(251, 175, 69);
+ --agntcy-text-strong: rgb(0, 20, 43);
+ --agntcy-text-inverse: rgb(232, 233, 234);
+ --agntcy-border: rgb(213, 223, 247);
+ --agntcy-card-bg: rgb(255, 255, 255);
+ --agntcy-card-border: rgb(213, 223, 247);
+ --agntcy-card-shadow:
+ 0 4px 24px rgba(2, 81, 175, 0.1),
+ 0 1px 4px rgba(0, 20, 43, 0.06);
+ --agntcy-card-shadow-hover:
+ 0 14px 36px rgba(2, 81, 175, 0.16),
+ 0 4px 10px rgba(0, 20, 43, 0.08);
+ --agntcy-card-btn-bg: rgb(239, 243, 252);
+ --agntcy-card-btn-color: rgb(2, 81, 175);
+ --agntcy-card-btn-border: rgb(213, 223, 247);
+ --agntcy-card-btn-bg-hover: rgb(2, 81, 175);
+ --agntcy-card-btn-color-hover: rgb(255, 255, 255);
+ --agntcy-hero-gradient: linear-gradient(
+ 101.5deg,
+ rgb(251, 171, 44) 0%,
+ rgb(24, 122, 220) 53%,
+ rgb(0, 20, 43) 100%
+ );
+ --agntcy-hero-chrome-top: var(--md-header-height);
+ --agntcy-hero-pad-block: 3.75rem;
+}
+
+[data-md-color-scheme="slate"] {
+ --agntcy-card-bg: rgb(0, 42, 77);
+ --agntcy-card-border: rgb(13, 39, 77);
+ --agntcy-card-shadow:
+ 0 4px 24px rgba(0, 0, 0, 0.35),
+ 0 1px 3px rgba(0, 0, 0, 0.2);
+ --agntcy-card-shadow-hover:
+ 0 14px 36px rgba(0, 0, 0, 0.45),
+ 0 4px 10px rgba(0, 0, 0, 0.25);
+ --agntcy-card-btn-bg: rgb(3, 20, 43);
+ --agntcy-card-btn-color: rgb(251, 175, 70);
+ --agntcy-card-btn-border: rgb(13, 39, 77);
+ --agntcy-card-btn-bg-hover: rgb(251, 175, 70);
+ --agntcy-card-btn-color-hover: rgb(3, 20, 43);
+}
+
+/* Home page only: MkDocs chrome adjustments for full-bleed hero. */
+body:has(.agntcy-landing) .md-content__button {
+ display: none;
+}
+
+.md-main__inner:has(.agntcy-landing) {
+ margin-top: 0;
+}
+
+.md-content:has(.agntcy-landing) .md-content__inner {
+ padding-top: 0;
+}
+
+.md-content:has(.agntcy-landing) .md-content__inner::before {
+ display: none;
+}
+
+.md-main:has(.agntcy-landing) {
+ overflow-x: hidden;
+}
+
+body:has(.agntcy-landing) .md-footer nav.md-footer__inner {
+ display: none;
+}
+
+.agntcy-resources {
+ margin: 0 auto 3.5rem;
+}
+
+.md-typeset .agntcy-section-title {
+ font-weight: 300;
+ font-size: 1.6rem;
+ line-height: 1.25;
+ text-align: left;
+ margin: 0 0 1.75rem;
+ color: var(--md-default-fg-color);
+}
+
+/* Hero */
+.md-typeset .agntcy-hero,
+.agntcy-landing .agntcy-hero {
+ position: relative;
+ width: 100vw;
+ max-width: 100vw;
+ margin-left: calc(50% - 50vw);
+ margin-right: calc(50% - 50vw);
+ margin-top: calc(-1 * var(--agntcy-hero-chrome-top) - 1px);
+ margin-bottom: 3rem;
+ border-radius: 0;
+ background: var(--agntcy-hero-gradient);
+ padding: calc(var(--agntcy-hero-chrome-top) + 1px) 0 0;
+ overflow: hidden;
+}
+
+.agntcy-hero__inner {
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ text-align: center;
+ gap: 1.5rem;
+ max-width: 58rem;
+ margin: 0 auto;
+ padding-block: var(--agntcy-hero-pad-block);
+ padding-inline: 2rem;
+}
+
+.md-typeset .agntcy-hero__title {
+ margin: 0;
+ font-weight: 300;
+ font-size: 2.5rem;
+ line-height: 1.1;
+ color: var(--agntcy-text-inverse);
+}
+
+.agntcy-hero__partner {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.5rem;
+}
+
+.agntcy-hero__partner-text {
+ font-size: 0.9rem;
+ color: var(--agntcy-text-inverse);
+}
+
+.md-typeset .agntcy-hero__partner-logo {
+ display: block;
+ width: auto;
+ max-width: none;
+ height: 1rem;
+}
+
+.md-typeset .agntcy-hero__tagline {
+ margin: 0;
+ font-weight: 300;
+ font-size: 1.4rem;
+ line-height: 1.3;
+ color: var(--agntcy-text-inverse);
+}
+
+.md-typeset .agntcy-hero__lede {
+ margin: 0;
+ max-width: 52rem;
+ font-weight: 300;
+ font-size: 1rem;
+ line-height: 1.65;
+ color: var(--agntcy-text-inverse);
+}
+
+.md-typeset .agntcy-hero__lede a {
+ color: var(--agntcy-yellow);
+ text-decoration: underline;
+ text-underline-offset: 0.15em;
+}
+
+.md-typeset .agntcy-hero__lede a:hover {
+ color: rgb(255, 255, 255);
+}
+
+@media screen and (max-width: 59.9375em) {
+ :root {
+ --agntcy-hero-pad-block: 2.75rem;
+ }
+
+ .agntcy-hero__inner {
+ padding-inline: 1.25rem;
+ }
+
+ .md-typeset .agntcy-hero__title {
+ font-size: 2rem;
+ }
+
+ .md-typeset .agntcy-hero__tagline {
+ font-size: 1.2rem;
+ }
+
+ .md-typeset .agntcy-hero__partner-logo {
+ height: 1.7rem;
+ }
+}
+
+/* ----------------------------------------------------------------------------
+ Documentation cards
+---------------------------------------------------------------------------- */
+.md-typeset .agntcy-resources .grid.cards > ul {
+ gap: 0.9rem;
+ grid-template-columns: repeat(auto-fit, minmax(13.5rem, 1fr));
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li {
+ display: flex;
+ flex-direction: column;
+ min-height: 10.5rem;
+ margin: 0;
+ padding: 1.1rem 1.1rem 1rem;
+ border-radius: 10px;
+ background: var(--agntcy-card-bg);
+ border: 1px solid var(--agntcy-card-border);
+ box-shadow: var(--agntcy-card-shadow);
+ transition:
+ transform 0.2s ease,
+ box-shadow 0.2s ease,
+ border-color 0.2s ease;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li:hover {
+ transform: translateY(-4px);
+ border-color: rgba(2, 81, 175, 0.28);
+ box-shadow: var(--agntcy-card-shadow-hover);
+}
+
+[data-md-color-scheme="slate"]
+ .md-typeset
+ .agntcy-resources
+ .grid.cards
+ > ul
+ > li:hover {
+ border-color: rgba(251, 175, 70, 0.45);
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p {
+ margin: 0;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:first-child {
+ display: flex;
+ align-items: center;
+ gap: 0.45rem;
+ font-size: 0.875rem;
+ line-height: 1.3;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:first-child .twemoji svg {
+ width: 1.2rem;
+ height: 1.2rem;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > hr {
+ margin: 0.55rem 0;
+ border: 0;
+ border-top: 1px solid var(--agntcy-card-border);
+ opacity: 0.85;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:nth-child(3) {
+ flex: 1 1 auto;
+ font-size: 0.8125rem;
+ line-height: 1.5;
+ color: var(--md-default-fg-color--light);
+}
+
+[data-md-color-scheme="slate"]
+ .md-typeset
+ .agntcy-resources
+ .grid.cards
+ > ul
+ > li
+ > p:nth-child(3) {
+ color: rgba(227, 227, 227, 0.82);
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child {
+ margin-top: auto;
+ padding-top: 0.85rem;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a {
+ display: inline-flex;
+ align-items: center;
+ gap: 0.35rem;
+ padding: 0.45rem 1.1rem;
+ border-radius: 50px;
+ background: var(--agntcy-card-btn-bg);
+ color: var(--agntcy-card-btn-color) !important;
+ font-size: 0.8125rem;
+ font-weight: 500;
+ line-height: 1.2;
+ text-decoration: none;
+ border: 1px solid var(--agntcy-card-btn-border);
+ box-shadow: 0 1px 2px rgba(0, 20, 43, 0.06);
+ transition:
+ background 0.15s ease,
+ color 0.15s ease,
+ border-color 0.15s ease,
+ box-shadow 0.15s ease,
+ transform 0.15s ease;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a:hover,
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a:focus-visible {
+ background: var(--agntcy-card-btn-bg-hover);
+ color: var(--agntcy-card-btn-color-hover) !important;
+ border-color: var(--agntcy-card-btn-bg-hover);
+ box-shadow: 0 4px 12px rgba(2, 81, 175, 0.22);
+ transform: translateY(-1px);
+}
+
+[data-md-color-scheme="slate"]
+ .md-typeset
+ .agntcy-resources
+ .grid.cards
+ > ul
+ > li
+ > p:last-child
+ a:hover,
+[data-md-color-scheme="slate"]
+ .md-typeset
+ .agntcy-resources
+ .grid.cards
+ > ul
+ > li
+ > p:last-child
+ a:focus-visible {
+ box-shadow: 0 4px 12px rgba(251, 175, 70, 0.25);
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a:focus-visible {
+ outline: 2px solid var(--agntcy-card-btn-bg-hover);
+ outline-offset: 2px;
+}
+
+.md-typeset .agntcy-resources .grid.cards > ul > li > p:last-child a .twemoji svg {
+ fill: currentColor;
+ width: 1em;
+ height: 1em;
+}
diff --git a/mkdocs/mkdocs.yml b/mkdocs/mkdocs.yml
index aa4a2f99..0a54a8d5 100644
--- a/mkdocs/mkdocs.yml
+++ b/mkdocs/mkdocs.yml
@@ -8,9 +8,7 @@ repo_url: https://github.com/agntcy/docs
edit_uri: edit/main/docs/
extra:
- copyright: >
- © Copyright AGNTCY Contributors.
- 
+ 
+