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 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.

  👉 View the Corto README

• Lungo: A more advanced setup that will evolve over time as we mature components.

  There are two setups:

  1. pub/sub A2A over NATS as default transport along with streaming support, and
  2. 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.

  Configure lungo/.env from .env.example. Web UI (VITE_*) uses frontend/.env only. For npm run dev, drop frontend from COMPOSE_PROFILES and run Compose plus Vite as described in the Lungo README.

  👉 View the Lungo README

• AGNTCY App SDK = v0.5.5
• SLIM = v1.0.0
• NATS = latest
• A2A = v0.3.20
• MCP = v1.26.0
• LangGraph = v1.0.7
• Observe SDK = 1.0.41
• AGNTCY Identity Service SDK = 0.0.7
• AGNTCY Directory = v1.0.0

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.