ava_create_agent
Register an agent instance under userId, before it has a wallet or a mandate. Mode A (multi-agent): agentId=byo-external + label (e.g. claude-workspace, cursor-arb) for a coding agent that already exists elsewhere. Mode B (hosted): agentId=defi-lend|defi-swap|defi-perp|portfolio hires an Ava-run agent. One userId may own many agent instances; this call alone never touches funds.
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": {
"userId": "<userId>",
"portal": "<portal>",
"agentId": "<agentId>"
},
"name": "ava_create_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | No | Optional label to distinguish agents under one human (e.g. claude-workspace, cursor-home, openclaw-night). | |
| portal | Yes | ||
| userId | Yes | ||
| agentId | Yes | Catalog id e.g. byo-external, defi-lend, defi-swap, defi-perp, portfolio |