Look up Jobo company ids, occupations and filter values while you build on the Jobo jobs API.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Your Jobo API key, as a Bearer token. Needed by the three lookup tools (find_companies, find_filter_values, find_locations); the other tools work without it. Create a key at https://enterprise.jobo.world/api-keys.
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.
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.
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`.
1-based page number. Default 1.
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`.
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`.
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`.
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`.
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`.
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`.
Jobs per page, 1–100 (API default 25). The most the request can bill: every job returned is billed.
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`.
Remote, hybrid or onsite. One of: remote, hybrid, onsite. An array; one string is one value. Body field: `work_models`.
Only jobs posted by the employer on or after this timestamp. ISO 8601. Body field: `posted_after`.
Only jobs posted by the employer on or before this timestamp. ISO 8601. Body field: `posted_before`.
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`.
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.
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.
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`.
Only jobs whose advertised compensation is at or below this ceiling. Body field: `salary_usd.max`.
Only jobs whose advertised compensation meets this floor. Body field: `salary_usd.min`.
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`.
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`.
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`.
Intern through executive. One of: intern, entry, mid, senior, lead, executive. An array; one string is one value. Body field: `experience_levels`.
Only jobs Jobo first indexed on or before this timestamp. ISO 8601. Body field: `discovered_before`.
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`.
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`.
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`.
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`.
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`.
Match the query against full descriptions as well as titles. Defaults to true. Body field: `search_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`.
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`.
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`.
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`.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http developer https://dev-mcp.jobo.world/mcp
Headers
Authorization (optional, not in the config above): Your Jobo API key, as a Bearer token. Needed by the three lookup tools (find_companies, find_filter_values, find_locations); the other tools work without it. Create a key at https://enterprise.jobo.world/api-keys.jobo-developer-mcpCheck 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.
| Argument | 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.include`. |
| 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_categories, job_categories, job_subcategories, occupations. |
| 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 value. Body field: `company_categories.include`. |
| 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 one value. Body field: `company_categories.exclude`. |
{
"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": {}
}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 arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}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.
| Argument | 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). |
{
"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)."
}
}
}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.
| Argument | 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). |
{
"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)."
}
}
}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.
| Argument | 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). |
{
"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)."
}
}
}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 arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}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 22, 2026.