CoffeeAgntcy is a reference implementation based on a fictitious coffee company to help developers understand how components in the AGNTCY Internet of Agents ecosystem can work together.
It gives examples of the components of AGNTCY working together as a Multi-agent System (MAS).
This reference agentic application demonstrates how to:
- How SLIM enables request-reply , unicast (fire & forget) and group communication patterns.
- How tools and transports can be reused across agent implementations (e.g., SLIM, NATS, MCP)
- How protocol-agnostic bridges and clients interconnect modular agents
- How to orchestrate agents using LangGraph for structured, stateful workflows with streaming support
- How to write A2A client and server agents
- How to integrate data sources (e.g., weather services via MCP)
- How to extend or swap agents in a modular fashion using AGNTCY tooling
- How to enable observability using AGNTCY Observe SDK
- How to enable identity using AGNTCY Identity Service SDK
We currently provide two setups you can run to see how components from AGNTCY work together — one simple two-agent use case and the other a more complex MAS:
-
Corto: A two-agent, ready-to-run setup that highlights core agent interactions using agent-to-agent (A2A) messaging via configurable transports(default: AGNTCY's SLIM).
Agents are orchestrated within a LangGraph. It also shows how to enable observability using Observe SDK.
-
Lungo: A more advanced setup that will evolve over time as we mature components.
There are two setups:
- pub/sub A2A over NATS as default transport along with streaming support, and
- group communication over SLIM as default along with streaming support.
Agents are structured as directed LangGraphs with A2A communication using configurable transports.
It includes an MCP weather-aware farm that fetches live data, observability via the Observe SDK, identity, and a group communication pattern with specialized agents (farms, shipper, accountant) that collaborate to fulfill coffee orders.
- AGNTCY App SDK = v0.4.7
- SLIM = v1.0.0
- NATS = v2.11.8
- A2A = v0.3.0
- MCP >= v1.10.0
- LangGraph >= v0.4.1
- Observe SDK = 1.0.34
- AGNTCY Identity Service SDK = 0.0.6
For a common understanding, please see the terminologies used throughout this repository.
This is a developer-facing reference repo.
If you're building agentic systems—or interested in shaping the future of distributed agents—we'd love your feedback, contributions, or collaboration.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create.
For detailed contributing guidelines, please see CONTRIBUTING.md.
Distributed under the Apache-2.0 License. See LICENSE for more information.
- The AGNTCY project.