Jobo Developer is an MCP server published by world.jobo, hosted at dev-mcp.jobo.world. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 6 tools, including find_companies, find_filter_values, find_locations, list_filters, describe_search_filters.
Look up Jobo company ids, occupations and filter values while you build on the Jobo jobs API.
4 connections through 4 shared values. Tap any node.
Resolve a company name or website domain to its Jobo company ids. Prefix match on the name or the domain (2+ characters). Returns each company's ids, domain, HQ country (ISO 3166-1 alpha-2) and live job count, companies with live jobs first. Use it when the integration you are writing filters jobs by employer: store the ids, not the name, because a name also matches every other company called that. One company has one id per careers board, so put every id it returns into the `companies` filter (or `exclude_companies`). Needs the Jobo API key in this server's `Authorization: Bearer` header; a sandbox key (jbe_test_…) cannot use it. Free: rate limited, never billed.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Start of the company name or website domain, e.g. 'stripe' or 'stripe.com'. |
| limit | integer | Most companies to return, 1–20 (default 8). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
{
"name": "find_companies",
"title": "Find company ids",
"description": "Resolve a company name or website domain to its Jobo company ids. Prefix match on the name or the domain (2+ characters). Returns each company's ids, domain, HQ country (ISO 3166-1 alpha-2) and live job count, companies with live jobs first. Use it when the integration you are writing filters jobs by employer: store the ids, not the name, because a name also matches every other company called that. One company has one id per careers board, so put every id it returns into the `companies` filter (or `exclude_companies`). Needs the Jobo API key in this server's `Authorization: Bearer` header; a sandbox key (jbe_test_…) cannot use it. Free: rate limited, never billed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"minLength": 2,
"description": "Start of the company name or website domain, e.g. 'stripe' or 'stripe.com'."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Most companies to return, 1–20 (default 8)."
}
}
},
"annotations": {
"title": "Find company ids",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}List the accepted values of one open-vocabulary search filter, with live job counts, so the code you write sends a value the index holds. Filters match exactly: an unknown value returns zero jobs, not an error. Facets: sources, skills, industries, company_categories, job_categories, job_subcategories, occupations. `sources` are ATS ids (greenhouse, lever_co); `job_categories` and `job_subcategories` are the occupation taxonomy's two upper levels; `occupations` returns occupation ids for the `occupation_ids` filter. Without `q`: the values with the most live jobs. With `q`: the values that start with it; for `occupations`, `q` is a role name ('registered nurse') matched against occupation, subcategory and category names. Needs the Jobo API key in this server's `Authorization: Bearer` header; a sandbox key (jbe_test_…) cannot use it. Free: rate limited, never billed.
| Parameter | Type | Description |
|---|---|---|
| q | string | For occupations, words of the role name ('nurse', 'backend developer'). For the other facets, the start of a value ('pyth', 'soft'). Leave out for the most common values. |
| facet * | string | Which filter's values to list. |
| limit | integer | Most values to return, 1–250 (default 25). |
{
"name": "find_filter_values",
"title": "Find filter values",
"description": "List the accepted values of one open-vocabulary search filter, with live job counts, so the code you write sends a value the index holds. Filters match exactly: an unknown value returns zero jobs, not an error. Facets: sources, skills, industries, company_categories, job_categories, job_subcategories, occupations. `sources` are ATS ids (greenhouse, lever_co); `job_categories` and `job_subcategories` are the occupation taxonomy's two upper levels; `occupations` returns occupation ids for the `occupation_ids` filter. Without `q`: the values with the most live jobs. With `q`: the values that start with it; for `occupations`, `q` is a role name ('registered nurse') matched against occupation, subcategory and category names. Needs the Jobo API key in this server's `Authorization: Bearer` header; a sandbox key (jbe_test_…) cannot use it. Free: rate limited, never billed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"facet"
],
"properties": {
"q": {
"type": "string",
"description": "For occupations, words of the role name ('nurse', 'backend developer'). For the other facets, the start of a value ('pyth', 'soft'). Leave out for the most common values."
},
"facet": {
"enum": [
"sources",
"skills",
"industries",
"company_categories",
"job_categories",
"job_subcategories",
"occupations"
],
"type": "string",
"description": "Which filter's values to list."
},
"limit": {
"type": "integer",
"maximum": 250,
"minimum": 1,
"description": "Most values to return, 1–250 (default 25)."
}
}
},
"annotations": {
"title": "Find filter values",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check how a place name resolves before you put it in a request. Returns the places whose name starts with `q` (2+ characters), with city, region and country exactly as the job index stores them, the string the search `location` filter takes for each, and the `{ country, region, city }` object the feed (`POST /api/jobs/feed`) takes in `locations`. This is the free place lookup, not the billed geocoder (`GET /api/locations/geocode`), which this server never calls. Needs the Jobo API key in this server's `Authorization: Bearer` header; a sandbox key (jbe_test_…) cannot use it. Free: rate limited, never billed.
| Parameter | Type | Description |
|---|---|---|
| q * | string | Start of a place name, e.g. 'berlin', 'san fran', 'texas'. |
| limit | integer | Most places to return, 1–10 (default 5). |
{
"name": "find_locations",
"title": "Check a place name",
"description": "Check how a place name resolves before you put it in a request. Returns the places whose name starts with `q` (2+ characters), with city, region and country exactly as the job index stores them, the string the search `location` filter takes for each, and the `{ country, region, city }` object the feed (`POST /api/jobs/feed`) takes in `locations`. This is the free place lookup, not the billed geocoder (`GET /api/locations/geocode`), which this server never calls. Needs the Jobo API key in this server's `Authorization: Bearer` header; a sandbox key (jbe_test_…) cannot use it. Free: rate limited, never billed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"minLength": 2,
"description": "Start of a place name, e.g. 'berlin', 'san fran', 'texas'."
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Most places to return, 1–10 (default 5)."
}
}
},
"annotations": {
"title": "Check a place name",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The fixed vocabularies of the Jobo jobs API: work models, employment types, experience levels, company categories, languages (ISO 639-1), sort orders, description formats and `include_fields`, plus the feed's company size and revenue bands. Use them for enums, constants and validation in the code you write. Values are lowercase and canonical: send them verbatim. Jobs come back with display-cased values (`Remote`, `Full-time`), which are not valid filter input. No API key and no network call: it answers from the filter contract this server ships with. For open vocabularies (companies, skills, industries, occupations, sources, places) use the `find_` tools.
No parameters.
{
"name": "list_filters",
"title": "List fixed filter values",
"description": "The fixed vocabularies of the Jobo jobs API: work models, employment types, experience levels, company categories, languages (ISO 639-1), sort orders, description formats and `include_fields`, plus the feed's company size and revenue bands. Use them for enums, constants and validation in the code you write. Values are lowercase and canonical: send them verbatim. Jobs come back with display-cased values (`Remote`, `Full-time`), which are not valid filter input. No API key and no network call: it answers from the filter contract this server ships with. For open vocabularies (companies, skills, industries, occupations, sources, places) use the `find_` tools.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List fixed filter values",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}The whole job-search filter contract, one entry per filter: its name, type, the values it accepts or the lookup tool that supplies them, its `exclude_` twin, where it goes in the `POST /api/jobs/search` JSON body with an example fragment, and the matching `jobo` CLI flag. Read it before writing request-building code or types: several filters are spelled differently in the body (`work_model` is `work_models`, `q` is `queries`), and include/exclude filters are nested objects, where a flat `skills_exclude` key is ignored without an error. No API key and no network call: it answers from the filter contract this server ships with.
No parameters.
{
"name": "describe_search_filters",
"title": "Describe the search filters",
"description": "The whole job-search filter contract, one entry per filter: its name, type, the values it accepts or the lookup tool that supplies them, its `exclude_` twin, where it goes in the `POST /api/jobs/search` JSON body with an example fragment, and the matching `jobo` CLI flag. Read it before writing request-building code or types: several filters are spelled differently in the body (`work_model` is `work_models`, `q` is `queries`), and include/exclude filters are nested objects, where a flat `skills_exclude` key is ignored without an error. No API key and no network call: it answers from the filter contract this server ships with.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Describe the search filters",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Check a set of search filters against the contract and return the exact request for them: method, URL, headers and JSON body for `POST /api/jobs/search`, a ready-to-run `curl` command and the equivalent `jobo` CLI command. It does not send the request: no network call, no key, no cost. Sending the request it returns is billed per job returned, and `page_size` is the most one call can bill. Parameters are the contract's filter names, not the body's field names: pass `work_model`, not `work_models`. An unknown name, a wrong type or a value outside a fixed vocabulary is reported with the nearest valid one, and no request is built. Values of open vocabularies cannot be checked offline; the result names the lookup tool to confirm each with.
| Parameter | Type | Description |
|---|---|---|
| q | string | Free-text query matched against job title and, unless disabled, description. Wrap a phrase in double quotes for an exact title match; prefix a term with "-" to exclude it. Body field: `queries`. |
| page | integer | 1-based page number. Default 1. |
| sort | string | relevance (default), discovered_asc or discovered_desc. The discovered orders key on the first-indexed time and keep pages stable. One of: relevance, discovered_asc, discovered_desc. Body field: `sort`. |
| skills | any | Require one or more skills, e.g. Python, Kubernetes. Look values up with `find_filter_values` (facet skills). An array; one string is one value. Body field: `skills.include`. |
| sources | any | Restrict to specific ATS sources, e.g. greenhouse, lever_co, ashby. Look values up with `find_filter_values` (facet sources). An array; one string is one value. Body field: `sources`. |
| language | any | Description language, as ISO 639-1 codes ("en", "de"). Names and locales are mapped server-side. An array; one string is one value. Body field: `languages`. |
| location | any | Free-form location, e.g. "Berlin, Germany" or "Remote". Look values up with `find_locations`. A string, or an array for several places. Body field: `locations`. |
| companies | any | Only jobs at these companies. Each value is a Jobo company id (GUID), a website domain ("stripe.com") or a whole company name ("Stripe"); ids are exact, names also match every other company of that name. Look values up with `find_companies`. An array; one string is one value. Body field: `companies.… |
| page_size | integer | Jobs per page, 1–100 (API default 25). The most the request can bill: every job returned is billed. |
| industries | any | Restrict to companies in specific industries. Look values up with `find_filter_values` (facet industries). An array; one string is one value. Body field: `industries.include`. |
| work_model | any | Remote, hybrid or onsite. One of: remote, hybrid, onsite. An array; one string is one value. Body field: `work_models`. |
| posted_after | string | Only jobs posted by the employer on or after this timestamp. ISO 8601. Body field: `posted_after`. |
| posted_before | string | Only jobs posted by the employer on or before this timestamp. ISO 8601. Body field: `posted_before`. |
| exclude_skills | any | Leave out jobs asking for any of these skills. Look values up with `find_filter_values` (facet skills). An array; one string is one value. Body field: `skills.exclude`. |
| include_facets | array | Facet counts to return alongside the jobs. Omitted: the API's default set (work_model, experience_level, employment_type, sources). An empty array: none. It is a list of facet names, not a boolean. Values: work_model, experience_level, employment_type, sources, industries, skills, countries, company… |
| include_fields | array | Heavy job fields to return. Omitted: all of them. An empty array: the core fields only, which keeps responses small. The price is the same either way. Values: description, summary, qualifications, responsibilities, benefits. |
| job_categories | any | Occupation category names, e.g. "Healthcare" (GET /api/occupations lists them). Case-insensitive. Look values up with `find_filter_values` (facet job_categories). An array; one string is one value. Body field: `job_categories.include`. |
| max_salary_usd | integer | Only jobs whose advertised compensation is at or below this ceiling. Body field: `salary_usd.max`. |
| min_salary_usd | integer | Only jobs whose advertised compensation meets this floor. Body field: `salary_usd.min`. |
| occupation_ids | any | Occupation ids, e.g. "esco:8d3e8aaa-791b-4c75-a465-f3f827028f50" or "jobo:backend-developer". Ids, not names: names can change. Look values up with `find_filter_values` (facet occupations). An array; one string is one value. Body field: `occupation_ids.include`. |
| employment_type | any | Full-time, part-time, contract, internship, freelance or temporary. One of: full-time, part-time, contract, internship, freelance, temporary. An array; one string is one value. Body field: `employment_types`. |
| discovered_after | string | Only jobs Jobo first indexed on or after this timestamp. This is the field polling triggers advance; prefer it over posted_after for incremental sync. ISO 8601. Body field: `discovered_after`. |
| experience_level | any | Intern through executive. One of: intern, entry, mid, senior, lead, executive. An array; one string is one value. Body field: `experience_levels`. |
| discovered_before | string | Only jobs Jobo first indexed on or before this timestamp. ISO 8601. Body field: `discovered_before`. |
| exclude_companies | any | Leave out jobs at these companies (ids, domains or whole names, as for companies). Look values up with `find_companies`. An array; one string is one value. Body field: `companies.exclude`. |
| job_subcategories | any | Occupation subcategory names, e.g. "Nursing". Case-insensitive. Look values up with `find_filter_values` (facet job_subcategories). An array; one string is one value. Body field: `job_subcategories.include`. |
| company_categories | any | Hiring company's business model, e.g. b2b, saas, marketplace. Known values: b2b, b2c, b2b2c, b2g, saas, marketplace, e-commerce, service-provider, hardware, agency, nonprofit, government, education. Look values up with `find_filter_values` (facet company_categories). An array; one string is one valu… |
| description_format | string | markdown (default, as stored), html, or the enhanced description (beta) as enhanced or enhanced_html. One of: markdown, html, enhanced, enhanced_html. Body field: `description_format`. |
| exclude_industries | any | Leave out companies in any of these industries. Look values up with `find_filter_values` (facet industries). An array; one string is one value. Body field: `industries.exclude`. |
| search_description | boolean | Match the query against full descriptions as well as titles. Defaults to true. Body field: `search_description`. |
| exclude_job_categories | any | Leave out jobs in these occupation categories. Look values up with `find_filter_values` (facet job_categories). An array; one string is one value. Body field: `job_categories.exclude`. |
| exclude_occupation_ids | any | Leave out jobs with these occupation ids. Look values up with `find_filter_values` (facet occupations). An array; one string is one value. Body field: `occupation_ids.exclude`. |
| exclude_job_subcategories | any | Leave out jobs in these occupation subcategories. Look values up with `find_filter_values` (facet job_subcategories). An array; one string is one value. Body field: `job_subcategories.exclude`. |
| exclude_company_categories | any | Leave out companies with any of these business models, e.g. agency. Known values: b2b, b2c, b2b2c, b2g, saas, marketplace, e-commerce, service-provider, hardware, agency, nonprofit, government, education. Look values up with `find_filter_values` (facet company_categories). An array; one string is on… |
{
"name": "build_search_request",
"title": "Build a search request",
"description": "Check a set of search filters against the contract and return the exact request for them: method, URL, headers and JSON body for `POST /api/jobs/search`, a ready-to-run `curl` command and the equivalent `jobo` CLI command. It does not send the request: no network call, no key, no cost. Sending the request it returns is billed per job returned, and `page_size` is the most one call can bill. Parameters are the contract's filter names, not the body's field names: pass `work_model`, not `work_models`. An unknown name, a wrong type or a value outside a fixed vocabulary is reported with the nearest valid one, and no request is built. Values of open vocabularies cannot be checked offline; the result names the lookup tool to confirm each with.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"q": {
"type": "string",
"description": "Free-text query matched against job title and, unless disabled, description. Wrap a phrase in double quotes for an exact title match; prefix a term with \"-\" to exclude it. Body field: `queries`."
},
"page": {
"type": "integer",
"description": "1-based page number. Default 1."
},
"sort": {
"type": "string",
"description": "relevance (default), discovered_asc or discovered_desc. The discovered orders key on the first-indexed time and keep pages stable. One of: relevance, discovered_asc, discovered_desc. Body field: `sort`."
},
"skills": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Require one or more skills, e.g. Python, Kubernetes. Look values up with `find_filter_values` (facet skills). An array; one string is one value. Body field: `skills.include`."
},
"sources": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Restrict to specific ATS sources, e.g. greenhouse, lever_co, ashby. Look values up with `find_filter_values` (facet sources). An array; one string is one value. Body field: `sources`."
},
"language": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Description language, as ISO 639-1 codes (\"en\", \"de\"). Names and locales are mapped server-side. An array; one string is one value. Body field: `languages`."
},
"location": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Free-form location, e.g. \"Berlin, Germany\" or \"Remote\". Look values up with `find_locations`. A string, or an array for several places. Body field: `locations`."
},
"companies": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Only jobs at these companies. Each value is a Jobo company id (GUID), a website domain (\"stripe.com\") or a whole company name (\"Stripe\"); ids are exact, names also match every other company of that name. Look values up with `find_companies`. An array; one string is one value. Body field: `companies.include`."
},
"page_size": {
"type": "integer",
"description": "Jobs per page, 1–100 (API default 25). The most the request can bill: every job returned is billed."
},
"industries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Restrict to companies in specific industries. Look values up with `find_filter_values` (facet industries). An array; one string is one value. Body field: `industries.include`."
},
"work_model": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Remote, hybrid or onsite. One of: remote, hybrid, onsite. An array; one string is one value. Body field: `work_models`."
},
"posted_after": {
"type": "string",
"description": "Only jobs posted by the employer on or after this timestamp. ISO 8601. Body field: `posted_after`."
},
"posted_before": {
"type": "string",
"description": "Only jobs posted by the employer on or before this timestamp. ISO 8601. Body field: `posted_before`."
},
"exclude_skills": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out jobs asking for any of these skills. Look values up with `find_filter_values` (facet skills). An array; one string is one value. Body field: `skills.exclude`."
},
"include_facets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Facet counts to return alongside the jobs. Omitted: the API's default set (work_model, experience_level, employment_type, sources). An empty array: none. It is a list of facet names, not a boolean. Values: work_model, experience_level, employment_type, sources, industries, skills, countries, company_categories, job_categories, job_subcategories, occupations."
},
"include_fields": {
"type": "array",
"items": {
"type": "string"
},
"description": "Heavy job fields to return. Omitted: all of them. An empty array: the core fields only, which keeps responses small. The price is the same either way. Values: description, summary, qualifications, responsibilities, benefits."
},
"job_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Occupation category names, e.g. \"Healthcare\" (GET /api/occupations lists them). Case-insensitive. Look values up with `find_filter_values` (facet job_categories). An array; one string is one value. Body field: `job_categories.include`."
},
"max_salary_usd": {
"type": "integer",
"description": "Only jobs whose advertised compensation is at or below this ceiling. Body field: `salary_usd.max`."
},
"min_salary_usd": {
"type": "integer",
"description": "Only jobs whose advertised compensation meets this floor. Body field: `salary_usd.min`."
},
"occupation_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Occupation ids, e.g. \"esco:8d3e8aaa-791b-4c75-a465-f3f827028f50\" or \"jobo:backend-developer\". Ids, not names: names can change. Look values up with `find_filter_values` (facet occupations). An array; one string is one value. Body field: `occupation_ids.include`."
},
"employment_type": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Full-time, part-time, contract, internship, freelance or temporary. One of: full-time, part-time, contract, internship, freelance, temporary. An array; one string is one value. Body field: `employment_types`."
},
"discovered_after": {
"type": "string",
"description": "Only jobs Jobo first indexed on or after this timestamp. This is the field polling triggers advance; prefer it over posted_after for incremental sync. ISO 8601. Body field: `discovered_after`."
},
"experience_level": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Intern through executive. One of: intern, entry, mid, senior, lead, executive. An array; one string is one value. Body field: `experience_levels`."
},
"discovered_before": {
"type": "string",
"description": "Only jobs Jobo first indexed on or before this timestamp. ISO 8601. Body field: `discovered_before`."
},
"exclude_companies": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out jobs at these companies (ids, domains or whole names, as for companies). Look values up with `find_companies`. An array; one string is one value. Body field: `companies.exclude`."
},
"job_subcategories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Occupation subcategory names, e.g. \"Nursing\". Case-insensitive. Look values up with `find_filter_values` (facet job_subcategories). An array; one string is one value. Body field: `job_subcategories.include`."
},
"company_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Hiring company's business model, e.g. b2b, saas, marketplace. Known values: b2b, b2c, b2b2c, b2g, saas, marketplace, e-commerce, service-provider, hardware, agency, nonprofit, government, education. Look values up with `find_filter_values` (facet company_categories). An array; one string is one value. Body field: `company_categories.include`."
},
"description_format": {
"type": "string",
"description": "markdown (default, as stored), html, or the enhanced description (beta) as enhanced or enhanced_html. One of: markdown, html, enhanced, enhanced_html. Body field: `description_format`."
},
"exclude_industries": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out companies in any of these industries. Look values up with `find_filter_values` (facet industries). An array; one string is one value. Body field: `industries.exclude`."
},
"search_description": {
"type": "boolean",
"description": "Match the query against full descriptions as well as titles. Defaults to true. Body field: `search_description`."
},
"exclude_job_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out jobs in these occupation categories. Look values up with `find_filter_values` (facet job_categories). An array; one string is one value. Body field: `job_categories.exclude`."
},
"exclude_occupation_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out jobs with these occupation ids. Look values up with `find_filter_values` (facet occupations). An array; one string is one value. Body field: `occupation_ids.exclude`."
},
"exclude_job_subcategories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out jobs in these occupation subcategories. Look values up with `find_filter_values` (facet job_subcategories). An array; one string is one value. Body field: `job_subcategories.exclude`."
},
"exclude_company_categories": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
],
"description": "Leave out companies with any of these business models, e.g. agency. Known values: b2b, b2c, b2b2c, b2g, saas, marketplace, e-commerce, service-provider, hardware, agency, nonprofit, government, education. Look values up with `find_filter_values` (facet company_categories). An array; one string is one value. Body field: `company_categories.exclude`."
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Build a search request",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Jobo developer tools: reference lookups for writing code against the Jobo REST API (https://connect.jobo.world, API key in the `X-Api-Key` header), a live index of open jobs collected from employer career sites and 200+ applicant tracking systems. Use this server while building an integration. It does not search jobs: the code you write does that, with `POST /api/jobs/search` or the `jobo` CLI. The separate Jobo job-search MCP server (https://jobs-mcp.jobo.world/mcp) is for assistants answering questions about jobs. How to use it: `describe_search_filters` gives the filter contract (names, types, where each goes in the request body). `list_filters` gives the fixed vocabularies. `find_companies`, `find_filter_values` and `find_locations` turn a name into the id or exact value a filter takes. `build_search_request` checks a set of filters and returns the request body, a curl command and a `jobo` CLI command. Filter values are matched exactly, and a value the index does not hold returns zero jobs rather than an error, so look values up instead of guessing them. What costs money: nothing on this server. In the code you write: Job search (`GET /api/jobs`, `POST /api/jobs/search`) is billed per job returned: $3.00 per 1,000 jobs (3 credits each) after the plan's included jobs; an empty page is free. The feed (`POST /api/jobs/feed`) is billed at the same rate per job that is new to the account. Geocoding (`GET /api/locations/geocode`) is $0.001 per lookup. Lookups by id and the filter, company, location and occupation lookups are free. See https://jobo.world/docs/billing. `build_search_request` never sends the request. Do not run the curl or CLI command it returns unless the user wants the search run, and keep `page_size` small while testing; a sandbox key (jbe_test_…) runs search against fictional jobs at no charge. The key: the three `find_` tools call the Jobo API with the developer's own API key, sent by the MCP client as `Authorization: Bearer <key>` in this server's config. The other three need no key. Keys are created at https://enterprise.jobo.world/api-keys. Never write a key into source files: read it from the `JOBO_API_KEY` environment variable.
Names, descriptions and schemas were written by the server and are shown as data.