The tools

The three read-only tools your assistant can call, what they take and what they answer.

Your assistant reads these descriptions itself and picks the tool, so you don’t need to name them. They’re here for the curious, and for anyone building on them. All three only read.

search_jobs

Remote jobs open to people living in one country, in the order of the lists on firstmonday.ai: 20 a page, up to 5 pages.

ArgumentWhat it takes
countryRequired. Where the person lives, as a two-letter code: US, GB, DE. list_countries names them.
queryWords in the job’s title or the company’s name, such as customer success or GitLab.
kindKind of work: Engineering, Sales, Customer success, Data and AI, Operations, Finance, People and HR, Marketing, Product and design, Healthcare.
posted_within_daysOnly jobs posted in the last 1 to 90 days.
min_salaryLowest yearly pay, in US dollars; other currencies and periods are converted roughly. Leaves out jobs that state no pay.
include_probablyAlso return jobs only probably open there, each with its reason. Off by default.
page1 to 5.

Each job comes with enough to answer most questions without opening it:

FieldWhat it holds
title, company, locationAs the job’s card on firstmonday.ai shows them.
kindKind of work, our category from the title.
remoteWhether the post says the job is fully remote.
verdictWhether it’s open or probably_open in that country, what it stands on (basis, below), a sentence saying so, and the words behind it.
open_in, probably_inEvery country we cover that the job is open, or only probably open, to.
payAs the post states it for that country. When the post states pay only for other countries, it says so in brackets, such as “(stated for the United States, none given for Canada)”. Empty when the post states none.
postedThe day the source posted it, when it says.
posterWho posted it when it isn’t the employer: an agency, a job board.
skillsUp to six skills the post names.
seniority, employment_types, hiring_modelThe role’s level, the kinds of contract and how one is hired, only when we know them.
urlThe job’s page on firstmonday.ai, with where to apply.

The slug is what get_job takes for the rest: requirements, pay in every country, each country’s words.

get_job

One job, by the slug search_jobs gave it: every country we cover that it’s open or probably open to, each with what the evidence says, the reason when it’s only probably open, and the words; its pay (per country when the post gives one), kind of work, location, the skills and requirements the post names, and its link. Never the full description.

A job that has closed is still there for 30 days after, with the day it closed. After that, get_job answers that it may have closed.

list_countries

The 21 countries we cover, each with its code, its open jobs, the open jobs new in the last 24 hours, and apart from those the jobs only probably open there.

What the answers mean

StatusWhat it means
openThe post says it can hire people living there, or the employer lists the job as remote there.
probably_openIt may: only some regions, only working hours, a listing and a post that disagree, or only the location names the country. The reason says which.

Each verdict also says what it stands on, its basis, so your assistant can say how sure it is:

BasisWhat it means
postThe post’s own words say so.
listingThe employer lists the job as remote in that country.
locationOnly the post’s location line names the country, such as “Remote - Germany”: weaker, worth checking in the post.
disagreeThe listing and the post disagree: check the post.
unknownWe couldn’t find the words in the post or its location line.

A probably open job’s reason is one of these, the same words as on firstmonday.ai’s lists. Your assistant may pass them on:

ReasonWhat it means
Only some regionsThe post hires in only part of the country.
Time zonesThe post asks for working hours, and doesn’t say where you must live.
Check the postThe listing and the post disagree about the country.
Location onlyOnly the post’s location names the country.
Only some placesThe post names only some places in the country.

The words behind each answer are cut to 200 characters. Titles, companies and quotes come from employers’ posts, and the tools tell the assistant to treat them as data, not instructions. See How we know a job is open to you.

On this page