
Azerbaijan's job market in one search: jobs from about 90 sites, each listed once, on birjob.com
Maintained bybirjob.com(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Save a search (the same filters as search_jobs) to check later with get_new_matches. Use this when the user wants to follow a search over time. Each call saves another search. Nothing is emailed or sent on a schedule: new jobs are found only when get_new_matches is called. Do not use for a one-off search (search_jobs). Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
A city or district of Azerbaijan, as for search_jobs.
A short name for the saved search, e.g. "Python in Baku". Made from the filters if left out.
Words in the job title or company name, as for search_jobs.
Work format, as for search_jobs (default exclude).
AZ (default), UZ, KZ, TR, GE or KG.
A field of work, as for search_jobs.
Lowest monthly pay in manat (AZN). Azerbaijan only.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http jobs https://www.birjob.com/mcp
Save a search (the same filters as search_jobs) to check later with get_new_matches. Use this when the user wants to follow a search over time. Each call saves another search. Nothing is emailed or sent on a schedule: new jobs are found only when get_new_matches is called. Do not use for a one-off search (search_jobs). Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| city | string | A city or district of Azerbaijan, as for search_jobs. |
| name | string | A short name for the saved search, e.g. "Python in Baku". Made from the filters if left out. |
| query | string | Words in the job title or company name, as for search_jobs. |
| remote | string | Work format, as for search_jobs (default exclude). |
| country | string | AZ (default), UZ, KZ, TR, GE or KG. |
| category | string | A field of work, as for search_jobs. |
| salary_min | integer | Lowest monthly pay in manat (AZN). Azerbaijan only. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"maxLength": 60,
"description": "A city or district of Azerbaijan, as for search_jobs."
},
"name": {
"type": "string",
"maxLength": 80,
"description": "A short name for the saved search, e.g. \"Python in Baku\". Made from the filters if left out."
},
"query": {
"type": "string",
"maxLength": 100,
"description": "Words in the job title or company name, as for search_jobs."
},
"remote": {
"enum": [
"exclude",
"only",
"any",
"onsite",
"hybrid"
],
"type": "string",
"description": "Work format, as for search_jobs (default exclude)."
},
"country": {
"enum": [
"AZ",
"UZ",
"KZ",
"TR",
"GE",
"KG"
],
"type": "string",
"description": "AZ (default), UZ, KZ, TR, GE or KG."
},
"category": {
"enum": [
"it",
"proqram-tertibati",
"data-analitika",
"maliyye",
"satis",
"huquq",
"muhendislik",
"bank",
"insan-resurslari",
"tibb",
"aqro-kend-teserrufat",
"neft-qaz",
"suni-intellekt"
],
"type": "string",
"description": "A field of work, as for search_jobs."
},
"salary_min": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "Lowest monthly pay in manat (AZN). Azerbaijan only."
}
}
}Delete one of the user's saved searches. Use this only when the user asks to stop following a search. Cannot be undone; the search can be saved again with create_job_alert. Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| alert_id* | integer | The id from get_job_alerts. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"alert_id"
],
"properties": {
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The id from get_job_alerts.",
"exclusiveMinimum": 0
}
}
}List the user's tracked applications on BirJob, most recently changed first, optionally by status. Use this when the user asks where they applied or how their applications stand. Do not use for saved jobs (get_saved_jobs). Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| page | integer | Result page, 1 to 50 (default 1), 10 a page. |
| status | string | Only applications with this status. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Result page, 1 to 50 (default 1), 10 a page."
},
"status": {
"enum": [
"saved",
"applied",
"interview",
"offer",
"rejected"
],
"type": "string",
"description": "Only applications with this status."
}
}
}Read one job on BirJob by its id (from search_jobs) or its birjob.com URL. Use this when the user wants the full description, requirements or how to apply for a job already found. Returns title, company, place, salary, work format, employment type, seniority, dates, the whole description and requirements as plain text (contact details removed), the apply link and its source. A closed job answers only its id, title, company and status closed. Do not use for searching: it reads one known job.
| Argument | Type | Description |
|---|---|---|
| id* | any | The job id from search_jobs, or a birjob.com job URL (https://www.birjob.com/jobs/…). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"maxLength": 300,
"minLength": 1
}
],
"description": "The job id from search_jobs, or a birjob.com job URL (https://www.birjob.com/jobs/…)."
}
}
}List the user's saved searches on BirJob, with their ids for get_new_matches and delete_job_alert. Use this when the user asks which searches they follow. Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}The jobs that reached BirJob since this saved search was last checked and match it, newest first, up to 10, each with its birjob.com URL. Marks the search as checked now. Use this when the user asks what is new for a search they saved. Do not use for a search that is not saved (new_since). Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| alert_id* | integer | The id from create_job_alert or get_job_alerts. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"alert_id"
],
"properties": {
"alert_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The id from create_job_alert or get_job_alerts.",
"exclusiveMinimum": 0
}
}
}List the user's saved jobs on BirJob, newest first, with each job's birjob.com URL; a job no longer open is marked closed. Use this when the user asks what they saved. Do not use for applications (get_applications). Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| page | integer | Result page, 1 to 100 (default 1), 10 a page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Result page, 1 to 100 (default 1), 10 a page."
}
}
}Find employers on BirJob by name, with how many open jobs each has and the URL of its birjob.com company page. Use this when the user names or asks about an employer (şirkət, company, компания), or wants the biggest hirers: without a query it lists the employers with the most open jobs in Azerbaijan. Do not use for the jobs themselves: pass the company's url to search_jobs as company.
| Argument | Type | Description |
|---|---|---|
| page | integer | Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url. |
| query | string | Part of the company name: "Kapital", "PASHA", "Azercell", "SOCAR". Leave out for the employers with the most open jobs in Azerbaijan. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url."
},
"query": {
"type": "string",
"maxLength": 100,
"description": "Part of the company name: \"Kapital\", \"PASHA\", \"Azercell\", \"SOCAR\". Leave out for the employers with the most open jobs in Azerbaijan."
}
}
}Rank open jobs in Azerbaijan on BirJob against a role, skills or CV text, with the words each job matched and why. Use this when the user shares a CV or a list of skills and asks which jobs fit. Pass title, skills and/or cv_text: they are used for this one call and not stored. No sign-in needed. Or set use_profile to true to use the signed-in user's own BirJob CV profile (title, skills, experience); that asks the user to sign in to BirJob. Do not use for a plain search by job title (search_jobs).
| Argument | Type | Description |
|---|---|---|
| title | string | The role the user wants, e.g. "Baş mühasib", "Frontend Developer". |
| skills | string | Skills, comma-separated: "Python, SQL, Excel". |
| cv_text | string | The CV's text, up to 20000 characters. Used for this call only, never stored. Leave out contact details. |
| use_profile | boolean | true: use the signed-in user's BirJob CV profile instead of the text passed. Needs sign-in. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"description": "The role the user wants, e.g. \"Baş mühasib\", \"Frontend Developer\"."
},
"skills": {
"type": "string",
"maxLength": 1000,
"description": "Skills, comma-separated: \"Python, SQL, Excel\"."
},
"cv_text": {
"type": "string",
"maxLength": 20000,
"description": "The CV's text, up to 20000 characters. Used for this call only, never stored. Leave out contact details."
},
"use_profile": {
"type": "boolean",
"description": "true: use the signed-in user's BirJob CV profile instead of the text passed. Needs sign-in."
}
}
}Jobs BirJob first listed after a given time that match the same filters as search_jobs, newest first, with the same fields. Use this when the user asks what is new since a date or since the last check: keep the time of each call and pass it as since next time. since may be up to 30 days back. Do not use for a general search (search_jobs with posted_within_days covers "this week").
| Argument | Type | Description |
|---|---|---|
| city | string | A city or district of Azerbaijan, in Azerbaijani, English or Russian spelling: "Bakı" / "Baku" / "Баку", "Gəncə" / "Ganja" / "Гянджа", "Sumqayıt" / "Sumgait" / "Сумгаит", "Şəki" / "Shaki" / "Шеки". Leave out for the whole country. |
| page | integer | Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url. |
| query | string | What the user is looking for, in their words: a job title, skills or a sentence about their work ("python", "mühasib", "accountant", "I build production LLM systems with Python and Azure"). Matched by meaning in the title, company and description, across Azerbaijani, English and Russian (mühasib = accountant = бухгалтер; LLM finds AI and ML roles); jobs whose title fits best come first. Azerbaijani letters are optional. Put the place, country, category, company, work format, job type, seniority and pay in their own fields. Leave out to browse. |
| since* | string | ISO 8601 date or time, within the last 30 days: "2026-11-20" or "2026-11-20T08:00:00Z". Returns jobs BirJob first listed after it. Keep the time of your last call and pass it next time. |
| remote | string | Work format. exclude (the default, as on birjob.com): every job except remote ones. only: remote jobs only. any: every job. onsite or hybrid: jobs that say so. Always within the chosen country. |
| company | string | One employer's jobs: its birjob.com company page URL or slug (from list_companies or a job's company_url), or its name. |
| country | string | Which board to search: AZ (Azerbaijan, the default), UZ (Uzbekistan), KZ (Kazakhstan), TR (Turkey), GE (Georgia) or KG (Kyrgyzstan). city applies to AZ only. |
| category | string | A field of work: it (IT / Texnologiya), proqram-tertibati (Proqram Tərtibatı), data-analitika (Data və Analitika), maliyye (Maliyyə / Mühasibat), satis (Satış / Marketing), huquq (Hüquq), muhendislik (Mühəndislik), bank (Bank / Sığorta), insan-resurslari (İnsan Resursları), tibb (Tibb / Səhiyyə), aqro-kend-teserrufat (Aqro / Kənd Təsərrüfatı), neft-qaz (Neft-Qaz), suni-intellekt (Süni İntellekt / AI). |
| page_size | integer | Results a page, 1 to 25 (default 10). Keep the same page_size while paging. |
| seniority | array | Keep only jobs whose stated career level is one of these: intern (təcrübəçi, стажёр), junior (kiçik mütəxəssis, младший), mid (orta, средний), senior (böyük mütəxəssis, старший), lead (rəhbər, ведущий), exec (top menecer, руководитель). Most postings state none, so this narrows a lot. |
| salary_min | integer | Lowest monthly pay. Keeps only jobs that state a salary at least this high, in salary_currency (default AZN on the Azerbaijan board). Nothing is converted between currencies. |
| work_format | string | remote (uzaqdan, удалённо), hybrid (hibrid, гибрид) or onsite (ofisdə, в офисе): the same as remote=only, hybrid or onsite. Send this or remote, not both. |
| employment_type | array | Keep only jobs that state one of these types: full_time (tam ştat, полная занятость), part_time (yarım ştat, частичная занятость), contract (müqavilə, контракт), internship (təcrübə, стажировка), temporary (müvəqqəti, временная). A job that states no type is left out. |
| salary_currency | string | ISO currency of salary_min. Alone, keeps only jobs that state pay in this currency. Required for salary_min outside Azerbaijan. |
| exclude_employment_type | array | Leave out jobs that state one of these types, e.g. ["internship"]. A job that states no type stays. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"since"
],
"properties": {
"city": {
"type": "string",
"maxLength": 60,
"description": "A city or district of Azerbaijan, in Azerbaijani, English or Russian spelling: \"Bakı\" / \"Baku\" / \"Баку\", \"Gəncə\" / \"Ganja\" / \"Гянджа\", \"Sumqayıt\" / \"Sumgait\" / \"Сумгаит\", \"Şəki\" / \"Shaki\" / \"Шеки\". Leave out for the whole country."
},
"page": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "What the user is looking for, in their words: a job title, skills or a sentence about their work (\"python\", \"mühasib\", \"accountant\", \"I build production LLM systems with Python and Azure\"). Matched by meaning in the title, company and description, across Azerbaijani, English and Russian (mühasib = accountant = бухгалтер; LLM finds AI and ML roles); jobs whose title fits best come first. Azerbaijani letters are optional. Put the place, country, category, company, work format, job type, seniority and pay in their own fields. Leave out to browse."
},
"since": {
"type": "string",
"maxLength": 40,
"minLength": 10,
"description": "ISO 8601 date or time, within the last 30 days: \"2026-11-20\" or \"2026-11-20T08:00:00Z\". Returns jobs BirJob first listed after it. Keep the time of your last call and pass it next time."
},
"remote": {
"enum": [
"exclude",
"only",
"any",
"onsite",
"hybrid"
],
"type": "string",
"description": "Work format. exclude (the default, as on birjob.com): every job except remote ones. only: remote jobs only. any: every job. onsite or hybrid: jobs that say so. Always within the chosen country."
},
"company": {
"type": "string",
"maxLength": 300,
"description": "One employer's jobs: its birjob.com company page URL or slug (from list_companies or a job's company_url), or its name."
},
"country": {
"enum": [
"AZ",
"UZ",
"KZ",
"TR",
"GE",
"KG"
],
"type": "string",
"description": "Which board to search: AZ (Azerbaijan, the default), UZ (Uzbekistan), KZ (Kazakhstan), TR (Turkey), GE (Georgia) or KG (Kyrgyzstan). city applies to AZ only."
},
"category": {
"enum": [
"it",
"proqram-tertibati",
"data-analitika",
"maliyye",
"satis",
"huquq",
"muhendislik",
"bank",
"insan-resurslari",
"tibb",
"aqro-kend-teserrufat",
"neft-qaz",
"suni-intellekt"
],
"type": "string",
"description": "A field of work: it (IT / Texnologiya), proqram-tertibati (Proqram Tərtibatı), data-analitika (Data və Analitika), maliyye (Maliyyə / Mühasibat), satis (Satış / Marketing), huquq (Hüquq), muhendislik (Mühəndislik), bank (Bank / Sığorta), insan-resurslari (İnsan Resursları), tibb (Tibb / Səhiyyə), aqro-kend-teserrufat (Aqro / Kənd Təsərrüfatı), neft-qaz (Neft-Qaz), suni-intellekt (Süni İntellekt / AI)."
},
"page_size": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Results a page, 1 to 25 (default 10). Keep the same page_size while paging."
},
"seniority": {
"type": "array",
"items": {
"enum": [
"intern",
"junior",
"mid",
"senior",
"lead",
"exec"
],
"type": "string"
},
"maxItems": 6,
"description": "Keep only jobs whose stated career level is one of these: intern (təcrübəçi, стажёр), junior (kiçik mütəxəssis, младший), mid (orta, средний), senior (böyük mütəxəssis, старший), lead (rəhbər, ведущий), exec (top menecer, руководитель). Most postings state none, so this narrows a lot."
},
"salary_min": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1,
"description": "Lowest monthly pay. Keeps only jobs that state a salary at least this high, in salary_currency (default AZN on the Azerbaijan board). Nothing is converted between currencies."
},
"work_format": {
"enum": [
"remote",
"hybrid",
"onsite"
],
"type": "string",
"description": "remote (uzaqdan, удалённо), hybrid (hibrid, гибрид) or onsite (ofisdə, в офисе): the same as remote=only, hybrid or onsite. Send this or remote, not both."
},
"employment_type": {
"type": "array",
"items": {
"enum": [
"full_time",
"part_time",
"contract",
"internship",
"temporary"
],
"type": "string"
},
"maxItems": 5,
"description": "Keep only jobs that state one of these types: full_time (tam ştat, полная занятость), part_time (yarım ştat, частичная занятость), contract (müqavilə, контракт), internship (təcrübə, стажировка), temporary (müvəqqəti, временная). A job that states no type is left out."
},
"salary_currency": {
"enum": [
"AZN",
"USD",
"EUR",
"GBP",
"RUB",
"TRY",
"GEL",
"KZT",
"UZS",
"KGS"
],
"type": "string",
"description": "ISO currency of salary_min. Alone, keeps only jobs that state pay in this currency. Required for salary_min outside Azerbaijan."
},
"exclude_employment_type": {
"type": "array",
"items": {
"enum": [
"full_time",
"part_time",
"contract",
"internship",
"temporary"
],
"type": "string"
},
"maxItems": 5,
"description": "Leave out jobs that state one of these types, e.g. [\"internship\"]. A job that states no type stays."
}
}
}Save a job to the user's BirJob saved jobs (the same list as on birjob.com). Use this when the user asks to save, bookmark or keep a job for later. Saving a saved job again changes nothing. Do not use to record an application (track_application). Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| job_id* | any | The job id from search_jobs, or its birjob.com job URL. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"maxLength": 300,
"minLength": 1
}
],
"description": "The job id from search_jobs, or its birjob.com job URL."
}
}
}Search open job vacancies on BirJob (birjob.com), Azerbaijan's job board, which also lists Uzbekistan, Kazakhstan, Turkey, Georgia and Kyrgyzstan. Use this when the user asks for jobs or vacancies (vakansiya, iş, вакансии) by role, skill, place, employer, pay or date. Returns 10 jobs a page by default (page_size up to 25): title, company, place, work format, employment type, seniority, salary as numbers and currency, dates, a short snippet and each job's birjob.com URL. query is matched by meaning across Azerbaijani, English and Russian; put place, country, field, company, date, work format, job type, seniority and pay in their own fields. Do not use for one job's full text or apply link (get_job), or for jobs listed after a known time (new_since).
| Argument | Type | Description |
|---|---|---|
| city | string | A city or district of Azerbaijan, in Azerbaijani, English or Russian spelling: "Bakı" / "Baku" / "Баку", "Gəncə" / "Ganja" / "Гянджа", "Sumqayıt" / "Sumgait" / "Сумгаит", "Şəki" / "Shaki" / "Шеки". Leave out for the whole country. |
| page | integer | Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url. |
| sort | string | relevance (the default with a query): best match first. newest (the default without a query): newest first. salary: highest stated monthly pay first (in manat, or in salary_currency when given), jobs without a salary last. |
| query | string | What the user is looking for, in their words: a job title, skills or a sentence about their work ("python", "mühasib", "accountant", "I build production LLM systems with Python and Azure"). Matched by meaning in the title, company and description, across Azerbaijani, English and Russian (mühasib = accountant = бухгалтер; LLM finds AI and ML roles); jobs whose title fits best come first. Azerbaijani letters are optional. Put the place, country, category, company, work format, job type, seniority and pay in their own fields. Leave out to browse. |
| remote | string | Work format. exclude (the default, as on birjob.com): every job except remote ones. only: remote jobs only. any: every job. onsite or hybrid: jobs that say so. Always within the chosen country. |
| company | string | One employer's jobs: its birjob.com company page URL or slug (from list_companies or a job's company_url), or its name. |
| country | string | Which board to search: AZ (Azerbaijan, the default), UZ (Uzbekistan), KZ (Kazakhstan), TR (Turkey), GE (Georgia) or KG (Kyrgyzstan). city applies to AZ only. |
| category | string | A field of work: it (IT / Texnologiya), proqram-tertibati (Proqram Tərtibatı), data-analitika (Data və Analitika), maliyye (Maliyyə / Mühasibat), satis (Satış / Marketing), huquq (Hüquq), muhendislik (Mühəndislik), bank (Bank / Sığorta), insan-resurslari (İnsan Resursları), tibb (Tibb / Səhiyyə), aqro-kend-teserrufat (Aqro / Kənd Təsərrüfatı), neft-qaz (Neft-Qaz), suni-intellekt (Süni İntellekt / AI). |
| page_size | integer | Results a page, 1 to 25 (default 10). Keep the same page_size while paging. |
| seniority | array | Keep only jobs whose stated career level is one of these: intern (təcrübəçi, стажёр), junior (kiçik mütəxəssis, младший), mid (orta, средний), senior (böyük mütəxəssis, старший), lead (rəhbər, ведущий), exec (top menecer, руководитель). Most postings state none, so this narrows a lot. |
| salary_min | integer | Lowest monthly pay. Keeps only jobs that state a salary at least this high, in salary_currency (default AZN on the Azerbaijan board). Nothing is converted between currencies. |
| work_format | string | remote (uzaqdan, удалённо), hybrid (hibrid, гибрид) or onsite (ofisdə, в офисе): the same as remote=only, hybrid or onsite. Send this or remote, not both. |
| employment_type | array | Keep only jobs that state one of these types: full_time (tam ştat, полная занятость), part_time (yarım ştat, частичная занятость), contract (müqavilə, контракт), internship (təcrübə, стажировка), temporary (müvəqqəti, временная). A job that states no type is left out. |
| salary_currency | string | ISO currency of salary_min. Alone, keeps only jobs that state pay in this currency. Required for salary_min outside Azerbaijan. |
| posted_within_days | integer | Only jobs posted in the last this many days, 1 to 30. |
| exclude_employment_type | array | Leave out jobs that state one of these types, e.g. ["internship"]. A job that states no type stays. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"maxLength": 60,
"description": "A city or district of Azerbaijan, in Azerbaijani, English or Russian spelling: \"Bakı\" / \"Baku\" / \"Баку\", \"Gəncə\" / \"Ganja\" / \"Гянджа\", \"Sumqayıt\" / \"Sumgait\" / \"Сумгаит\", \"Şəki\" / \"Shaki\" / \"Шеки\". Leave out for the whole country."
},
"page": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url."
},
"sort": {
"enum": [
"relevance",
"newest",
"salary"
],
"type": "string",
"description": "relevance (the default with a query): best match first. newest (the default without a query): newest first. salary: highest stated monthly pay first (in manat, or in salary_currency when given), jobs without a salary last."
},
"query": {
"type": "string",
"maxLength": 200,
"description": "What the user is looking for, in their words: a job title, skills or a sentence about their work (\"python\", \"mühasib\", \"accountant\", \"I build production LLM systems with Python and Azure\"). Matched by meaning in the title, company and description, across Azerbaijani, English and Russian (mühasib = accountant = бухгалтер; LLM finds AI and ML roles); jobs whose title fits best come first. Azerbaijani letters are optional. Put the place, country, category, company, work format, job type, seniority and pay in their own fields. Leave out to browse."
},
"remote": {
"enum": [
"exclude",
"only",
"any",
"onsite",
"hybrid"
],
"type": "string",
"description": "Work format. exclude (the default, as on birjob.com): every job except remote ones. only: remote jobs only. any: every job. onsite or hybrid: jobs that say so. Always within the chosen country."
},
"company": {
"type": "string",
"maxLength": 300,
"description": "One employer's jobs: its birjob.com company page URL or slug (from list_companies or a job's company_url), or its name."
},
"country": {
"enum": [
"AZ",
"UZ",
"KZ",
"TR",
"GE",
"KG"
],
"type": "string",
"description": "Which board to search: AZ (Azerbaijan, the default), UZ (Uzbekistan), KZ (Kazakhstan), TR (Turkey), GE (Georgia) or KG (Kyrgyzstan). city applies to AZ only."
},
"category": {
"enum": [
"it",
"proqram-tertibati",
"data-analitika",
"maliyye",
"satis",
"huquq",
"muhendislik",
"bank",
"insan-resurslari",
"tibb",
"aqro-kend-teserrufat",
"neft-qaz",
"suni-intellekt"
],
"type": "string",
"description": "A field of work: it (IT / Texnologiya), proqram-tertibati (Proqram Tərtibatı), data-analitika (Data və Analitika), maliyye (Maliyyə / Mühasibat), satis (Satış / Marketing), huquq (Hüquq), muhendislik (Mühəndislik), bank (Bank / Sığorta), insan-resurslari (İnsan Resursları), tibb (Tibb / Səhiyyə), aqro-kend-teserrufat (Aqro / Kənd Təsərrüfatı), neft-qaz (Neft-Qaz), suni-intellekt (Süni İntellekt / AI)."
},
"page_size": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Results a page, 1 to 25 (default 10). Keep the same page_size while paging."
},
"seniority": {
"type": "array",
"items": {
"enum": [
"intern",
"junior",
"mid",
"senior",
"lead",
"exec"
],
"type": "string"
},
"maxItems": 6,
"description": "Keep only jobs whose stated career level is one of these: intern (təcrübəçi, стажёр), junior (kiçik mütəxəssis, младший), mid (orta, средний), senior (böyük mütəxəssis, старший), lead (rəhbər, ведущий), exec (top menecer, руководитель). Most postings state none, so this narrows a lot."
},
"salary_min": {
"type": "integer",
"maximum": 1000000000,
"minimum": 1,
"description": "Lowest monthly pay. Keeps only jobs that state a salary at least this high, in salary_currency (default AZN on the Azerbaijan board). Nothing is converted between currencies."
},
"work_format": {
"enum": [
"remote",
"hybrid",
"onsite"
],
"type": "string",
"description": "remote (uzaqdan, удалённо), hybrid (hibrid, гибрид) or onsite (ofisdə, в офисе): the same as remote=only, hybrid or onsite. Send this or remote, not both."
},
"employment_type": {
"type": "array",
"items": {
"enum": [
"full_time",
"part_time",
"contract",
"internship",
"temporary"
],
"type": "string"
},
"maxItems": 5,
"description": "Keep only jobs that state one of these types: full_time (tam ştat, полная занятость), part_time (yarım ştat, частичная занятость), contract (müqavilə, контракт), internship (təcrübə, стажировка), temporary (müvəqqəti, временная). A job that states no type is left out."
},
"salary_currency": {
"enum": [
"AZN",
"USD",
"EUR",
"GBP",
"RUB",
"TRY",
"GEL",
"KZT",
"UZS",
"KGS"
],
"type": "string",
"description": "ISO currency of salary_min. Alone, keeps only jobs that state pay in this currency. Required for salary_min outside Azerbaijan."
},
"posted_within_days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Only jobs posted in the last this many days, 1 to 30."
},
"exclude_employment_type": {
"type": "array",
"items": {
"enum": [
"full_time",
"part_time",
"contract",
"internship",
"temporary"
],
"type": "string"
},
"maxItems": 5,
"description": "Leave out jobs that state one of these types, e.g. [\"internship\"]. A job that states no type stays."
}
}
}Open jobs like one BirJob job (by its id from search_jobs, or its birjob.com URL): the same kind of role in other words and languages, in the same country, the same city first. Use this when the user likes a job and asks for more like it. 10 a page by default, with the same fields as search_jobs. Do not use for a new search by words or filters (search_jobs).
| Argument | Type | Description |
|---|---|---|
| id* | any | The job id from search_jobs, or a birjob.com job URL (https://www.birjob.com/jobs/…). |
| page | integer | Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url. |
| page_size | integer | Results a page, 1 to 25 (default 10). Keep the same page_size while paging. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"maxLength": 300,
"minLength": 1
}
],
"description": "The job id from search_jobs, or a birjob.com job URL (https://www.birjob.com/jobs/…)."
},
"page": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Result page, 1 to 20 (default 1), 10 results a page. Past page 20, send the user to search_url."
},
"page_size": {
"type": "integer",
"maximum": 25,
"minimum": 1,
"description": "Results a page, 1 to 25 (default 10). Keep the same page_size while paging."
}
}
}Record where the user is with a job on BirJob: saved, applied, interview, offer, rejected. Use this when the user says they applied, got an interview, an offer or a rejection. Calling it again for the same job changes the status. Do not use to apply: it records the status for the user only, and does not apply to the job or contact the employer. Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| job_id* | any | The job id from search_jobs, or its birjob.com job URL. |
| status* | string | saved (interested), applied, interview, offer or rejected. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id",
"status"
],
"properties": {
"job_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"maxLength": 300,
"minLength": 1
}
],
"description": "The job id from search_jobs, or its birjob.com job URL."
},
"status": {
"enum": [
"saved",
"applied",
"interview",
"offer",
"rejected"
],
"type": "string",
"description": "saved (interested), applied, interview, offer or rejected."
}
}
}Remove a job from the user's BirJob saved jobs. Use this only when the user asks to remove or unsave a job. Cannot be undone from here; the job can be saved again with save_job. Needs a signed-in BirJob job seeker account: the first call asks the user to sign in to BirJob and allow access.
| Argument | Type | Description |
|---|---|---|
| job_id* | any | The job id from search_jobs, or its birjob.com job URL. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"maxLength": 300,
"minLength": 1
}
],
"description": "The job id from search_jobs, or its birjob.com job URL."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.