What the search_talent MCP tool does
- Use it for: "Find me 2 senior React Native engineers who can start next month."
- Don't use it for: pricing (use estimate_squad_cost) or confirming a start date (use check_availability).
Input
| Field | Type | Required | Notes |
|---|---|---|---|
query | string | One of query, skills or practice | Free text, up to 200 characters |
skills | string[] | One of query, skills or practice | 1–10 skills, e.g. "Unreal Engine 5" |
practice | enum | One of query, skills or practice | One of the 9 practice codes |
seniority | enum | No | mid, senior or lead |
start_by | date | No | Latest acceptable start date |
residency | enum | No | ksa, uae, eu or us: the client data region the engineer must work under |
language | enum | No | en or ar |
limit | integer | No | 1–25, default 10 |
cursor | string | No | From next_cursor |
Output
results[]: each hasprofile_id(anonymised, e.g. anon_8F2KQ),headline,practice,seniority,experience_band(e.g. "6–9 years"),skills[](verified in vetting),languages[],timezone(UTC offset),availability(state: now, from_date or soft_held;available_from),residency_patterns[],vetted(always true),video_available,profile_url.total: approximate number of matches.next_cursor: present when more results exist.notice: Anonymised profiles. Names and contact details are shared only after an NDA and an interview request the engineer accepts.
Example
The assistant calls search_talent with skills "Unreal Engine 5" and "rollback netcode", seniority "senior", start_by 2026-11-01, residency "uae" and limit 3. The response contains 3 profiles and a total of 14. The first is anon_8F2KQ: a Senior gameplay and netcode engineer, experience band 6–9 years, verified skills Unreal Engine 5, C++ and rollback netcode, English and Arabic, UTC+2, availability "now", with an intro video. A next_cursor lets the assistant fetch more. The text summary reads: "3 of 14 senior Unreal netcode engineers who can start by 1 Nov 2026."
Request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_talent",
"arguments": {
"skills": [
"Unreal Engine 5",
"rollback netcode"
],
"seniority": "senior",
"start_by": "2026-11-01",
"residency": "uae",
"limit": 3
}
}
}Response
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "3 of 14 senior Unreal netcode engineers who can start by 1 Nov 2026."
}
],
"structuredContent": {
"results": [
{
"profile_id": "anon_8F2KQ",
"headline": "Senior gameplay and netcode engineer",
"practice": "game_development",
"seniority": "senior",
"experience_band": "6–9 years",
"skills": [
"Unreal Engine 5",
"C++",
"rollback netcode"
],
"languages": [
"en",
"ar"
],
"timezone": "UTC+2",
"availability": {
"state": "now"
},
"residency_patterns": [
"uae"
],
"vetted": true,
"video_available": true
}
],
"total": 14,
"next_cursor": "c_2",
"notice": ""
}
}
}Errors
invalid_argument: seniority must be mid, senior or lead. Remote Pro Ai doesn't place junior engineers.invalid_argument: Provide at least one of query, skills or practice.invalid_argument: skills accepts up to 10 items.rate_limited·unavailable
total is 0 and the summary suggests widening start_by or removing a filter.
Limits and access
- Public. No token needed.
- Anonymous limit: 30 calls per minute per IP. Authenticated: 120 per minute per organisation.
- With OAuth, results also mark profiles your organisation already holds.