agntcy-app-sdk 0.1.1

Agntcy Application SDK for Python

Application SDK

 

The Agntcy Application SDK offers a unified, interoperable factory for constructing multi-agent components as part of the emerging internet of agents. The SDK factory will provide a single interface to interact with Agntcy components such as SLIM, Observe-SDK, and Identity, while enabling interoperability with agentic protocols such as A2A and MCP.

✅ A2A over SLIM           ✅ A2A over NATS              🕐 A2A over MQTT             
✅ Request-reply           ✅ Publish-subscribe          ✅ Broadcast                 
✅ MCP client factory      🕐 Observability provider     🕐 Identity provider         

Quick Start • Usage Guide • Reference Apps • Testing • Contributing

 

Quick Start

Install the SDK via pip:

pip install agntcy-app-sdk

Or install from source:

git clone https://github.com/agntcy/app-sdk.git
pip install -e app-sdk

A2A Server: Create an A2A server bridge with a SLIM | NATS transport.
A2A Client: Create an A2A client with a SLIM | NATS transport.
MCP Client: Create an MCP client default streamable-http transport.

A2A Server with Transport Example

from a2a.server.apps import A2AStarletteApplication
from agntcy_app_sdk.factory import AgntcyFactory

# bring your own agent card and request handler
server = A2AStarletteApplication(
  agent_card=agent_card, http_handler=request_handler
)

factory = AgntcyFactory()
transport = factory.create_transport("SLIM", "http://localhost:46357")
bridge = factory.create_bridge(server, transport=transport)

await bridge.start()

A2A Client with Transport Example

from agntcy_app_sdk.factory import AgntcyFactory
from agntcy_app_sdk.factory import ProtocolTypes

factory = AgntcyFactory()

transport = factory.create_transport("NATS", "localhost:4222")

# connect via agent URL
client_over_nats = await factory.create_client("A2A", agent_url="http://localhost:9999", transport=transport)

# or connect via agent topic
client_over_nats = await factory.create_client(ProtocolTypes.A2A.value, agent_topic="Hello_World_Agent_1.0.0", transport=transport)

MCP Client from Factory Example

from agntcy_app_sdk.factory import AgntcyFactory

# Create factory and transport
factory = AgntcyFactory()
transport_instance = factory.create_transport(
    transport="STREAMABLE_HTTP", endpoint="http://localhost:8123/mcp"
)

# Create MCP client
client = await factory.create_client(
    "MCP",
    agent_url=endpoint,
    transport=transport_instance,
)

For more details and exhaustive capabilities, see the Usage Guide.

Reference Apps

For fully functional distributed multi-agent examples, check out our coffeeAgntcy!

Testing

The /tests directory contains e2e tests for the factory, including A2A client and various transports.

Prerequisites

Run the required message bus services:

docker-compose -f infra/docker/docker-compose.yaml up

✅ Test the factory with A2A client and all available transports

Run the parameterized e2e test for the A2A client across all transports:

uv run pytest tests/e2e/test_a2a.py::test_client -s

Or run a single transport test:

uv run pytest tests/e2e/test_a2a.py::test_client -s -k "SLIM"

Contributing

Contributions are welcome! Please see the contribution guide for details on how to contribute to the Agntcy Application SDK.