search_mentors
Find MentorCruise mentors who match a user's goal. Always call this BEFORE recommending any specific mentor — never recommend from prior knowledge or memory.
Inputs
query: 1-4 keywords (role, skill, expertise). NEVER include the words 'mentor' or 'coach'. Examples: 'python', 'product management', 'startup'. Bad: 'a python mentor for startups'.skills,industries,languages,tools,companies: optional structured filters. AND across groups, OR within. Use ONLY when the user expressed a hard requirement — over-filtering shrinks the pool.budget_usd_monthly: monthly USD cap for ongoing mentorship.response_within_hours: max median response time.
Output
Up to 8 mentors, already ranked by composite quality. Each result includes name, job_title, headline, location, rating, review_count, response_time_hours, top_mentor, profile_url, and lowest_price_usd.
lowest_price_usd is the mentor's CHEAPEST offering — could be a one-off session ($X one-time) or a monthly subscription ($X/mo). Don't assume monthly. Phrase it as 'starting at $X' or call get_sessions_or_services to know which.
Picking which to show the user
Trust the ranking. Show 2-3, strongly preferring mentors with review_count > 0. Tie-break by more reviews → top_mentor=true. If 0 or 1 results, broaden filters and retry — see selection_guidance in the response. Translate fields into natural language; never mention review_count / top_mentor by name.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_mentors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| tools | No | ||
| skills | No | ||
| companies | No | ||
| languages | No | ||
| industries | No | ||
| budget_usd_monthly | No | ||
| response_within_hours | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Error code, e.g. 'rate_limit_exceeded'. Absent on success. | |
| mentors | No | Up to 8 mentors, ranked by composite quality. | |
| message | No | Human-readable error detail. | |
| next_step | No | Suggested follow-up tool calls. | |
| results_count | No | Total matches found (may exceed the returned list). | |
| recovery_hints | No | Present only when 0 results: suggestions for broadening the search. | |
| selection_guidance | No | How to pick which mentors to show the user. |