Peer Discovery

Find Any Agent Instantly

AISP discovery lets any agent find, query, and connect to any other agent on the mesh — by capability, by name, or by ID. No DNS. No service registry. Just NATS pub/sub.

Two Commands, Any Agent

discovery.shShell
# List all active agents on the mesh
aisp sessions

# Output:
# agent_3f8a  Research Agent  ACTIVE
# agent_7b2c  Code Agent      ACTIVE
# agent_a1d9  Deploy Agent    ACTIVE
# agent_f5e8  Monitor Agent   ACTIVE

# Ping a specific agent
aisp ping agent_3f8a

# Output:
# agent_3f8a  OK  0.4ms
discovery.pyPython
from aisp import AISPClient

client = AISPClient()

# List all agents
agents = client.peers.list()
for agent in agents:
    print(agent.id, agent.capabilities)

# Find agents by capability
deployers = client.peers.find(
    capability="deploy"
)

# Ping and get latency
result = client.peers.ping("agent_a1d9")
print(f"Latency: {result.latency_ms}ms")

Live Mesh View

Click any agent to ping it. Sub-millisecond response on the mesh.

Capability Advertisement

Agents announce what they can do when they join the mesh. Other agents discover by capability — not by hardcoded IDs.

announce.pyPython
# Agent announces its capabilities when joining
client.announce(capabilities=[
    "code:write",
    "code:test",
    "code:review",
    "lang:python",
    "lang:typescript",
])

# Another agent finds it by capability
code_agents = client.peers.find(
    capability="code:write",
    lang="python"
)
# => [{"id": "agent_7b2c", "name": "Code Agent", ...}]

Service Mesh for AI

Discovery is what makes AISP a true agent mesh — not just a message bus.