Search remote jobs open to a country
search_jobsRemote jobs a person can do from where they live, by role, company, kind of work, pay or how recent: a search of First Monday's index of remote, English-language jobs for ones open to people living in one country, in firstmonday.ai's recommended order (fresh first, a company's further jobs, agencies and flagged companies lower) or with sort newest by date alone, 20 a page, up to 5 pages. Each result says whether it is open to people in that country and on what the verdict stands (basis: the post's own words, the employer's listing, or only the location line, which is weaker evidence) with the words; where it is and whether the post says fully remote; pay for that country (a range stated only for other countries is marked so: it is not pay for that country); kind of work, and level, employment type and hiring model where known; every other covered country it is open or probably open to; the posting date; who posts it when not the employer; a few skills; and the link to the job's page, where the person reads the post and applies. By default only jobs open there; with include_probably, also jobs only probably open (status probably_open, with a reason: only some regions, time zones, only the location names it, check the post, country from the listing (the job board files it under the country; the post doesn't say where one must live), what the post holds it on (it names other countries, moves the person or ties the job to another country, means the company's own sites, or names the country only as its clients'), or a partly remote job's or a field role's condition such as 'Field role · Midwest' or 'Remote or hybrid, by choice'): those are uncertain, and the post decides. A job is fully remote only when remote is true. Pay that says 'Up to' or 'From' is one side of the pay only, not an exact amount. Not in a result: a job's requirements, reporting line, pay country by country, each country's words, and what else the post says (experience, visa sponsorship, travel, time in person, benefits, hiring steps); a single job's details hold them.
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": {
"country": "<country>"
},
"name": "search_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Kind of work, as the site names it: Engineering, Sales, Customer success, Data and AI, Operations, Finance, People and HR, Marketing, Product and design, Healthcare, Education, or another the catalog has since added. | |
| page | No | Page of 20 results, 1 to 5. | |
| sort | No | Order, as firstmonday.ai's lists offer it. recommended (default): fresh jobs first, a company's further jobs, agencies and flagged companies lower. newest: by posting date alone; jobs whose posting date is unknown come after the dated ones. | |
| level | No | Only jobs at this level as the job's title (or, rarely, its text) names it: intern; entry (junior, entry-level, graduate); mid; senior (Senior, Sr.); lead (Lead, Team Lead); staff (staff or principal); director (head of, director); executive (VP or C-level). Never worked out from years or pay. Most titles name no level and are left out by any value. | |
| query | No | Words in the job title or the company's name, e.g. 'customer success' or 'GitLab'. Omit to list all. | |
| equity | No | true: only jobs whose post offers equity: stock options, RSUs, shares or equity. An employee stock purchase plan alone (buying shares at a discount) doesn't count. Omit or false: every job. | |
| country | Yes | Where the person lives, as an ISO 3166-1 alpha-2 code (e.g. US, GB, DE); list_countries names them. | |
| min_salary | No | Minimum yearly pay in US dollars, against the top of the stated range ('up to' pay by its top, 'from' pay by its floor). Only base pay stated per year or per month counts, other currencies at fixed exchange rates; hourly, daily and weekly rates, on-target (OTE) and total pay never match, though a result may show them. A range stated only for another country counts too: its pay says so. Leaves out jobs that state no pay, and pay whose currency the post doesn't state. | |
| english_only | No | true: leave out jobs whose post requires a spoken language other than English (German, Spanish…); a language only preferred or 'a plus' doesn't count, and a post that names no language stays. Omit or false: every job. | |
| fully_remote | No | true: only jobs fully remote as far as First Monday can tell (their remote is true): none with a hybrid option, an office one must live near, regular time in person, or field work in some country; and jobs the person may do fully remote in this country by their own choice (remote or hybrid, the person's pick: such a job is probably_open with the reason 'Remote or hybrid, by choice', so it shows with include_probably, and its remote is false). Jobs First Monday hasn't read for it count by whether the post says remote. Omit or false: every job. | |
| manages_people | No | true: only jobs whose post says the person manages people (direct reports, hiring and leading a team); a title alone doesn't count. Omit or false: every job. | |
| employment_type | No | Only jobs whose post says this kind of employment: full_time, part_time, contract (contract or freelance work), internship. A post may say several (part-time or full-time). Posts that say none (about 4 in 10) are left out by any value. | |
| exclude_agencies | No | true: only the employers' own jobs: none posted by a recruitment or staffing agency, and none whose post says the person is placed at a client (staffing, outsourcing) or that the poster recruits for another company. Omit or false: every job (agencies' sit lower in the recommended order). | |
| include_probably | No | Also return jobs only probably open to people in the country (status probably_open, with a reason). Default false: only jobs open there for sure. | |
| posted_within_days | No | Only jobs posted in the last N days, or, when the source gives no date, first seen by First Monday in them (their posted is null); never one already up when First Monday first read its source, whose date is unknown. | |
| max_years_experience | No | Only jobs whose post asks for at most this many years of experience: 2 or 5. A post's years are the strictest it states ('10+ years in SRE; 2+ years mentoring' asks 10; '3-5 years' asks 3; 'up to 2 years' alone asks 2), as First Monday read them. Posts that state no years (about 3 in 10) are left out: omit it unless the person asks about experience. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| more | Yes | whether a next page exists (up to page 5) | |
| page | Yes | ||
| total | Yes | jobs that match, counted up to 100+ | |
| country | Yes | ISO 3166-1 alpha-2, the country searched | |
| relaxed | No | only when page 1 has no results: how many jobs the same search finds with one of its conditions changed, each only for a condition the search set. The words match as one phrase, in a job's title or its company's name | |
| results | Yes | ||
| country_total | No | only when page 1 has no results: the jobs open to people in the country searched, and apart those only probably open there, as list_countries counts them |