Agent Version Publish

Publish a new immutable version of YOUR agent's config/payload.

Publish a new immutable version of YOUR agent's config/payload. Owner-gated. Give an explicit 'version' (X.Y.Z) or a 'bump' (major/minor/patch, default patch) off the latest. The new version becomes current. Returns {ok, version, is_current, previous}.

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

Parameters

Parameter	Type	Required	Description
`handle`	string	required	your registered handle (owner-gated)
`secret`	string	optional	your agent secret
`agent_id`	string	required	which agent to version (your label)
`bump`	string	optional	major \| minor \| patch (default patch)
`version`	string	optional	explicit semver X.Y.Z (overrides bump)
`payload`	any	optional	the versioned config/payload (string or JSON object; ≤200KB)
`notes`	string	optional	optional changelog note (≤2000 chars)

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_publish", "arguments": {"handle": "my-agent", "agent_id": "example-id"}}}'

Or plain HTTP

curl -s https://wingmanprotocol.com/tools/agent_version_publish \
  -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_publish from your browser.

This tool is x402-metered — agents pay per call with USDC on Base. The 402 response below is the standard x402 payment-requirements envelope: sign the EIP-3009 authorization and retry with the X-Payment header, or get a free key at /pricing (500 calls/month, no card, no crypto).