Get opportunity
Returns one opportunity with its stage, tags, sources, followers and archive state.
MCP tool lever_read → get_opportunity
read
Returns the profile fields Lever shows on the opportunity: contact name, emails, headline, stage, posting, owner, tags, sources, followers and the link to the profile. For an archived opportunity it also returns the archive reason and date. Notes and feedback come from list_notes and list_feedback.
Parameters
| Name | Type | Description |
|---|---|---|
| opportunity_id string required | string | Opportunity ID from list_opportunities. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "lever_read",
"arguments": {
"operation": "get_opportunity",
"arguments": {
"opportunity_id": "opportunity_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"opportunity_id": "5c3d8a17-e2b4-49f6-8d01-7a9b6c4e2f05",
"name": "Aisha Khan",
"headline": "UX lead at Brightly",
"emails": [
"aisha.khan@example.com"
],
"stage": "Recruiter screen",
"posting": "Senior Designer",
"owner": "Jordan Pike",
"tags": [
"portfolio-strong"
],
"sources": [
"Referral"
],
"followers": [
"Jordan Pike",
"Sam Okafor"
],
"archived": null,
"url": "https://hire.lever.co/candidates/5c3d8a17-e2b4-49f6-8d01-7a9b6c4e2f05"
},
"isError": false
}