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](https://www.104.com.tw)**, **[Cake](https://www.cake.me)**,
**[Jobindex](https://www.jobindex.dk)** (Denmark),
**[マイナビ転職](https://tenshoku.mynavi.jp)** (Japan),
**[Flowxtra](https://flowxtra.com)** (board-wide across every company on the
Flowxtra ATS),
**[freehire.me](https://freehire.me)** (IT/tech catalogue across company
ATS boards),
**[LinkedIn](https://www.linkedin.com)**, and **[Indeed](https://www.indeed.com)**
(public search).
- **Company career sites**: 41,000+ companies hosted on the
**[Workday](https://www.workday.com)**, **[Ashby](https://www.ashbyhq.com)**,
**[Greenhouse](https://www.greenhouse.com)**, **[Lever](https://www.lever.co)**,
**[Teamtailor](https://www.teamtailor.com)**, **[Recruitee](https://recruitee.com)**,
**[Eightfold](https://eightfold.ai)**,
**[SAP SuccessFactors](https://www.sap.com/products/hcm/recruiting-software.html)**,
**[SmartRecruiters](https://www.smartrecruiters.com)**,
**[Workable](https://www.workable.com)**,
**[Rippling](https://www.rippling.com/recruiting)**,
**[iCIMS](https://www.icims.com)**,
**[Oracle Recruiting Cloud](https://www.oracle.com/human-capital-management/recruiting/)**,
**[JOIN](https://join.com)**,
**[UKG Pro (UltiPro)](https://www.ukg.com/products/ukg-pro)**,
**[Dayforce](https://www.dayforce.com)**,
**[Avature](https://www.avature.net)**,
**[HERP Hire](https://lp.herp.cloud/lp/boost-applications)** (Japan),
**[engage](https://en-gage.net)** (Japan),
**[HRMOS 採用](https://hrmos.co)** (Japan),
**[MokaHR](https://www.mokahr.com)** (China),
**[BambooHR](https://www.bamboohr.com)**,
and **[ADP MyJobs](https://myjobs.adp.com)**
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 company career sites**: **[Amazon Jobs](https://www.amazon.jobs)**,
**[Apple Careers](https://jobs.apple.com)**,
**[Google Careers](https://www.google.com/about/careers/applications/jobs)**,
**[Meta Careers](https://www.metacareers.com)**, and
**[TSMC Careers](https://careers.tsmc.com)**.
⚠️ 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](https://github.com/amikai/openings-mcp/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
Run openings-mcp as a local HTTP server, then point your tools at it. Every
session in every tool shares that one process.
**1. Start the server:** run `openings-mcp --http=127.0.0.1:8080` and leave
it running in its own terminal. With Docker, run
`docker run -d --rm --name openings-mcp -p 127.0.0.1:8080:8080 ghcr.io/amikai/openings-mcp --http`
and stop it with `docker stop openings-mcp`.
**2. Add it to your tool**
**Claude Code**
```
claude mcp add --transport http --scope user openings-mcp http://127.0.0.1:8080
```
**Codex**
```
codex mcp add openings-mcp --url http://127.0.0.1:8080
```
**Gemini CLI**
```
gemini mcp add --transport http openings-mcp http://127.0.0.1:8080
```
## 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
- [freehire](https://github.com/strelov1/freehire)
Inspired by these MCP job-search servers:
- [job104-mcp](https://github.com/mozzan/job104-mcp)
- [jobspy-mcp-server](https://github.com/borgius/jobspy-mcp-server)
- [mcp-jobs](https://github.com/mergedao/mcp-jobs)
- [104-mcp-server](https://github.com/bigbrainw/104-mcp-server)
Company roster data cross-referenced from:
- [OpenPostings](https://github.com/Masterjx9/OpenPostings) — company/ATS discovery data used to expand the curated roster
Jobindex search reference:
- [ai-job-search](https://github.com/MadsLorentzen/ai-job-search)
## License
[MIT](LICENSE)