fetchai 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_KEYenvironment 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