Match people to a requirement
match_peopleRank public Foundaree profiles against a list of required skills — use when the user describes a need ("a co-founder who knows React and has sold to enterprises", "someone to rewire my kitchen in Kochi") rather than searching for a known person. Give the required skills as skills (or describe the need in q; skill terms are then derived from it and q also narrows candidates by full text). location, area, workType, category, availability and lookingFor are hard filters; the skills only score: score = matched ÷ required (0–1), where a listed skill counts 1 and a term found in the person's category or lookingFor counts ½. Someone with 3 of 5 skills still appears, below someone with 5; ties break on availability (available first), then recency. When nobody matches a single skill, the filtered candidates come back with score 0 and fallback: true instead of an empty list. Returns JSON with items (each: person, score, matchedSkills, missingSkills, profileUrl), total, requiredSkills and fallback. Each answer has two views: the text content is the JSON described above, and the structured content is a profile-card list (people, total, query). In apps that support MCP Apps (ChatGPT, Claude) the cards render as Foundaree profile cards.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text description of the need, e.g. "someone with React and PostgreSQL experience". Used to derive skills when `skills` is absent, and as a full-text filter. | |
| area | No | Optional neighbourhood filter within the city (case-insensitive substring), e.g. "Kakkanad" | |
| limit | No | Maximum number of ranked results. Defaults to 20. | |
| skills | No | The required skills, e.g. ["React", "PostgreSQL", "Kubernetes"]. Required unless q is given. | |
| category | No | Optional comma-separated trade/profession filter (OR semantics), e.g. "driver" or "carpenter,electrician" | |
| location | No | Optional location filter (case-insensitive substring), e.g. "Bengaluru" or "Kochi" | |
| workType | No | Optional audience filter: local_service = blue-collar jobs, hands-on work (electricians, carpenters, drivers, cleaners, carers...); professional = white-collar jobs, office and professional work (developers, designers, accountants...) | |
| lookingFor | No | Optional comma-separated looking-for filter (AND semantics), e.g. "cofounder" or "job,freelance" | |
| availability | No | Optional availability filter (exact match) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| total | Yes | ||
| people | Yes |