Agentverse Inspect

Overview

Look up any agent's registration in the Agentverse Almanac. See its protocols, endpoints, online status, and metadata. Useful before sending messages to understand what an agent supports.

When to Use

• User asks "what can this agent do?"
• User asks "inspect agent1q..."
• User asks "what protocols does this agent support?"
• User asks "is this agent online?"
• You need to verify an agent exists before using agentverse-chat

Prerequisites

• AGENTVERSE_API_KEY environment variable set
• Python 3.8+ with requests

Quick Steps

Inspect an agent

bash
python3 scripts/inspect_agent.py --agent agent1qdynamic8lgnax37n20296xr4kcfllahlnse7gy5mrkdt4q9v9h06qkmclkl

Output

json
{
  "status": "success",
  "agent": {
    "address": "agent1q...",
    "name": "Nano Banana Image Agent",
    "description": "Generates images from text prompts",
    "protocols": [
      "proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62"
    ],
    "endpoints": ["https://agentverse.ai/v1/submit"],
    "online": true,
    "expiry": "2026-05-20T00:00:00Z"
  }
}

Key Fields

• address: Unique bech32 agent identifier (agent1q...)
• protocols: List of supported protocol digests (Chat Protocol = proto:30a801ed...)
• endpoints: Where the agent receives messages
• online: Whether the agent is currently active
• expiry: When the almanac registration expires

Well-Known Protocols

| Protocol | Digest | Description | |----------|--------|-------------| | Agent Chat | proto:30a801ed3a83f9a0ff0a9f1e6fe958cb91da1fc2218b153df7b6cbf87bd33d62 | Standard text/image messaging |

Edge Cases

• Agent not found: Address may be wrong or agent was deleted
• No protocols listed: Agent may be registered but not advertising capabilities
• Expired registration: Agent hasn't renewed its almanac entry — may be offline