README
¶
openings-mcp
One MCP server to search job boards and company career sites.
openings-mcp searches job listings across job boards and company career sites from any MCP client: Claude Code, Codex, Gemini CLI, and others.
- Job boards: 104, Cake, Jobindex (Denmark), マイナビ転職 (Japan), Flowxtra (board-wide across every company on the Flowxtra ATS), LinkedIn, and Indeed (public search).
- Company career sites: 39,000+ companies hosted on the Workday, Ashby, Greenhouse, Lever, Teamtailor, Recruitee, Eightfold, SAP SuccessFactors, SmartRecruiters, Workable, Rippling, iCIMS, Oracle Recruiting Cloud, JOIN, UKG Pro (UltiPro), Avature, HERP Hire (Japan), engage (Japan), HRMOS 採用 (Japan), MokaHR (China), and BambooHR ATS platforms, all behind one company-search tool. A company outside the built-in roster works too: pass its careers-page URL on any of those platforms except Eightfold, SAP SuccessFactors, and JOIN, which support roster companies only.
- Dedicated big tech sites: Amazon Jobs, Apple Careers, Google Careers, Meta Careers, NVIDIA careers, and TSMC careers.
⚠️ Token use adds up fast when your client explores multiple postings or fetches full job details, so consider a cheaper model.
Disclaimer: This is an unofficial, personal-use tool. It is not affiliated with, endorsed by, or sponsored by 104 Corporation, TSMC, or any other job board or company whose listings it searches. It calls each site's public web endpoints; please respect their terms of service and use it at a reasonable, low frequency. The project ships no scraped job data.
Install
With Homebrew:
brew install --cask amikai/tap/openings-mcp
With Go:
go install github.com/amikai/openings-mcp/cmd/openings-mcp@latest
Upgrade by rerunning the same command; pin a version with @vX.Y.Z.
Without Go: download the archive for your platform from
Releases and put
openings-mcp on your PATH.
With Docker (multi-arch: linux/amd64, linux/arm64):
docker pull ghcr.io/amikai/openings-mcp
Add the MCP server to your tool
With openings-mcp on your PATH:
Claude Code
claude mcp add openings-mcp -- openings-mcp
Codex
codex mcp add openings-mcp -- openings-mcp
Gemini CLI
gemini mcp add openings-mcp openings-mcp
With Docker instead, replace openings-mcp with docker run -i --rm ghcr.io/amikai/openings-mcp, e.g.:
claude mcp add openings-mcp -- docker run -i --rm ghcr.io/amikai/openings-mcp
Disclaimer
This is an unofficial tool. It is not affiliated with, endorsed by, or supported by 104 Corporation, TSMC, or any other job board or company whose listings it searches.
Some providers rely on undocumented APIs that may change or stop working at any time without notice. Job listing data belongs to the respective sites. The server fetches it on your behalf when you invoke a tool and stores or redistributes nothing.
Use this tool for personal job searching at a human pace. Every request goes out from your own machine, and a site may throttle or temporarily block your IP if too many arrive too quickly. The server does not rate-limit requests, so a client that pages through many results or fetches lots of job details in one go can trip these limits. The server never logs in, so your accounts on these sites are not at risk. You are responsible for complying with the terms of service of each site you query; do not use it for bulk scraping or data harvesting.
Credits
Inspired by these MCP job-search servers:
Company roster data cross-referenced from:
- OpenPostings — company/ATS discovery data used to expand the curated roster
Jobindex search reference:
License
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
104
command
Command 104 searches 104 Job Bank and fetches full posting details.
|
Command 104 searches 104 Job Bank and fetches full posting details. |
|
amazon
command
|
|
|
apple
command
Command apple provides a small diagnostic CLI for the Apple Jobs API.
|
Command apple provides a small diagnostic CLI for the Apple Jobs API. |
|
ashby
command
Command ashby searches curated Ashby job boards and lists their companies.
|
Command ashby searches curated Ashby job boards and lists their companies. |
|
avature
command
Command avature is a debug CLI for the Avature career-portal client: live keyword search, posting detail, and the curated portal roster.
|
Command avature is a debug CLI for the Avature career-portal client: live keyword search, posting detail, and the curated portal roster. |
|
bamboohr
command
|
|
|
cake
command
Command cake searches Cake job listings and fetches full posting details.
|
Command cake searches Cake job listings and fetches full posting details. |
|
eightfold
command
Command eightfold searches curated Eightfold career sites.
|
Command eightfold searches curated Eightfold career sites. |
|
engage
command
Command engage is a debug CLI for the engage provider (internal/provider/engage), en-gage.net's hosted ATS.
|
Command engage is a debug CLI for the engage provider (internal/provider/engage), en-gage.net's hosted ATS. |
|
flowxtra
command
Command flowxtra is a debug CLI for Flowxtra's public cross-tenant jobs API — one board-wide feed covering every company hosted on the Flowxtra ATS.
|
Command flowxtra is a debug CLI for Flowxtra's public cross-tenant jobs API — one board-wide feed covering every company hosted on the Flowxtra ATS. |
|
foxconn
command
Command foxconn is a debug CLI for Hon Hai / Foxconn's Taiwan careers API (https://recruit.foxconn.com/isite-web-tw/main/jobsearch).
|
Command foxconn is a debug CLI for Hon Hai / Foxconn's Taiwan careers API (https://recruit.foxconn.com/isite-web-tw/main/jobsearch). |
|
google
command
Command google searches Google Careers and fetches full posting details.
|
Command google searches Google Careers and fetches full posting details. |
|
greenhouse
command
Command greenhouse searches curated Greenhouse job boards.
|
Command greenhouse searches curated Greenhouse job boards. |
|
herp
command
Command herp is a debug CLI for the HERP Career client: list the curated roster, list one company's board, and print a single posting in full.
|
Command herp is a debug CLI for the HERP Career client: list the curated roster, list one company's board, and print a single posting in full. |
|
himalayas
command
|
|
|
hrmos
command
|
|
|
icims
command
Command icims searches curated iCIMS career portals.
|
Command icims searches curated iCIMS career portals. |
|
indeed
command
Command indeed searches Indeed and optionally fetches posting details.
|
Command indeed searches Indeed and optionally fetches posting details. |
|
jobicy
command
Command jobicy is a debug CLI for the Jobicy remote-jobs feed.
|
Command jobicy is a debug CLI for the Jobicy remote-jobs feed. |
|
jobindex
command
Command jobindex is a debug CLI for Jobindex.dk search and detail.
|
Command jobindex is a debug CLI for Jobindex.dk search and detail. |
|
join
command
|
|
|
lever
command
Command lever searches curated Lever job boards.
|
Command lever searches curated Lever job boards. |
|
linkedin
command
Command linkedin searches public LinkedIn job listings.
|
Command linkedin searches public LinkedIn job listings. |
|
meta
command
Command meta provides a small diagnostic CLI for the Meta Careers GraphQL surface.
|
Command meta provides a small diagnostic CLI for the Meta Careers GraphQL surface. |
|
mokahr
command
Command mokahr is a debug CLI for the MokaHR careers-site provider: list curated companies, search a site's postings, print one posting in full, and list a site's filterable locations and 职能 (job functions).
|
Command mokahr is a debug CLI for the MokaHR careers-site provider: list curated companies, search a site's postings, print one posting in full, and list a site's filterable locations and 职能 (job functions). |
|
mtk
command
Command mtk is a debug CLI for MediaTek Careers' public search API and server-rendered job detail pages.
|
Command mtk is a debug CLI for MediaTek Careers' public search API and server-rendered job detail pages. |
|
mynavi
command
|
|
|
nodesk
command
Command nodesk is a debug CLI for NoDesk's public Algolia search index and job detail pages.
|
Command nodesk is a debug CLI for NoDesk's public Algolia search index and job detail pages. |
|
nvidia
command
Command nvidia searches NVIDIA's public Workday career site.
|
Command nvidia searches NVIDIA's public Workday career site. |
|
openings-mcp
command
Command openings-mcp serves job-search providers as MCP tools.
|
Command openings-mcp serves job-search providers as MCP tools. |
|
oracle
command
|
|
|
quanta
command
Command quanta is a debug CLI for Quanta Computer's recruitment site (https://hr.quantatw.com/QuantaRecruit/Home/Job).
|
Command quanta is a debug CLI for Quanta Computer's recruitment site (https://hr.quantatw.com/QuantaRecruit/Home/Job). |
|
realtek
command
Command realtek is a debug CLI for Realtek's recruitment site (https://recruit.realtek.com).
|
Command realtek is a debug CLI for Realtek's recruitment site (https://recruit.realtek.com). |
|
recruitee
command
Command recruitee searches curated Recruitee career sites.
|
Command recruitee searches curated Recruitee career sites. |
|
remotefirstjobs
command
Command remotefirstjobs is a debug CLI for RemoteFirstJobs' public jobs API.
|
Command remotefirstjobs is a debug CLI for RemoteFirstJobs' public jobs API. |
|
remoteok
command
Command remoteok is a debug CLI for Remote OK's public job feed.
|
Command remoteok is a debug CLI for Remote OK's public job feed. |
|
remotive
command
Command remotive is a debug CLI for Remotive's public remote-jobs API.
|
Command remotive is a debug CLI for Remotive's public remote-jobs API. |
|
rippling
command
|
|
|
smartrecruiters
command
Command smartrecruiters searches SmartRecruiters company postings.
|
Command smartrecruiters searches SmartRecruiters company postings. |
|
successfactors
command
Command successfactors searches SAP SuccessFactors career sites.
|
Command successfactors searches SAP SuccessFactors career sites. |
|
synopsys
command
Command synopsys searches the Synopsys career site from a keyword on stdin.
|
Command synopsys searches the Synopsys career site from a keyword on stdin. |
|
teamtailor
command
Command teamtailor searches curated Teamtailor career sites.
|
Command teamtailor searches curated Teamtailor career sites. |
|
tsmc
command
Command tsmc searches TSMC careers and fetches full posting details.
|
Command tsmc searches TSMC careers and fetches full posting details. |
|
ultipro
command
|
|
|
verify-companies
command
Command verify-companies verifies every curated companies.yaml entry by running a real search through the unified internal/ats adapters — the same code path the MCP server serves — and reports each entry's total job count.
|
Command verify-companies verifies every curated companies.yaml entry by running a real search through the unified internal/ats adapters — the same code path the MCP server serves — and reports each entry's total job count. |
|
weworkremotely
command
Command weworkremotely is a debug CLI for We Work Remotely's public RSS feeds.
|
Command weworkremotely is a debug CLI for We Work Remotely's public RSS feeds. |
|
workable
command
|
|
|
workday
command
Command workday searches curated Workday career sites.
|
Command workday searches curated Workday career sites. |
|
workingnomads
command
Command workingnomads is a debug CLI for Working Nomads's public exposed_jobs feed.
|
Command workingnomads is a debug CLI for Working Nomads's public exposed_jobs feed. |
|
internal
|
|
|
ats
Package ats unifies the ATS-backed providers behind one company-parameterized search interface, so MCP clients name a company and never learn which ATS serves it.
|
Package ats unifies the ATS-backed providers behind one company-parameterized search interface, so MCP clients name a company and never learn which ATS serves it. |
|
logging
Package logging provides MCP server middleware for request logging and panic recovery.
|
Package logging provides MCP server middleware for request logging and panic recovery. |
|
openingsmcp
Package openingsmcp adapts the internal job-board clients into MCP tools.
|
Package openingsmcp adapts the internal job-board clients into MCP tools. |
|
provider/amazon
Package amazon accesses Amazon's public careers search API.
|
Package amazon accesses Amazon's public careers search API. |
|
provider/apple
Package apple provides a session-aware client for the public Apple Jobs API.
|
Package apple provides a session-aware client for the public Apple Jobs API. |
|
provider/ashby
Package ashby provides an Ashby Job Board API client and curated board roster.
|
Package ashby provides an Ashby Job Board API client and curated board roster. |
|
provider/avature
Package avature is a client for public Avature career-portal HTML pages.
|
Package avature is a client for public Avature career-portal HTML pages. |
|
provider/bamboohr
Package bamboohr provides a public hosted-careers API client and curated company roster.
|
Package bamboohr provides a public hosted-careers API client and curated company roster. |
|
provider/cake
Package cake provides a client for Cake's public job-listing API.
|
Package cake provides a client for Cake's public job-listing API. |
|
provider/eightfold
Package eightfold provides an Eightfold career-site client and curated tenant roster.
|
Package eightfold provides an Eightfold career-site client and curated tenant roster. |
|
provider/engage
Package engage is a client for en-gage.net, エン・ジャパン's free ATS.
|
Package engage is a client for en-gage.net, エン・ジャパン's free ATS. |
|
provider/flowxtra
Package flowxtra provides a client for Flowxtra's public cross-tenant jobs API — one board-wide feed covering every company hosted on the Flowxtra ATS (see openapi.yaml for the surface notes and quirks).
|
Package flowxtra provides a client for Flowxtra's public cross-tenant jobs API — one board-wide feed covering every company hosted on the Flowxtra ATS (see openapi.yaml for the surface notes and quirks). |
|
provider/foxconn
Package foxconn provides a client for Hon Hai / Foxconn's Taiwan careers API.
|
Package foxconn provides a client for Hon Hai / Foxconn's Taiwan careers API. |
|
provider/google
Package google reads job listings and details from the public Google Careers site.
|
Package google reads job listings and details from the public Google Careers site. |
|
provider/greenhouse
Package greenhouse provides a Greenhouse Job Board API client and curated board roster.
|
Package greenhouse provides a Greenhouse Job Board API client and curated board roster. |
|
provider/herp
Code generated by ogen, DO NOT EDIT.
|
Code generated by ogen, DO NOT EDIT. |
|
provider/himalayas
Package himalayas provides a client for the Himalayas remote-jobs board API.
|
Package himalayas provides a client for the Himalayas remote-jobs board API. |
|
provider/hrmos
Package hrmos reads public HRMOS 採用 (job posting) listings and posting details from https://hrmos.co.
|
Package hrmos reads public HRMOS 採用 (job posting) listings and posting details from https://hrmos.co. |
|
provider/icims
Package icims is a client for public iCIMS career-portal HTML pages, documented in openapi.yaml.
|
Package icims is a client for public iCIMS career-portal HTML pages, documented in openapi.yaml. |
|
provider/indeed
Package indeed provides a client for Indeed's country-scoped job APIs.
|
Package indeed provides a client for Indeed's country-scoped job APIs. |
|
provider/job104
Package job104 provides a client for 104 Job Bank search and posting details.
|
Package job104 provides a client for 104 Job Bank search and posting details. |
|
provider/jobicy
Package jobicy provides a client for the official Jobicy remote-jobs feed API.
|
Package jobicy provides a client for the official Jobicy remote-jobs feed API. |
|
provider/jobindex
Package jobindex searches public job listings on Jobindex.dk, Denmark's largest commercial job board.
|
Package jobindex searches public job listings on Jobindex.dk, Denmark's largest commercial job board. |
|
provider/join
Package join provides a client for join.com's public candidate-facing job search and detail surfaces.
|
Package join provides a client for join.com's public candidate-facing job search and detail surfaces. |
|
provider/lever
Package lever provides a Lever postings API client and curated site roster.
|
Package lever provides a Lever postings API client and curated site roster. |
|
provider/linkedin
Package linkedin reads public LinkedIn job listings and posting details.
|
Package linkedin reads public LinkedIn job listings and posting details. |
|
provider/meta
Package meta reads job listings and posting details from Meta Careers (www.metacareers.com).
|
Package meta reads job listings and posting details from Meta Careers (www.metacareers.com). |
|
provider/mokahr
Package mokahr provides a MokaHR careers-site API client and curated tenant roster.
|
Package mokahr provides a MokaHR careers-site API client and curated tenant roster. |
|
provider/mtk
Package mtk reads job listings and details from the public MediaTek Careers site.
|
Package mtk reads job listings and details from the public MediaTek Careers site. |
|
provider/mynavi
Package mynavi reads public Mynavi Tenshoku (マイナビ転職) job listings and posting details from https://tenshoku.mynavi.jp.
|
Package mynavi reads public Mynavi Tenshoku (マイナビ転職) job listings and posting details from https://tenshoku.mynavi.jp. |
|
provider/nodesk
Package nodesk reads public job listings from NoDesk (https://nodesk.co), a remote-jobs board.
|
Package nodesk reads public job listings from NoDesk (https://nodesk.co), a remote-jobs board. |
|
provider/nvidia
Package nvidia provides a client for NVIDIA's public Workday career site.
|
Package nvidia provides a client for NVIDIA's public Workday career site. |
|
provider/oracle
Package oracle discovers Oracle Recruiting Cloud Candidate Experience sites and provides generated and site-bound clients for anonymous job search and detail resources.
|
Package oracle discovers Oracle Recruiting Cloud Candidate Experience sites and provides generated and site-bound clients for anonymous job search and detail resources. |
|
provider/quanta
Package quanta provides a client for Quanta Computer's recruitment site.
|
Package quanta provides a client for Quanta Computer's recruitment site. |
|
provider/recruitee
Package recruitee provides a Recruitee career-site client and curated roster.
|
Package recruitee provides a Recruitee career-site client and curated roster. |
|
provider/remotefirstjobs
Package remotefirstjobs provides a client for RemoteFirstJobs' public jobs API.
|
Package remotefirstjobs provides a client for RemoteFirstJobs' public jobs API. |
|
provider/remoteok
Package remoteok provides a client for Remote OK's public job feed.
|
Package remoteok provides a client for Remote OK's public job feed. |
|
provider/remotive
Package remotive provides a client for Remotive's public remote-jobs API.
|
Package remotive provides a client for Remotive's public remote-jobs API. |
|
provider/rippling
Package rippling provides a Rippling Job Board API client and curated board roster.
|
Package rippling provides a Rippling Job Board API client and curated board roster. |
|
provider/smartrecruiters
Package smartrecruiters provides a Posting API client and curated company roster.
|
Package smartrecruiters provides a Posting API client and curated company roster. |
|
provider/successfactors
Package successfactors is a client for the SAP SuccessFactors Career Site Builder (Jobs2Web) public career-site pages, documented in openapi.yaml.
|
Package successfactors is a client for the SAP SuccessFactors Career Site Builder (Jobs2Web) public career-site pages, documented in openapi.yaml. |
|
provider/synopsys
Package synopsys reads job listings and details from the Synopsys career site.
|
Package synopsys reads job listings and details from the Synopsys career site. |
|
provider/teamtailor
Package teamtailor provides a Teamtailor career-site client and curated roster.
|
Package teamtailor provides a Teamtailor career-site client and curated roster. |
|
provider/tsmc
Package tsmc reads job listings and details from the public TSMC career site.
|
Package tsmc reads job listings and details from the public TSMC career site. |
|
provider/ultipro
Package ultipro is a client for public UltiPro (UKG Pro Recruiting) career-board endpoints, documented in openapi.yaml.
|
Package ultipro is a client for public UltiPro (UKG Pro Recruiting) career-board endpoints, documented in openapi.yaml. |
|
provider/weworkremotely
Package weworkremotely reads public job listings from We Work Remotely's RSS feeds at https://weworkremotely.com.
|
Package weworkremotely reads public job listings from We Work Remotely's RSS feeds at https://weworkremotely.com. |
|
provider/workable
Package workable provides a public job board API client and curated company roster for Workable-hosted careers pages (apply.workable.com).
|
Package workable provides a public job board API client and curated company roster for Workable-hosted careers pages (apply.workable.com). |
|
provider/workday
Package workday provides a Workday CXS client and curated tenant roster.
|
Package workday provides a Workday CXS client and curated tenant roster. |
|
provider/workingnomads
Package workingnomads reads public job listings from Working Nomads's exposed_jobs API at https://www.workingnomads.com/api/exposed_jobs/.
|
Package workingnomads reads public job listings from Working Nomads's exposed_jobs API at https://www.workingnomads.com/api/exposed_jobs/. |
Click to show internal directories.
Click to hide internal directories.