version: "1.0.0" name: agentverse-inspect description: > Inspect any agent's capabilities, protocols, endpoints, and status on Fetch.ai's Agentverse Almanac. Use to understand what an agent can do before interacting with it. Requires AGENTVERSE_API_KEY env var. Use when asked to "inspect", "check", or "what can this agent do". license: Apache-2.0 compatibility: Python 3.8+, network access, AGENTVERSE_API_KEY env var metadata: version: "1.0.0" author: "Fetch.ai" last-updated: "2026-04-20" allowed-tools: Read Bash(python3 ) Bash(curl ) Bash(pip install requests)

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

python3 scripts/inspect_agent.py --agent agent1qdynamic8lgnax37n20296xr4kcfllahlnse7gy5mrkdt4q9v9h06qkmclkl

Output

{
  "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

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