agentverse-inspect

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

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