Change stage
Moves an opportunity to another pipeline stage.
MCP tool lever_write → change_stage
write Confirm
Changes the stage of the one opportunity you name; the same candidate's other active opportunities stay where they are. Lever advises against moving candidates backward because it skews pipeline data, so the call is for forward moves. A stage that does not exist fails with an error that lists your stages. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| opportunity_id string required | string | Opportunity ID from list_opportunities. |
| stage string required | string | Target stage name from list_stages. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "lever_write",
"arguments": {
"operation": "change_stage",
"arguments": {
"opportunity_id": "9b7e2f40-1c6a-4d83-b5e9-3a8c0d6f4e12",
"stage": "On-site interview"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"opportunity_id": "9b7e2f40-1c6a-4d83-b5e9-3a8c0d6f4e12",
"name": "Marco Silva",
"previous_stage": "Phone screen",
"stage": "On-site interview",
"changed_at": "2026-10-22T09:12:00Z"
},
"isError": false
}