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.
| Argument | What it takes |
|---|---|
country | Required. Where the person lives, as a two-letter code: US, GB, DE. list_countries names them. |
query | Words in the job’s title or the company’s name, such as customer success or GitLab. |
kind | Kind of work: Engineering, Sales, Customer success, Data and AI, Operations, Finance, People and HR, Marketing, Product and design, Healthcare. |
posted_within_days | Only jobs posted in the last 1 to 90 days. |
min_salary | Lowest yearly pay, in US dollars; other currencies and periods are converted roughly. Leaves out jobs that state no pay. |
include_probably | Also return jobs only probably open there, each with its reason. Off by default. |
page | 1 to 5. |
Each job comes with enough to answer most questions without opening it:
| Field | What it holds |
|---|---|
title, company, location | As the job’s card on firstmonday.ai shows them. |
kind | Kind of work, our category from the title. |
remote | Whether the post says the job is fully remote. |
verdict | Whether 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_in | Every country we cover that the job is open, or only probably open, to. |
pay | As 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. |
posted | The day the source posted it, when it says. |
poster | Who posted it when it isn’t the employer: an agency, a job board. |
skills | Up to six skills the post names. |
seniority, employment_types, hiring_model | The role’s level, the kinds of contract and how one is hired, only when we know them. |
url | The 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
| Status | What it means |
|---|---|
open | The post says it can hire people living there, or the employer lists the job as remote there. |
probably_open | It 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:
| Basis | What it means |
|---|---|
post | The post’s own words say so. |
listing | The employer lists the job as remote in that country. |
location | Only the post’s location line names the country, such as “Remote - Germany”: weaker, worth checking in the post. |
disagree | The listing and the post disagree: check the post. |
unknown | We 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:
| Reason | What it means |
|---|---|
| Only some regions | The post hires in only part of the country. |
| Time zones | The post asks for working hours, and doesn’t say where you must live. |
| Check the post | The listing and the post disagree about the country. |
| Location only | Only the post’s location names the country. |
| Only some places | The 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.