| name | agentverse-manage |
| description | Manage hosted agents on Fetch.ai's Agentverse: list, start, stop, view logs, and delete agents. Provides operational control over your deployed agents. Requires AGENTVERSE_API_KEY env var. Use when asked to list agents, check agent status, view logs, start/stop agents, or clean up.
|
| 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 Manage
Overview
Manage your hosted agents on Agentverse. List all agents, start/stop them, read their logs, and delete agents you no longer need.
When to Use
- User asks "list my agents" or "what agents do I have"
- User asks to "start/stop/restart" an agent
- User asks to "show agent logs" or "what is my agent doing"
- User asks to "delete" or "remove" an agent
- You need to check agent status after deploying
Prerequisites
AGENTVERSE_API_KEY environment variable set- Python 3.8+ with
requests
Quick Steps
List all agents
python3 scripts/manage_agents.py list
Start an agent
python3 scripts/manage_agents.py start --agent agent1q...
Stop an agent
python3 scripts/manage_agents.py stop --agent agent1q...
View logs
python3 scripts/manage_agents.py logs --agent agent1q...
Delete an agent
python3 scripts/manage_agents.py delete --agent agent1q...
Output Examples
List
{
"status": "success",
"total": 3,
"agents": [
{
"name": "my-image-relay",
"address": "agent1q...",
"running": true,
"compiled": true,
"domain": "",
"wallet_address": "fetch1...",
"created": "2026-04-20T10:00:00Z",
"updated": "2026-04-20T15:30:00Z"
}
]
}
Logs
{
"status": "success",
"agent": "agent1q...",
"total_entries": 15,
"showing": 3,
"logs": [
{"timestamp": "2026-04-20T15:30:00Z", "message": "Agent started", "level": "info"},
{"timestamp": "2026-04-20T15:30:01Z", "message": "Sending message...", "level": "info"},
{"timestamp": "2026-04-20T15:30:35Z", "message": "RESULT:{...}", "level"
API Reference
| Action | Method | Endpoint |
|---|
| List agents | GET | /v1/hosting/agents |
| Get agent | GET | /v1/hosting/agents/{address} |
| Start | POST | /v1/hosting/agents/{address}/start |
| Stop | POST | /v1/hosting/agents/{address}/stop |
| Delete | DELETE | /v1/hosting/agents/{address} |
| Get logs | GET | /v1/hosting/agents/{address}/logs/latest |
Edge Cases
- Agent already running: Starting a running agent is safe (no-op or restarts)
- Agent already stopped: Stopping a stopped agent is safe (no-op)
- Delete running agent: Stop it first, then delete
- Empty logs: Agent hasn't produced output yet, or was just started
