Add position
add_positionRecord a holding the user already owns: a security (ISIN preferred; an exact ticker or a name also works) and a quantity, in one of their portfolios. Never buys or sells. If the name matches several securities the tool returns the candidates — ask the user which, then call again with that ISIN. Modification Plan flow: call without confirm to get a plan, show plan.human_message to the user, and only if they approve call again with confirm=true and plan_id. For bonds, quantity is the nominal.
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": {
"security": "<security>",
"quantity": "<quantity>"
},
"name": "add_position"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | No | ||
| confirm | No | ||
| plan_id | No | ||
| currency | No | ||
| quantity | Yes | ||
| security | Yes | ||
| portfolio | No | ||
| household_id | No | ||
| cost_basis_per_unit | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||