Active Jobs Db MCP Server
Allows filtering job listings by source to include only jobs posted through ADP's applicant tracking system.
Allows filtering job listings by source to include only jobs posted through Greenhouse's applicant tracking system.
Allows filtering job listings by source to include only jobs posted through Personio's applicant tracking system.
Allows filtering job listings by source to include only jobs posted through Zoho's applicant tracking system.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Active Jobs Db MCP Serverfind machine learning jobs in New York"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Active Jobs Db MCP Server
🚀 使用 EMCP 平台快速体验
EMCP 是一个强大的 MCP 服务器管理平台,让您无需手动配置即可快速使用各种 MCP 服务器!
快速开始:
🌐 访问 EMCP 平台
📝 注册并登录账号
🎯 进入 MCP 广场,浏览所有可用的 MCP 服务器
🔍 搜索或找到本服务器(
bach-active_jobs_db)🎉 点击 "安装 MCP" 按钮
✅ 完成!即可在您的应用中使用
EMCP 平台优势:
✨ 零配置:无需手动编辑配置文件
🎨 可视化管理:图形界面轻松管理所有 MCP 服务器
🔐 安全可靠:统一管理 API 密钥和认证信息
🚀 一键安装:MCP 广场提供丰富的服务器选择
📊 使用统计:实时查看服务调用情况
立即访问 EMCP 平台 开始您的 MCP 之旅!
Related MCP server: JobSpy MCP Server
简介
这是一个 MCP 服务器,用于访问 Active Jobs Db API。
PyPI 包名:
bach-active_jobs_db版本: 2.0.0
传输协议: stdio
安装
从 PyPI 安装:
pip install bach-active_jobs_db从源码安装:
pip install -e .运行
方式 1: 使用 uvx(推荐,无需安装)
# 运行(uvx 会自动安装并运行)
uvx --from bach-active_jobs_db bach_active_jobs_db
# 或指定版本
uvx --from bach-active_jobs_db@latest bach_active_jobs_db方式 2: 直接运行(开发模式)
python server.py方式 3: 安装后作为命令运行
# 安装
pip install bach-active_jobs_db
# 运行(命令名使用下划线)
bach_active_jobs_db配置
API 认证
此 API 需要认证。请设置环境变量:
export API_KEY="your_api_key_here"环境变量
变量名 | 说明 | 必需 |
| API 密钥 | 是 |
| 不适用 | 否 |
| 不适用 | 否 |
在 Claude Desktop 中使用
编辑 Claude Desktop 配置文件 claude_desktop_config.json:
{
"mcpServers": {
"active_jobs_db": {
"command": "uvx",
"args": ["--from", "bach-active_jobs_db", "bach_active_jobs_db"],
"env": {
"API_KEY": "your_api_key_here"
}
}
}
}注意: 请将 E:\path\to\active_jobs_db\server.py 替换为实际的服务器文件路径。
可用工具
此服务器提供以下工具:
get_jobs_7_days
Search and retrieve jobs on title, description, location, remote, and organization. Optionally add a text or html description
端点: GET /active-ats-7d
参数:
limit(string): You can limit the number of jobs per API call between 10 and 100. If left blank, the default value is 100 Use the offset parameter to receive the next batch of jobsoffset(string): Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with limit=100 and offset= 0, 100, and 200. With a limit of 10, you can fetch 30 jobs using 3 requests with offset= 0, 10, and 20title_filter(string): Search on the job title. You can search like you search on Google, see the documentation for more info.advanced_title_filter(string): Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & !location_filter(string): Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgiumdescription_filter(string): Filter on the job description. You can search like you search on Google, see the documentation for more info.advanced_description_filter(string): Uses the same syntax as advanced_title_filterorganization_filter(string): Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this APIorganization_exclusion_filter(string): Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionalitydescription_type(string): Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html'remote(string): Example value:source(string): You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search osource_exclusion(string): You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhousedate_filter(string): ou can use this filter to return only the most recent jobs, instead of all jobs from the last 7 days. This filter is a greater than filter. For example, if today's date is 2025-01-03 and you wish to only return jobs posted in 2025, you can filter on '2025-01-01'. To include time, use the following syntax: '2025-01-01T14:00:00' Please keep in mind that the jobs posted date/time is UTC and there's a 1 to 2 hour delay before jobs appear on this API.advanced_organization_filter(string): Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will retinclude_ai(string): Example value:ai_employment_type_filter(string): BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIMEai_taxonomies_a_filter(string): Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Designai_taxonomies_a_primary_filter(string): Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_taxonomies_a_exclusion_filter(string): Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_work_arrangement_filter(string): BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such:ai_has_salary(string): Example value:ai_experience_level_filter(string): BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5ai_visa_sponsorship_filter(string): Example value:include_li(string): Example value:li_organization_slug_filter(string): Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companiesli_organization_slug_exclusion_filter(string): Similar to the slug filter, but it removes companies from the results.li_industry_filter(string): BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industriesli_organization_specialties_filter(string): BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profileli_organization_description_filter(string): Filter on the company's description, with the same syntax as our job search filtersli_organization_employees_lte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200li_organization_employees_gte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200ai_education_requirements_filter(string): Please contact us before using
ultra___get_modified_jobs_24h
Search and retrieve jobs modified during the last 24h. Run this API at the same time every day to get newly modified jobs without any duplicates
端点: GET /modified-ats-24h
参数:
limit(string): You can limit the number of jobs per API call between 10 and 100. If left blank, the default value is 100 Use the offset parameter to receive the next batch of jobsoffset(string): Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with limit=100 and offset= 0, 100, and 200. With a limit of 10, you can fetch 30 jobs using 3 requests with offset= 0, 10, and 20title_filter(string): Search on the job title. You can search like you search on Google, see the documentation for more info.advanced_title_filter(string): Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & !location_filter(string): Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgiumdescription_filter(string): Filter on the job description. You can search like you search on Google, see the documentation for more info.advanced_description_filter(string): Uses the same syntax as advanced_title_filterorganization_filter(string): Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this APIorganization_exclusion_filter(string): Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionalitydescription_type(string): Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html'remote(string): Example value:source(string): Filter on source. Your options are: adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search on more than one sourcewith a comma delimited list wsource_exclusion(string): Example value:advanced_organization_filter(string): Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will retinclude_ai(string): Example value:ai_employment_type_filter(string): BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIMEai_work_arrangement_filter(string): BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such:ai_taxonomies_a_filter(string): Example value:ai_taxonomies_a_primary_filter(string): Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_taxonomies_a_exclusion_filter(string): Example value:ai_has_salary(string): Example value:ai_experience_level_filter(string): BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5ai_visa_sponsorship_filter(string): Example value:include_li(string): Example value:li_organization_slug_filter(string): Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companiesli_organization_slug_exclusion_filter(string): Similar to the slug filter, but it removes companies from the results.li_industry_filter(string): BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industriesli_organization_specialties_filter(string): BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profileli_organization_description_filter(string): Filter on the company's description, with the same syntax as our job search filtersli_organization_employees_lte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200ai_education_requirements_filter(string): Example value:
ultra____get_jobs_hourly
Firehose API, includes jobs we discovered in the last hour. Perfect for one or more hourly API calls. Requires Ultra or Mega subscription
端点: GET /active-ats-1h
参数:
offset(string): Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with offset 0, 100, and 200.title_filter(string): Search on the job title. You can search like you search on Google, see the documentation for more info.advanced_title_filter(string): Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & !location_filter(string): Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgiumdescription_filter(string): Filter on the job description. You can search like you search on Google, see the documentation for more info.advanced_description_filter(string): Uses the same syntax as advanced_title_filterorganization_filter(string): Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this APIorganization_exclusion_filter(string): Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionalitydescription_type(string): Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html'remote(string): Example value:source(string): You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search osource_exclusion(string): You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhouseadvanced_organization_filter(string): Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will retinclude_ai(string): Example value:ai_employment_type_filter(string): BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIMEai_work_arrangement_filter(string): BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such:ai_taxonomies_a_filter(string): Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Designai_taxonomies_a_primary_filter(string): Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_taxonomies_a_exclusion_filter(string): Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_has_salary(string): Example value:ai_experience_level_filter(string): BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5ai_visa_sponsorship_filter(string): Example value:include_li(string): Example value:li_organization_slug_filter(string): Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companiesli_organization_slug_exclusion_filter(string): Similar to the slug filter, but it removes companies from the results.li_industry_filter(string): BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industriesli_organization_specialties_filter(string): BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profileli_organization_description_filter(string): Filter on the company's description, with the same syntax as our job search filtersli_organization_employees_lte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200li_organization_employees_gte(string): Use this to filter on jobs from companies greater than a certain number of employees. Can be used in combination with li_organization_employees_lte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200ai_education_requirements_filter(string): Please contact us before using
ultra___get_jobs_backfill___6m
You can use this endpoint to backfill your job application before moving on to the 7d, 24h, or hourly endpoint
端点: GET /active-ats-6m
参数:
limit(string): Warning, this endpoint is for backfill purposes and goes up to 500 jobs per API call. These jobs count towards your job credits You can limit the number of jobs per API call between 10 and 500. If left blank, the default value is 500 Use the offset parameter to receive the next batch of jobsoffset(string): Offset allows you to paginate results. For example, if you want to retrieve 1500 jobs from our api you can send 3 requests with limit=500 and offset= 0, 500, and 1000.title_filter(string): Search on the job title. You can search like you search on Google, see the documentation for more info.advanced_title_filter(string): Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & !location_filter(string): Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgiumdescription_filter(string): Filter on the job description. You can search like you search on Google, see the documentation for more info. Warning, for the 6 month endpoint, only use the description filter for very specific searches, or to narrow down after having applied other filters. There's a risk of timeouts when searching on very common words and sentences. Be as specific as possible when using description_filter.advanced_description_filter(string): Uses the same syntax as advanced_title_filter Warning, for the 6 month endpoint, only use the description filter for very specific searches, or to narrow down after having applied other filters. There's a risk of timeouts when searching on very common words and sentences. Be as specific as possible when using description_filter.organization_filter(string): Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this APIorganization_exclusion_filter(string): Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionalitydescription_type(string): Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html'remote(string): Example value:source(string): You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search osource_exclusion(string): You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhouseadvanced_organization_filter(string): Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will retinclude_ai(string): Example value:ai_employment_type_filter(string): BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIMEai_work_arrangement_filter(string): BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such:ai_has_salary(string): Example value:ai_taxonomies_a_filter(string): Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Designai_taxonomies_a_primary_filter(string): Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_taxonomies_a_exclusion_filter(string): Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_experience_level_filter(string): BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5ai_visa_sponsorship_filter(string): Example value:include_li(string): Example value:li_organization_slug_filter(string): Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companiesli_organization_slug_exclusion_filter(string): Similar to the slug filter, but it removes companies from the results.li_industry_filter(string): BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industriesli_organization_specialties_filter(string): BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profileli_organization_description_filter(string): Filter on the company's description, with the same syntax as our job search filtersli_organization_employees_lte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200
get_jobs_24h
Search and retrieve jobs on title, description, location, remote, and organization. Optionally add a text or html description. The jobs in this API have been indexed by us during the last 24 hours.
端点: GET /active-ats-24h
参数:
limit(string): You can limit the number of jobs per API call between 10 and 100. If left blank, the default value is 100 Use the offset parameter to receive the next batch of jobsoffset(string): Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with limit=100 and offset= 0, 100, and 200. With a limit of 10, you can fetch 30 jobs using 3 requests with offset= 0, 10, and 20title_filter(string): Search on the job title. You can search like you search on Google, see the documentation for more info.advanced_title_filter(string): Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & !location_filter(string): Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgiumdescription_filter(string): Filter on the job description. You can search like you search on Google, see the documentation for more info.advanced_description_filter(string): Uses the same syntax as advanced_title_filterorganization_filter(string): Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this APIorganization_exclusion_filter(string): Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionalitydescription_type(string): Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html'remote(string): Example value:source(string): You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search osource_exclusion(string): You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhousedate_filter(string): ou can use this filter to return only the most recent jobs, instead of all jobs from the last 7 days. This filter is a greater than filter. For example, if today's date is 2025-01-03 and you wish to only return jobs posted in 2025, you can filter on '2025-01-01'. To include time, use the following syntax: '2025-01-01T14:00:00' Please keep in mind that the jobs posted date/time is UTC and there's a 1 to 2 hour delay before jobs appear on this API.advanced_organization_filter(string): Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will retinclude_ai(string): Example value:ai_employment_type_filter(string): BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIMEai_work_arrangement_filter(string): BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such:ai_taxonomies_a_filter(string): Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Designai_taxonomies_a_primary_filter(string): Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_taxonomies_a_exclusion_filter(string): Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quoteai_has_salary(string): Example value:ai_experience_level_filter(string): BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5ai_visa_sponsorship_filter(string): Example value:include_li(string): Example value:li_organization_slug_filter(string): Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companiesli_organization_slug_exclusion_filter(string): Similar to the slug filter, but it removes companies from the results.li_industry_filter(string): BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industriesli_organization_specialties_filter(string): BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profileli_organization_description_filter(string): Filter on the company's description, with the same syntax as our job search filtersli_organization_employees_lte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200li_organization_employees_gte(string): Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200ai_education_requirements_filter(string): Please contact us before using
ultra___get_expired_jobs
Contains IDs of jobs that were flagged as expired yesterday. Updates once per day at 01:30 UTC. Requires Ultra or Mega subscription
端点: GET /active-ats-expired
技术栈
传输协议: stdio
HTTP 客户端: httpx
开发
此服务器由 API-to-MCP 工具自动生成。
版本: 2.0.0
Available Tools
6 toolsget_jobs_24hB
Search and retrieve jobs on title, description, location, remote, and organization. Optionally add a text or html description. The jobs in this API have been indexed by us during the last 24 hours.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | You can limit the number of jobs per API call between 10 and 100. If left blank, the default value is 100 Use the offset parameter to receive the next batch of jobs | |
| offset | No | Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with limit=100 and offset= 0, 100, and 200. With a limit of 10, you can fetch 30 jobs using 3 requests with offset= 0, 10, and 20 | |
| remote | No | Example value: | |
| source | No | You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search o | |
| include_ai | No | Example value: | |
| include_li | No | Example value: | |
| date_filter | No | ou can use this filter to return only the most recent jobs, instead of all jobs from the last 7 days. This filter is a greater than filter. For example, if today's date is 2025-01-03 and you wish to only return jobs posted in 2025, you can filter on '2025-01-01'. To include time, use the following syntax: '2025-01-01T14:00:00' Please keep in mind that the jobs posted date/time is UTC and there's a 1 to 2 hour delay before jobs appear on this API. | |
| title_filter | No | Search on the job title. You can search like you search on Google, see the documentation for more info. | |
| ai_has_salary | No | Example value: | |
| location_filter | No | Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgium | |
| description_type | No | Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html' | |
| source_exclusion | No | You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhouse | |
| description_filter | No | Filter on the job description. You can search like you search on Google, see the documentation for more info. | |
| li_industry_filter | No | BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industries | |
| organization_filter | No | Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this API | |
| advanced_title_filter | No | Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & ! | |
| ai_taxonomies_a_filter | No | Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Design | |
| ai_employment_type_filter | No | BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIME | |
| ai_experience_level_filter | No | BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5 | |
| ai_visa_sponsorship_filter | No | Example value: | |
| ai_work_arrangement_filter | No | BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such: | |
| advanced_description_filter | No | Uses the same syntax as advanced_title_filter | |
| li_organization_slug_filter | No | Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companies | |
| advanced_organization_filter | No | Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will ret | |
| li_organization_employees_gte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| li_organization_employees_lte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| organization_exclusion_filter | No | Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionality | |
| ai_taxonomies_a_primary_filter | No | Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| ai_education_requirements_filter | No | Please contact us before using | |
| ai_taxonomies_a_exclusion_filter | No | Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| li_organization_description_filter | No | Filter on the company's description, with the same syntax as our job search filters | |
| li_organization_specialties_filter | No | BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profile | |
| li_organization_slug_exclusion_filter | No | Similar to the slug filter, but it removes companies from the results. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description carries the full burden of behavioral disclosure. It only mentions the 24-hour indexing freshness. It does not disclose pagination behavior, default limits, response format, or rate limits. This is insufficient for a tool with no annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two short sentences, front-loaded with the action ('Search and retrieve'). No fluff. Every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with 33 parameters and no output schema, the description is minimal but not inadequate. It gives a high-level overview and time window, with the detailed parameter schema filling in the rest. However, it doesn't describe the return structure or provide examples, leaving some gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so baseline is 3. The description adds a hint about optional text/html descriptions and lists search fields, but the parameter descriptions are already comprehensive. No additional parameter semantics in the main description.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: 'Search and retrieve jobs on title, description, location, remote, and organization.' It also specifies the 24-hour indexing window, differentiating it from the 7-day sibling. However, it doesn't explicitly mention the breadth of available filters beyond the key fields.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies this tool is for jobs indexed in the last 24 hours, which is a usage context. However, it does not explicitly state when to prefer this over get_jobs_7_days or other siblings, nor does it provide exclusions or alternative recommendations.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_jobs_7_daysC
Search and retrieve jobs on title, description, location, remote, and organization. Optionally add a text or html description
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | You can limit the number of jobs per API call between 10 and 100. If left blank, the default value is 100 Use the offset parameter to receive the next batch of jobs | |
| offset | No | Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with limit=100 and offset= 0, 100, and 200. With a limit of 10, you can fetch 30 jobs using 3 requests with offset= 0, 10, and 20 | |
| remote | No | Example value: | |
| source | No | You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search o | |
| include_ai | No | Example value: | |
| include_li | No | Example value: | |
| date_filter | No | ou can use this filter to return only the most recent jobs, instead of all jobs from the last 7 days. This filter is a greater than filter. For example, if today's date is 2025-01-03 and you wish to only return jobs posted in 2025, you can filter on '2025-01-01'. To include time, use the following syntax: '2025-01-01T14:00:00' Please keep in mind that the jobs posted date/time is UTC and there's a 1 to 2 hour delay before jobs appear on this API. | |
| title_filter | No | Search on the job title. You can search like you search on Google, see the documentation for more info. | |
| ai_has_salary | No | Example value: | |
| location_filter | No | Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgium | |
| description_type | No | Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html' | |
| source_exclusion | No | You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhouse | |
| description_filter | No | Filter on the job description. You can search like you search on Google, see the documentation for more info. | |
| li_industry_filter | No | BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industries | |
| organization_filter | No | Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this API | |
| advanced_title_filter | No | Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & ! | |
| ai_taxonomies_a_filter | No | Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Design | |
| ai_employment_type_filter | No | BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIME | |
| ai_experience_level_filter | No | BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5 | |
| ai_visa_sponsorship_filter | No | Example value: | |
| ai_work_arrangement_filter | No | BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such: | |
| advanced_description_filter | No | Uses the same syntax as advanced_title_filter | |
| li_organization_slug_filter | No | Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companies | |
| advanced_organization_filter | No | Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will ret | |
| li_organization_employees_gte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| li_organization_employees_lte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| organization_exclusion_filter | No | Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionality | |
| ai_taxonomies_a_primary_filter | No | Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| ai_education_requirements_filter | No | Please contact us before using | |
| ai_taxonomies_a_exclusion_filter | No | Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| li_organization_description_filter | No | Filter on the company's description, with the same syntax as our job search filters | |
| li_organization_specialties_filter | No | BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profile | |
| li_organization_slug_exclusion_filter | No | Similar to the slug filter, but it removes companies from the results. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure, but it only says 'Search and retrieve jobs.' It does not disclose that results are limited to the last 7 days, the 1–2 hour ingestion delay noted in the date_filter parameter, or how results are returned (pagination, format).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single concise sentence with no filler, which is efficient. However, its brevity sacrifices critical context like the 7-day window, so it is not optimally front-loaded with the most distinguishing information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (33 parameters, no annotations, no output schema), the description is far too sparse. It omits the temporal scope, fails to disambiguate from neighboring tools, and does not mention the extensive filtering options or expected return value, leaving the schema to do all the heavy lifting.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% with detailed descriptions for all 33 parameters, so the baseline is 3. The description adds a bit of grouping by naming a few searchable fields and mentioning 'text or html description', but it does not go beyond what the schema already provides.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states a verb ('Search and retrieve') and resource ('jobs') and lists several searchable fields (title, description, location, remote, organization). However, it fails to mention the defining 'last 7 days' time scope, which is what distinguishes it from sibling get_jobs_24h, so it lacks explicit sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives like get_jobs_24h or the ultra variants. There are no exclusions, prerequisites, or context about the intended use case.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ultraB
Search and retrieve jobs modified during the last 24h. Run this API at the same time every day to get newly modified jobs without any duplicates
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | You can limit the number of jobs per API call between 10 and 100. If left blank, the default value is 100 Use the offset parameter to receive the next batch of jobs | |
| offset | No | Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with limit=100 and offset= 0, 100, and 200. With a limit of 10, you can fetch 30 jobs using 3 requests with offset= 0, 10, and 20 | |
| remote | No | Example value: | |
| source | No | Filter on source. Your options are: adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search on more than one sourcewith a comma delimited list w | |
| include_ai | No | Example value: | |
| include_li | No | Example value: | |
| title_filter | No | Search on the job title. You can search like you search on Google, see the documentation for more info. | |
| ai_has_salary | No | Example value: | |
| location_filter | No | Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgium | |
| description_type | No | Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html' | |
| source_exclusion | No | Example value: | |
| description_filter | No | Filter on the job description. You can search like you search on Google, see the documentation for more info. | |
| li_industry_filter | No | BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industries | |
| organization_filter | No | Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this API | |
| advanced_title_filter | No | Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & ! | |
| ai_taxonomies_a_filter | No | Example value: | |
| ai_employment_type_filter | No | BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIME | |
| ai_experience_level_filter | No | BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5 | |
| ai_visa_sponsorship_filter | No | Example value: | |
| ai_work_arrangement_filter | No | BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such: | |
| advanced_description_filter | No | Uses the same syntax as advanced_title_filter | |
| li_organization_slug_filter | No | Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companies | |
| advanced_organization_filter | No | Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will ret | |
| li_organization_employees_lte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| organization_exclusion_filter | No | Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionality | |
| ai_taxonomies_a_primary_filter | No | Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| ai_education_requirements_filter | No | Example value: | |
| ai_taxonomies_a_exclusion_filter | No | Example value: | |
| li_organization_description_filter | No | Filter on the company's description, with the same syntax as our job search filters | |
| li_organization_specialties_filter | No | BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profile | |
| li_organization_slug_exclusion_filter | No | Similar to the slug filter, but it removes companies from the results. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must carry the full burden of explaining behavior. It only mentions deduplication when run daily, but omits key details such as response format, pagination behavior, rate limits, and the exact meaning of 'modified'. For a 31-parameter tool, this is a significant gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is exactly two sentences, front-loaded with the core functionality and followed by a usage recommendation. There is no filler or redundancy, and every word earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 31 optional parameters, no output schema, and no annotations, the description is far too brief. It does not explain the rich filtering capabilities, response structure, or how this tool relates to ultra_2/ultra_3 siblings. This leaves an agent under-informed for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3. The tool description adds no parameter-specific guidance, and many schema entries are merely 'Example value: ' with little value. However, the description is not obliged to duplicate schema content.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action (search/retrieve), resource (jobs), and time scope (last 24h). However, it does not differentiate itself from siblings like get_jobs_24h or ultra_2, which likely have similar purposes.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides a specific usage pattern: run daily at the same time to get newly modified jobs without duplicates. This gives clear context for when to use the tool, but does not mention alternatives or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ultra_2A
Firehose API, includes jobs we discovered in the last hour. Perfect for one or more hourly API calls. Requires Ultra or Mega subscription
| Name | Required | Description | Default |
|---|---|---|---|
| offset | No | Offset allows you to paginate results. For example, if you want to retrieve 300 jobs from our api you can send 3 requests with offset 0, 100, and 200. | |
| remote | No | Example value: | |
| source | No | You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search o | |
| include_ai | No | Example value: | |
| include_li | No | Example value: | |
| title_filter | No | Search on the job title. You can search like you search on Google, see the documentation for more info. | |
| ai_has_salary | No | Example value: | |
| location_filter | No | Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgium | |
| description_type | No | Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html' | |
| source_exclusion | No | You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhouse | |
| description_filter | No | Filter on the job description. You can search like you search on Google, see the documentation for more info. | |
| li_industry_filter | No | BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industries | |
| organization_filter | No | Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this API | |
| advanced_title_filter | No | Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & ! | |
| ai_taxonomies_a_filter | No | Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Design | |
| ai_employment_type_filter | No | BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIME | |
| ai_experience_level_filter | No | BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5 | |
| ai_visa_sponsorship_filter | No | Example value: | |
| ai_work_arrangement_filter | No | BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such: | |
| advanced_description_filter | No | Uses the same syntax as advanced_title_filter | |
| li_organization_slug_filter | No | Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companies | |
| advanced_organization_filter | No | Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will ret | |
| li_organization_employees_gte | No | Use this to filter on jobs from companies greater than a certain number of employees. Can be used in combination with li_organization_employees_lte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| li_organization_employees_lte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| organization_exclusion_filter | No | Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionality | |
| ai_taxonomies_a_primary_filter | No | Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| ai_education_requirements_filter | No | Please contact us before using | |
| ai_taxonomies_a_exclusion_filter | No | Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| li_organization_description_filter | No | Filter on the company's description, with the same syntax as our job search filters | |
| li_organization_specialties_filter | No | BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profile | |
| li_organization_slug_exclusion_filter | No | Similar to the slug filter, but it removes companies from the results. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It discloses a key requirement—'Requires Ultra or Mega subscription'—and the time window, but it does not describe read-only behavior, pagination defaults, response size, or other runtime characteristics. This is useful but not comprehensive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is only two short sentences, front-loaded with the core identity ('Firehose API') and each sentence adds value—functionality and usage/subscription requirement. No wasted words or repetition of schema content.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (31 parameters, no annotations, no output schema) and multiple similar siblings, the description provides only the essential time-window and subscription context. It lacks explanation of response format, default behavior, or differentiation from the ultra_3/ultra_4 variants, leaving the tool only partially complete for selection and invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all 31 parameters. The description itself adds no parameter-specific meaning, which is acceptable under the baseline, though some schema descriptions contain only 'Example value:' placeholders that the description does not clarify.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool is a 'Firehose API' that includes jobs discovered in the last hour, which clearly identifies its resource and time scope. It distinguishes from get_jobs_24h and get_jobs_7_days by emphasizing hourly freshness, but it does not clarify how it differs from sibling tools ultra, ultra_3, and ultra_4.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly says 'Perfect for one or more hourly API calls', giving clear context for when to use it: for hourly incremental pulls. However, it does not name alternative tools or explicitly state when not to use it, so it falls short of full when/when-not guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ultra_3B
You can use this endpoint to backfill your job application before moving on to the 7d, 24h, or hourly endpoint
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Warning, this endpoint is for backfill purposes and goes up to 500 jobs per API call. These jobs count towards your job credits You can limit the number of jobs per API call between 10 and 500. If left blank, the default value is 500 Use the offset parameter to receive the next batch of jobs | |
| offset | No | Offset allows you to paginate results. For example, if you want to retrieve 1500 jobs from our api you can send 3 requests with limit=500 and offset= 0, 500, and 1000. | |
| remote | No | Example value: | |
| source | No | You may optionally filter on the source, which are the ATS platforms. Your options are:adp, applicantpro, ashby, bamboohr, breezy, careerplug, comeet, csod, dayforce, eightfold, freshteam, gem, greenhouse, gohire, hirehive, hiringthing, icims, isolved, jazzhr, jobvite, join.com, kula, lever.co, oraclecloud, paycom, paylocity, personio, phenompeople, pinpoint, polymer, recruitee, recooty, smartrecruiters, successfactors, taleo, teamtailor, taleo, trakstar, workable, workday, zoho You can search o | |
| include_ai | No | Example value: | |
| include_li | No | Example value: | |
| title_filter | No | Search on the job title. You can search like you search on Google, see the documentation for more info. | |
| ai_has_salary | No | Example value: | |
| location_filter | No | Filter on location. Please do not search on abbreviations like US, UK, NYC. Instead, search on full names like United States, New York, United Kingdom. You may filter on more than one location in a single API call using the OR parameter. For example: Dubai OR Netherlands OR Belgium | |
| description_type | No | Description Type. Leave empty to return data without job description. Option 1: 'text' Option 2: 'html' | |
| source_exclusion | No | You can exclude one or more sources with a comma delimited list without spaces!. For example: source_exclusion:workday,greenhouse | |
| description_filter | No | Filter on the job description. You can search like you search on Google, see the documentation for more info. Warning, for the 6 month endpoint, only use the description filter for very specific searches, or to narrow down after having applied other filters. There's a risk of timeouts when searching on very common words and sentences. Be as specific as possible when using description_filter. | |
| li_industry_filter | No | BETA Feature Filter on the organization's LinkedIn Industry. Please use the exact Industry name. This filter is case sensitive. You can filter on more than one industry with a comma-delimited list without spaces. For example: industry_filter=Accounting,Staffing and Recruiting If the industry contains a comma, please double-quote. You can find a list of industries on our website: https://fantastic.jobs/article/linkedin-industries | |
| organization_filter | No | Filter on the job's company name. Only allows for exact matches. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:NVIDIA,Walmart Warning, this filter does not work for company names using parenthesis ( ) Please send us an email at remco@fantastic.jobs to receive a list of all companies in this API | |
| advanced_title_filter | No | Advanced Title filter which enables more features like parenthesis, 'AND', and prefix searching. Can Not be used in combination with regular title_filter Phrares (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: (AI | 'Machine Learning' | 'Robotics') & ! | |
| ai_taxonomies_a_filter | No | Filter the jobs on one or more top level taxonomies. You can choose from: Technology, Healthcare, Management & Leadership, Finance & Accounting, Human Resources, Sales, Marketing, Customer Service & Support, Education, Legal, Engineering, Science & Research, Trades, Construction, Manufacturing, Logistics, Creative & Media, Hospitality, Environmental & Sustainability, Retail, Data & Analytics, Software, Energy, Agriculture, Social Services, Administrative, Government & Public Sector, Art & Design | |
| ai_employment_type_filter | No | BETA Feature. Filter on a specific job type as identified by our AI, the options are: FULL_TIME/PART_TIME/CONTRACTOR/TEMPORARY/INTERN/VOLUNTEER/PER_DIEM/OTHER To filter on more than one job type, please delimit by comma, like such: FULL_TIME, PART_TIME | |
| ai_experience_level_filter | No | BETA Feature. Filter on a certain required experience level as identified by our AI, the options are: 0-2/2-5/5-10/10+ To filter on more than one job type, please delimit by comma with no space, like such: 0-2,2-5 | |
| ai_visa_sponsorship_filter | No | Example value: | |
| ai_work_arrangement_filter | No | BETA Feature. Filter on a specific work arrangement identified by our AI, This is a more granular version of the 'remote' filter, which is quite broad. the options are: On-site (Job is on site only, no working from home available) Hybrid (Job is in the office with one or more days remote) Remote OK (Job is fully remote, but an office is available) Remote Solely (Job is fully remote, and no office is available) To filter on more than one job type, please delimit by comma with no space, like such: | |
| advanced_description_filter | No | Uses the same syntax as advanced_title_filter Warning, for the 6 month endpoint, only use the description filter for very specific searches, or to narrow down after having applied other filters. There's a risk of timeouts when searching on very common words and sentences. Be as specific as possible when using description_filter. | |
| li_organization_slug_filter | No | Filter on the job's company via the slug. You can search on more than one company with a comma delimited list without spaces!. For example: organization_filter:netflix,walmart Only allows for exact matches, please check the exact company slug before filtering. The slug is the company specific part of the url. For example the slug in the following url is 'walmart': https://www.linkedin.com/company/walmart/ Please send us a message or email at remco@fantastic.jobs to receive a list of companies | |
| advanced_organization_filter | No | Advanced Organization filter which enables more features like parenthesis, 'AND', and prefix searching. This filter is also useful to exclude certain organizations. Phrases (two words or more) always need to be single quoted or use the operator <-> Instead of using natural language like 'OR' you need to use operators like: & (AND) | (OR) ! (NOT) <-> (FOLLOWED BY) ' ' (FOLLOWED BY alternative, does not work with 6. Prefix Wildcard) :* (Prefix Wildcard) For example: University & ! Harvard Will ret | |
| li_organization_employees_lte | No | Use this to filter on jobs from companies less than a certain number of employees. Can be used in combination with li_organization_employees_gte. For example, if you wish to filter on small companies but want to exclude companies with just one employee, you can use the following query filter: employees_gte=1 employees_lte=200 | |
| organization_exclusion_filter | No | Same syntax as the organization_filter. Filter out more than one company with a comma delimited list without spaces!. Requires an exact match. Use the advanced_organization_filter for more functionality | |
| ai_taxonomies_a_primary_filter | No | Filter the jobs on one or more top level primary taxonomies. This filter will filter on the primary taxonomy only (the first taxonomy in the array) You can filter on more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| ai_taxonomies_a_exclusion_filter | No | Use this parameter to exclude jobs with certain top level taxonomies from the results You can filter out more than one taxonomy with a comma delimited list without spaces!. For example: ai_taxonomies_a_exclusion_filter:Technology,Healthcare For taxonomies including &, please double-quote | |
| li_organization_description_filter | No | Filter on the company's description, with the same syntax as our job search filters | |
| li_organization_specialties_filter | No | BETA Feature Filter on the job's organization LinkedIn specialties, with the same syntax as our job search filters. Please note that not all companies have specialties listed on their company profile | |
| li_organization_slug_exclusion_filter | No | Similar to the slug filter, but it removes companies from the results. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It only states 'backfill,' which implies a read operation, but does not disclose rate limits, pagination behavior, response format, or any operational constraints. The parameter descriptions in the schema mention job credits and offset, but the tool-level description itself lacks this transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single sentence with no redundancy, which earns points for conciseness. However, given the enormous parameter surface, it is under-specified and lacks structure, making it borderline between minimal and acceptable.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With 30 parameters, no annotations, and no output schema, the one-sentence description is inadequate for understanding the endpoint's full context. It does not explain what the endpoint actually returns, how it fits into the ultra family, or which parameters are most relevant for a backfill use case. The rich parameter descriptions help, but the overall tool description is far from complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema already provides 100% coverage with descriptions for all 30 parameters, so the baseline is 3. The tool description adds no additional parameter-level semantics, but the schema descriptions are detailed enough to compensate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('backfill') and a resource ('job application'), and it distinguishes this endpoint from sibling endpoints ('7d, 24h, or hourly endpoint'). This makes the general purpose clear, though 'backfill your job application' is somewhat ambiguous regarding whether it retrieves job postings or fills an application.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives a clear usage directive: use this endpoint for backfill before moving on to the 7d, 24h, or hourly endpoints. This implies a temporal or sequencing relationship and names the alternatives, which provides when-to-use guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
ultra_4A
Contains IDs of jobs that were flagged as expired yesterday. Updates once per day at 01:30 UTC. Requires Ultra or Mega subscription
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of disclosure. It adds valuable behavioral context: the update schedule (once per day at 01:30 UTC) and the subscription requirement. It also implies a read-only operation by saying 'contains,' though it does not explicitly state side effects or response format.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two sentences, front-loaded with the core purpose, followed by operational details. No filler or redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no parameters and no output schema, the description covers the essential context: what data is returned (IDs), the timeframe (yesterday), the refresh schedule, and access requirements. It does not specify the exact return format (e.g., array vs. object), but for a simple no-param tool, the description is sufficiently complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the description does not need to add parameter meaning. The baseline for 0 params is 4, and the description does not detract from that.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool contains IDs of jobs flagged as expired yesterday, specifying the timeframe and resource. It distinguishes from sibling tools by noting yesterday's expired jobs and the subscription requirement, though the verb 'contains' is less action-oriented than 'lists' or 'returns'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides a clear prerequisite (Ultra or Mega subscription) and the update cadence (daily at 01:30 UTC), which helps with when to call. However, it does not explicitly contrast with sibling tools like get_jobs_24h or get_jobs_7_days, leaving it to the reader to infer the right use case.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.
6 tool updates
v2.0.0- First observed
get_jobs_24h - First observed
get_jobs_7_days - First observed
ultra - First observed
ultra_2 - First observed
ultra_3 - First observed
ultra_4
TDQS
The get_jobs_* tools are somewhat distinguishable by time window, but ultra and get_jobs_24h both cover 24-hour periods, creating overlap. The ultra_2, ultra_3, and ultra_4 names provide no semantic hint about their purpose, making it difficult to select the right tool without reading descriptions.
The naming is highly inconsistent: get_jobs_7_days and get_jobs_24h follow a verb_noun_time pattern, while the other four tools are named ultra, ultra_2, ultra_3, and ultra_4 with no descriptive verb or noun and arbitrary numeric suffixes. This mixes conventions and obscures functionality.
Six tools is a reasonable number for a jobs database server, covering different time-based queries without excessive overlap or bloat. The count fits within the typical well-scoped range.
The tools cover several retrieval scenarios (7-day, 24h, hourly, backfill, expired), but there is no direct job-by-ID lookup or a general search across all jobs. Additionally, the overlap between get_jobs_24h and ultra suggests unclear boundaries rather than comprehensive coverage.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Live job postings from 30+ ATS feeds and job boards, one schema. Live results need a Bearer key.
Manage job applications — jobs, companies, boards, notes, and profile — from your AI client.
Search people open to work and fetch their machine-readable cv.json, from any AI assistant.
Search a live index of millions of open jobs from employer career sites and 100+ ATS platforms.
Related MCP Servers
- AlicenseAqualityCmaintenanceProvides tools to interact with the HireBase Job API, enabling users to search for jobs using various criteria and retrieve detailed job information through natural language.211MIT

JobSpy MCP Serverofficial
FlicenseNot gradedqualityFmaintenanceEnables AI assistants to search for jobs across multiple platforms (Indeed, LinkedIn, Glassdoor, etc.) using the JobSpy tool, with filtering and structured output.107-
@career-now/mcpofficial
AlicenseNot gradedqualityDmaintenanceEnables AI agents to search and explore a large database of tech job listings with filtering options.MIT- FlicenseNot gradedqualityCmaintenanceEnables searching job listings on joblet.ai by title, company, location, and employment type, and retrieving full job details including description, responsibilities, requirements, salary, and apply link.-
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/BACH-AI-Tools/bach-active_jobs_db'
If you have feedback or need assistance with the MCP directory API, please join our Discord server