Sourcing · Agency recruiter, new mandate
Turn a job note into a sourced shortlist
Paste the brief into your agent. Get raw profiles with distance, experience, and tenure, after you approve the cost.
Who it is for
Agency recruiters who just signed a mandate and want a first slate for the client inside Claude, without opening a search tool.
The problem
Search tools want boolean strings and filter menus. Agents can write those, but they cannot see the cost before spending, and they re-pay for the same pages.
Workflow
- 01
Draft
start_search turns the note into titles, adjacent titles, tools, seniority, and a location. refine_search fixes anything it missed.
- 02
Plan
The same call builds disjoint tiers, a plain-language summary, and an estimate. Nothing is spent yet.
- 03
Confirm
start_search runs only with confirm=true, and stops at the budget.
- 04
Read
get_search_results waits for the run, then returns full profiles and facts. Your agent reasons over them. There is no score.
Sample transcript
- You: Here's the brief for a senior data engineer in Antwerp. Find me around 40 people.
- Tool call: start_search { job_description: "Senior data engineer, Antwerp…", target: 40 }
- Result: ← credits_min 1 · credits_max 120 · requires_confirm true
- You: Go.
- Tool call: start_search { search_id: "pln_A1", confirm: true }
- Tool call: get_search_results { run_id: "run_A1", wait_seconds: 25 }
- Result: ← completed · 40 candidates · 120 credits
Outcome
- A first slate of raw profiles with the facts needed to triage: distance_km, experience years, tenure_months, current title, and company.
- A known cost before anything ran, and a hard stop at the budget.
- A plan you can rerun later without paying for the same pages.
Example prompts
New mandate
“Use RecruitMCP. Here's the client brief. Plan a search for about 40 people, show me the estimate and wait.”
Tighten the plan
“Drop the nearby titles step and keep only people with 5+ years. Show the new estimate.”
Triage
“Group the results by current employer and flag anyone with less than a year in their current role.”
Tools and endpoints
| tool | endpoint |
|---|---|
| start_search | POST /v1/runs |
| refine_search | PATCH /v1/intents/{intent_id} |
| get_search_results | GET /v1/runs/{run_id}/candidates |
Credit cost
example data| Intent and plan | 0 |
|---|---|
| 40 leads × 1 | 40 |
| 40 live profiles × 2 | 80 |
| Total | 120 |
Example data. The real figure is in the estimate before you confirm.