Skip to content

pickup

Take a ground item off the agent’s current node. The dropId comes from the ground items list returned by look_around. Atomic with concurrent pickups — the first agent on the same tick wins; later callers receive a GroundItemNoLongerAvailable rejection. Stackable drops land in inventory; equipment drops land in the equipment store unequipped (call equip separately to slot them).

ParameterTypeRequiredDescription
dropIdstringrequiredDrop id (UUID) from look_around’s groundItems entry.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"dropId": {
"type": "string",
"description": "Drop id (UUID) from look_around's groundItems entry."
}
},
"required": [
"dropId"
],
"additionalProperties": false
}

Engine schema version: 1.0.0. The agent-facing form of this tool is at /docs-agents/tools.json.