Agent ID — Renew
agentid_renewDestructiveIdempotent
Renew an Agent ID: fresh ID, same chain; the old retires. Sign like a revocation. validity_days defaults to standard. Retire outright: agentid_revoke. POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header. See https://docs.cdp.coinbase.com/x402 Paid tool — $0.25, USDC on Base or Arbitrum One. Paid URL: https://aemb.pro/v1/agent-id/renew.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"agent_id": "<agent_id>",
"revocation_signature": "<revocation_signature>"
},
"name": "agentid_renew"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | The Agent ID string returned at issuance (64 hex characters; case-insensitive). Unknown IDs are rejected | |
| validity_days | No | Days until the renewed Agent ID expires; integer 1-730. Defaults to the Embassy standard when omitted | |
| idempotency_key | No | Optional idempotency key: 8-128 printable ASCII characters (no spaces), client-generated, one per logical request — a UUID v4 is recommended; published example keys are rejected. When provided, replaying the same key returns the original receipt instead of re-running the action; when omitted, no dedupe occurs. Keys are scoped per tool and per payer account: the same key on another tool — or from another wallet — is unrelated. | |
| revocation_signature | Yes | Hex signature over the exact UTF-8 message agent-id-revoke:<OLD_agent_id> (64-char lowercase ID, no trailing newline) — the signature covers the OLD Agent ID being retired. EIP-191: personal_sign the message STRING (personal_sign envelope REQUIRED — raw ECDSA will not verify), 0x 65-byte hex r||s||v (v=27/28). ed25519: nacl.sign.detached over the message bytes, 64-byte hex. Signer: the principal's on-file revocation key, or the Embassy signer for cause |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| how | Yes | How to pay: POST the tool inputs as JSON to paid_url with an x402 v2 PAYMENT-SIGNATURE header | |
| tool | Yes | Tool name, e.g. check_url_custom | |
| asset | Yes | Settlement asset | |
| price | Yes | Exact price, e.g. "$0.25" | |
| networks | Yes | EVM CAIP-2 network ids accepted | |
| paid_url | Yes | x402-paid HTTPS URL to POST the tool inputs to | |
| facilitator | Yes | x402 facilitator | |
| payment_required | Yes | Always true: this MCP tool is a payment pointer; the tool itself is monetized via x402. |