AgentAnycast Node

The core daemon powering AgentAnycast's P2P agent network.

AgentAnycast Node (agentanycastd) is a sidecar daemon that runs on each machine, providing P2P networking, end-to-end encryption, and A2A protocol routing. Language SDKs (Python, TypeScript) communicate with it over gRPC.

Fully decentralized. On a local network, agents discover each other via mDNS with zero configuration. For cross-network communication, deploy your own relay with a single command.

Features

Category	Capabilities
Networking	libp2p (TCP, QUIC, WebTransport), NATS transport, mDNS auto-discovery, NAT traversal (AutoNAT + DCUtR + Circuit Relay v2)
Security	E2E NaCl box encryption (X25519 + XSalsa20-Poly1305), W3C DID identity (did:key, did:web, did:dns), skill-based ACL, per-peer rate limiting
A2A Protocol	Task state machine, 3 addressing modes (direct / anycast / HTTP bridge), streaming artifacts, offline message queue
Interop	HTTP Bridge (P2P ↔ HTTP A2A), ANP Bridge (Agent Network Protocol), MCP Server (stdio + Streamable HTTP)
Enterprise	Audit logging (JSON Lines), Prometheus metrics, OpenTelemetry tracing (W3C Trace Context, OTLP)
AI Tools	MCP Server for 13+ AI platforms, MCP Remote Proxy to wrap any MCP Server as a P2P agent

Quick Start

Standalone -- local network (zero configuration)

go build -o agentanycastd ./cmd/agentanycastd
./agentanycastd
# Agents on the same LAN discover each other automatically via mDNS

With Python SDK

pip install agentanycast

from agentanycast import Node

async with Node(skills=["translate"]) as node:
    # The daemon starts automatically — no manual setup needed
    result = await node.send_task("summarize", "Hello world")

MCP mode -- use as an AI tool

# stdio mode (Claude Desktop, Cursor, VS Code, Gemini CLI)
./agentanycastd -mcp

# Streamable HTTP mode (ChatGPT, remote clients)
./agentanycastd -mcp-listen :3000

Cross-network -- deploy your own relay

# On any VPS with a public IP
git clone https://github.com/AgentAnycast/agentanycast-relay && cd agentanycast-relay
docker-compose up -d

# Note the RELAY_ADDR from the logs, then:
./agentanycastd -bootstrap-peers "/ip4/<RELAY_IP>/tcp/4001/p2p/12D3KooW..."

Configuration

Priority: CLI flags > environment variables > config file > defaults

CLI Flags

Flag	Description
-key	Path to identity key file
-grpc-listen	gRPC listen address (unix:// or tcp://)
-log-level	Log level (debug, info, warn, error)
-bootstrap-peers	Comma-separated bootstrap multiaddrs
-bridge-listen	HTTP bridge listen address (e.g., :8080)
-enable-webtransport	Enable WebTransport (QUIC-based, browser-compatible)
-mcp	Run as MCP server over stdio
-mcp-listen	MCP Streamable HTTP listen address (e.g., :3000)
-mcp-proxy	Wrap an MCP Server command as a P2P-accessible agent
-anp-listen	ANP bridge listen address (e.g., :8090)
-nats-broker	NATS broker URL (e.g., nats://broker.example.com:4222)
-otlp-endpoint	OTLP collector endpoint for distributed tracing
-metrics-listen	Prometheus metrics listen address (e.g., :9090)
-config	Path to TOML config file
-version	Print version and exit

Environment Variables

Variable	Default
AGENTANYCAST_KEY_PATH	~/.agentanycast/key
AGENTANYCAST_GRPC_LISTEN	unix://~/.agentanycast/daemon.sock
AGENTANYCAST_LOG_LEVEL	info
`AGENTANY

... View full README on GitHub