AgentAnycast

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

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/ /tcp/4001/p2p/12D3KooW..."

Configuration

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

CLI Flags

Environment Variables

Config File

Default location: ~/.agentanycast/config.toml

key_path = "~/.agentanycast/key"

grpc_listen = "unix://~/.agentanycast/daemon.sock" log_level = "info" log_format = "json" store_path = "~/.agentanycast/data" enable_mdns = true enable_quic = true enable_webtransport = false enable_relay_client = true enable_hole_punching = true offline_queue_ttl = "24h" bootstrap_peers = ["/ip4/203.0.113.50/tcp/4001/p2p/12D3KooW..."]

[bridge] enabled = false listen = ":8080"

tls_cert = "/path/to/cert.pem"

tls_key = "/path/to/key.pem"

cors_origins = ["*"]

[anycast] routing_strategy = "random" cache_ttl = "30s" auto_register = true

registry_addr = "relay.example.com:50052"

registry_addrs = ["relay1:50052", "relay2:50052"] # federation

enable_dht = false dht_mode = "auto" # "auto", "server", or "client"

[metrics] enabled = false listen = ":9090"

[mcp] enabled = false listen = ":3000"

[anp] enabled = false listen = ":8090"

NATS Transport

[transport.nats] enabled = true broker = "nats://broker.example.com:4222" subject_prefix = "agent."

Enterprise Policy

[policy] acl_rules = [ { source = "*", skill = "*", allow = true }, ]

[policy.rate_limits] default_rps = 100

audit_log_path = "/var/log/agentanycast-audit.jsonl"

OpenTelemetry

[otel] enabled = false otlp_endpoint = "localhost:4317"

[identity]

did_web = "did:web:example.com:agents:myagent"

did_dns_domain = "example.com"

Architecture

┌──────────────────────────────────────────────────────────────────────┐

│ agentanycastd │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │ │ Engine │ │ Router │ │ Offline │ │ Anycast Router │ │ │ │(task FSM) │ │(A2A msg) │ │ Queue │ │(skill discovery) │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────────────┘ │ │ │ │ │ │ │ │ ┌────┴──────────────┴─────────────┴──────────────┴──────────────┐ │ │ │ Envelope Layer (E2E NaCl box encryption) │ │ │ ├───────────────────────────────────────────────────────────────┤ │ │ │ Transport Adapters │ │ │ │ libp2p (mDNS · TCP · QUIC · WebTransport · DHT) │ │ │ │ NATS · HTTP Bridge · Circuit Relay v2 · DCUtR │ │ │ └──────────────────────┬───────────────────────────────────────┘ │ │ │ │ │ ┌──────────────────────┴──────────────────────────────────────┐ │ │ │ gRPC Server (16 RPCs for SDKs) │ │ │ └─────────────────────────────────────────────────────────────┘ │ │ │ │ ┌────────────┐ ┌────────────┐ ┌──────────┐ ┌────────┐ ┌──────────┐ │ │ │ HTTP Bridge│ │ MCP Server │ │ANP Bridge│ │ OTel │ │MCP Proxy │ │ │ │ (A2A↔P2P) │ │(stdio/HTTP)│ │(ANP↔A2A) │ │(trace) │ │(wrap cmd)│ │ │ └────────────┘ └────────────┘ └──────────┘ └────────┘ └──────────┘ │ │ │ │ ┌────────┐ ┌──────┐ ┌─────────┐ ┌──────────────────┐ │ │ │Metrics │ │BoltDB│ │ ACL / │ │ Audit Logger │ │ │ │(Prom.) │ │(stor)│ │RateLimit│ │ (JSON Lines) │ │ │ └────────┘ └──────┘ └─────────┘ └──────────────────┘ │ └──────────────────────────────────────────────────────────────────────┘

Internal Packages

gRPC API

MCP Server

The daemon can run as an MCP (Model Context Protocol) server, exposing P2P capabilities as tools for AI assistants.

Transport modes:

• stdio -- for local AI tool integration (Claude Desktop, Cursor, VS Code, Gemini CLI, JetBrains)
• Streamable HTTP -- for remote clients (ChatGPT)

MCP Remote Proxy

Wrap any MCP Server as a P2P-accessible agent with a single flag:

./agentanycastd --mcp-proxy "npx -y @modelcontextprotocol/server-filesystem /home/user"

The proxy auto-generates an Agent Card from the MCP server's tool list, registers skills with the relay, and bridges incoming A2A tasks to MCP tool calls.

HTTP Bridge

Exposes an A2A-compatible HTTP endpoint for P2P ↔ HTTP interop:

• GET /.well-known/a2a-agent-card -- Agent Card discovery
• POST / -- JSON-RPC endpoint for task operations
• Optional TLS and CORS support

ANP Bridge

Exposes an ANP-compatible HTTP endpoint for Agent Network Protocol interop:

• GET /agent/ad.json -- Agent Description (JSON-LD)
• GET /agent/interface.json -- OpenRPC specification
• POST /agent/rpc -- JSON-RPC 2.0 endpoint

Observability

Prometheus Metrics

Available on a configurable HTTP port (default :9090):