search_talents tool lets your AI assistant search the Kalent talent database by translating your natural language prompts into structured filters. It returns up to 5 matching profiles with full career details.
How it works
- You describe the talent you need in plain language.
- The AI creates a filter array from your prompt, choosing the appropriate filter types, values, and modifiers.
- The MCP server executes the search and returns matching profiles.
- The AI presents a formatted table and can answer follow-up questions using the full profile data.
Every criterion you mention is treated as a hard requirement by default. If you want a criterion to be a nice-to-have rather than mandatory, say so explicitly (e.g., “ideally with experience in fintech” or “bonus if they speak Spanish”).
Filter Types
The AI selects from the following filter types based on your prompt:| Filter type | Value format | Description |
|---|---|---|
JOB_TITLE | Free text | Job title or role (e.g., “Product Designer”, “Software Engineer”) |
LOCATION | City or country | Geographic location with optional radius in km |
YEARS_OF_EXPERIENCE | Range bucket | Professional experience: 0-1, 1-3, 3-5, 5-10, 10-15, 15-20, 20-30, 30-100 |
SKILL | Free text | Technical or soft skill (e.g., “React”, “Project Management”) |
KEYWORD | Free text | Free-text search across the full profile |
LANGUAGE | Lowercase name | Spoken language (e.g., “french”, “english”, “mandarin”) |
LANGUAGE_PROFICIENCY | Level string | Language proficiency level |
COMPANY_NAME | Free text | Current or past employer |
COMPANY_SIZE | Range bucket | Company headcount: 1-10, 11-50, 51-200, 201-500, 501-1000, 1001-5000, 5001-10000, 10001+ |
COMPANY_INDUSTRY | Industry string | Employer industry sector (e.g., “software development”, “financial services”) |
EDUCATION_DEGREE | Degree level | Highest degree: bachelors, masters, doctorates |
EDUCATION_SCHOOL_NAME | Free text | School or university name |
CERTIFICATION_NAME | Free text | Professional certification (e.g., “AWS Certified”, “PMP”) |
SENIORITY | Contract type | Currently supports: Freelance |
DURATION_IN_JOB | Range bucket | Tenure in current/last role (same buckets as years of experience) |
GRADUATION_YEAR | Four-digit year | Graduation year (e.g., “2020”) |
Filter Modifiers
Each filter supports the following modifiers that the AI sets based on your prompt:| Modifier | Type | Description |
|---|---|---|
isRequired | boolean | When true, the talent must match this criterion. Set to true by default for every filter. |
isExcluded | boolean | When true, talents matching this filter are excluded from results. |
isExactMatch | boolean | When true, the value must match exactly (no fuzzy matching). |
radius | number | Search radius in kilometers. Only applies to LOCATION filters. |
history | string | Temporal scope: CURRENT, PAST, or CURRENT_OR_PAST. Only applies to JOB_TITLE and COMPANY_NAME. |
Response
Each search returns two content blocks:1. Structured JSON
Complete profile data for each matching talent, including:- Full name, location, headline
- Current job title and organization
- Work experiences (company, title, dates, description)
- Education (school, degree, major, dates)
- Skills
- Languages and proficiency levels
- Professional certifications
- LinkedIn profile URL
2. Markdown Summary Table
A formatted table displayed directly in the conversation:Example Conversations
Finding engineers with specific company experience
You: Find software engineers who have worked at OpenAI for at least 3 years. Assistant: I’ll search for software engineers with OpenAI experience and at least 3 years in the role. [Results displayed as a table with 5 matching profiles] I found 5 software engineers who match your criteria. Would you like me to look into any of these profiles in more detail, or would you like to refine the search?
Location-based search with skills
You: I need to find talent in Paris (within 20km radius) with expertise in SEO and marketing strategies. Assistant: Let me search for marketing professionals near Paris with SEO expertise. [Results displayed] Here are 5 professionals in the Paris area with SEO and marketing strategy skills. Several of them also have experience in content marketing and digital analytics.
Combining experience, role, and company type
You: Find talent with 10+ years of experience as a UX designer who has worked for a YC startup. Assistant: I’ll search for senior UX designers with Y Combinator startup experience. [Results displayed] I found 5 UX designers with 10+ years of experience and ties to Y Combinator startups. Want me to narrow down by location or specific skills?
Tips for Better Results
Be specific about requirements
Mention specific job titles, companies, locations, and skills. The more precise you are, the better the results.
Mark nice-to-haves explicitly
All criteria are treated as mandatory by default. Use words like “ideally”, “bonus”, or “nice-to-have” for optional preferences.
Use follow-up prompts
Refine your search iteratively. Ask to narrow down by adding criteria, or broaden by relaxing constraints.
Combine multiple filters
You can combine as many criteria as needed in a single prompt: job title + location + skills + experience + company type.