Search roles
search_rolesSearch open internships, co-ops and student jobs. Every argument is optional and they combine; a list matches any of its values. Newest first, except that roles with the query in their title or skills, and with more of the asked skills, come first. Returns the total, a page of roles (summary, places, terms, required skills, matched, applyUrl) and nextCursor. get_roles has the full posting.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_roles"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Roles per page, 1 to 25, default 10. | |
| query | No | Words that must all appear (title, text, skills, company, places): "data analyst", "rbc", "swe". Short forms like swe, ml, pm, qa work. Also "exact phrase", a or b, -word. | |
| terms | No | Up to 6 work terms, matched within the name: ["Summer 2027"], ["fall"], ["2027"]. | |
| types | No | Kinds of role. | |
| cursor | No | nextCursor from the previous page, with the same arguments. | |
| fields | No | Broad areas of work. | |
| majors | No | Up to 10 of the person's majors: roles asking for any of them or open to any major. | |
| remote | No | Add remote roles anywhere to a location; alone, only remote roles. | |
| skills | No | Up to 10 skills or tools, like ["python", "sql", "excel"]: roles asking for any of them, those with more first. | |
| lengths | No | Term lengths in months, 1 to 24, like [4, 8]. | |
| location | No | A town ("Waterloo", "London, ON"), province or state ("Ontario", "BC"), country ("Canada"), or "remote". "Toronto or remote" adds remote roles. | |
| companies | No | Up to 10 company names, like ["RBC", "Shopify"]. | |
| languages | No | Only roles that require one of these languages. | |
| radius_km | No | How far around a town, in km: 1 to 500, default 50. | |
| categories | No | Finer areas than fields. | |
| work_modes | No | How the role is worked. | |
| exclude_languages | No | Leave out roles that require these, like ["French"] for someone who only speaks English. | |
| posted_within_days | No | Only roles posted in the last n days, 1 to 365. |