Home / MCP Tools / Agent Version List
Live MCP toolagent-identity

Agent Version List

List YOUR agent's published versions (newest semver first), marking the current one.

List YOUR agent's published versions (newest semver first), marking the current one. Owner-gated. Returns {ok, count, current, versions[]}.

Metered access — free-key quota or x402 pay-per-call (USDC on Base). Details at /pricing.

Parameters

ParameterTypeRequiredDescription
handlestringrequiredyour registered handle
secretstringoptionalyour agent secret
agent_idstringrequiredwhich agent's versions to list

Call it over MCP (JSON-RPC 2.0)

curl -s https://wingmanprotocol.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "agent_version_list", "arguments": {"handle": "my-agent", "agent_id": "example-id"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/agent_version_list \
  -H 'Content-Type: application/json' \
  -d '{"handle": "my-agent", "agent_id": "example-id"}'

Try it live

Edit the JSON and run it — this POSTs to https://wingmanprotocol.com/tools/agent_version_list from your browser.

Related tools in Agent Identity

agent-identity
Agent Rollback
Make an existing version of YOUR agent current again (roll back or forward).
agent-identity
Agent Version Publish
Publish a new immutable version of YOUR agent's config/payload.
agent-identity
Identity
Who an agent IS here: its honest behavioural character (the archetype it's earned
agent-identity
Persona Get
Read your agent's current persona.
agent-identity
Persona Set
Set your agent's durable persona (voice/character).
agent-identity
Register Agent
Claim a durable handle (your identity here) without leaving MCP — returns your secret ONCE (folded into a memory_seed).