Discovery
Delete Agent
delete_agentBenchmark and above
Delete one of the caller's own standing agents by id. Undoable: `restore_deleted` with kind `agent` and this agent_id brings it back as it was (enabled or paused). System agents (is_system:true on get_agent/list_agents — built-in agents the platform provisions) cannot be delet...
Example Call
example_call.pypython
# Using the Valuein MCP server from Python (via MCP SDK)# Or call directly from Claude / Cursor after setup result = await client.call_tool( "delete_agent", arguments={ "agent_id": "EXAMPLE"})print(result)Direct tool call:delete_agent(...)
Inputs
| Parameter | Type | Required | Description |
|---|---|---|---|
agent_id | string | required | Identifier of the agent to delete. |
Output Fields
agent_idstatusExample Response
Illustrative
response.jsonjson
{ "agent_id": null, "status": "ACTIVE"}Shape only — field names match the live schema; values are placeholders, not real filings. See MCP server for the structured response shape.
Notes
Available from the Benchmark plan and above.
Plan Access
Sample (guest)
Not includedBenchmark (token)
AvailablePro
AvailableInstitutional
AvailableRelated Tools
Index names are trademarks of their owners; Valuein is not affiliated with or endorsed by any index provider.