Openings MCP

1<h1 align="center">openings-mcp</h1>
2 
3<p align="center">
4  <strong>One MCP server to search job boards and company career sites.</strong>
5</p>
6 
7**openings-mcp** searches job listings across job boards and company career
8sites from any MCP client: Claude Code, Codex, Gemini CLI, and others.
9 
10- **Job boards**: **[104](https://www.104.com.tw)**, **[Cake](https://www.cake.me)**,
11  **[Jobindex](https://www.jobindex.dk)** (Denmark),
12  **[マイナビ転職](https://tenshoku.mynavi.jp)** (Japan),
13  **[Flowxtra](https://flowxtra.com)** (board-wide across every company on the
14  Flowxtra ATS),
15  **[LinkedIn](https://www.linkedin.com)**, and **[Indeed](https://www.indeed.com)**
16  (public search).
17- **Company career sites**: 39,000+ companies hosted on the
18  **[Workday](https://www.workday.com)**, **[Ashby](https://www.ashbyhq.com)**,
19  **[Greenhouse](https://www.greenhouse.com)**, **[Lever](https://www.lever.co)**,
20  **[Teamtailor](https://www.teamtailor.com)**, **[Recruitee](https://recruitee.com)**,
21  **[Eightfold](https://eightfold.ai)**,
22  **[SAP SuccessFactors](https://www.sap.com/products/hcm/recruiting-software.html)**,
23  **[SmartRecruiters](https://www.smartrecruiters.com)**,
24  **[Workable](https://www.workable.com)**,
25  **[Rippling](https://www.rippling.com/recruiting)**,
26  **[iCIMS](https://www.icims.com)**,
27  **[Oracle Recruiting Cloud](https://www.oracle.com/human-capital-management/recruiting/)**,
28  **[JOIN](https://join.com)**,
29  **[UKG Pro (UltiPro)](https://www.ukg.com/products/ukg-pro)**,
30  **[Avature](https://www.avature.net)**,
31  **[HERP Hire](https://lp.herp.cloud/lp/boost-applications)** (Japan),
32  **[engage](https://en-gage.net)** (Japan),
33  **[HRMOS 採用](https://hrmos.co)** (Japan),
34  **[MokaHR](https://www.mokahr.com)** (China),
35  and **[BambooHR](https://www.bamboohr.com)**
36  ATS platforms, all behind one company-search tool. A company outside the
37  built-in roster works too: pass its careers-page URL on any of those platforms
38  except Eightfold, SAP SuccessFactors, and JOIN, which support roster companies only.
39- **Dedicated big tech sites**: **[Amazon Jobs](https://www.amazon.jobs)**,
40  **[Apple Careers](https://jobs.apple.com)**,
41  **[Google Careers](https://www.google.com/about/careers/applications/jobs)**,
42  **[Meta Careers](https://www.metacareers.com)**,
43  **[NVIDIA careers](https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite)**, and
44  **[TSMC careers](https://careers.tsmc.com)**.
45 
46⚠️ Token use adds up fast when your client explores multiple postings or
47fetches full job details, so consider a cheaper model.
48 
49<p align="center">
50  <img src="assets/openings_demo.gif" alt="Demo of openings-mcp searching job listings from Claude Code" width="800">
51</p>
52 
53> **Disclaimer:** This is an unofficial, personal-use tool. It is not affiliated
54> with, endorsed by, or sponsored by 104 Corporation, TSMC, or any other job
55> board or company whose listings it searches. It calls each site's public web
56> endpoints; please respect their terms of service and use it at a reasonable,
57> low frequency. The project ships no scraped job data.
58 
59## Install
60 
61With Homebrew:
62 
63```
64brew install --cask amikai/tap/openings-mcp
65```
66 
67With Go:
68 
69```
70go install github.com/amikai/openings-mcp/cmd/openings-mcp@latest
71```
72 
73Upgrade by rerunning the same command; pin a version with `@vX.Y.Z`.
74 
75Without Go: download the archive for your platform from
76[Releases](https://github.com/amikai/openings-mcp/releases) and put
77`openings-mcp` on your PATH.
78 
79With Docker (multi-arch: linux/amd64, linux/arm64):
80 
81```
82docker pull ghcr.io/amikai/openings-mcp
83```
84 
85## Add the MCP server to your tool
86 
87With `openings-mcp` on your PATH:
88 
89**Claude Code**
90 
91```
92claude mcp add openings-mcp -- openings-mcp
93```
94 
95**Codex**
96 
97```
98codex mcp add openings-mcp -- openings-mcp
99```
100 
101**Gemini CLI**
102 
103```
104gemini mcp add openings-mcp openings-mcp
105```
106 
107With Docker instead, replace `openings-mcp` with `docker run -i --rm ghcr.io/amikai/openings-mcp`, e.g.:
108 
109```
110claude mcp add openings-mcp -- docker run -i --rm ghcr.io/amikai/openings-mcp
111```
112 
113## Disclaimer
114 
115This is an unofficial tool. It is not affiliated with, endorsed by, or
116supported by 104 Corporation, TSMC, or any other job board or company whose
117listings it searches.
118 
119Some providers rely on undocumented APIs that may change or stop working at
120any time without notice. Job listing data belongs to the respective sites. The
121server fetches it on your behalf when you invoke a tool and stores or
122redistributes nothing.
123 
124Use this tool for personal job searching at a human pace. Every request goes
125out from your own machine, and a site may throttle or temporarily block your
126IP if too many arrive too quickly. The server does not rate-limit requests,
127so a client that pages through many results or fetches lots of job details in
128one go can trip these limits. The server never logs in, so your accounts on
129these sites are not at risk. You are responsible for complying with the terms of
130service of each site you query; do not use it for bulk scraping or data
131harvesting.
132 
133## Credits
134 
135Inspired by these MCP job-search servers:
136 
137- [job104-mcp](https://github.com/mozzan/job104-mcp)
138- [jobspy-mcp-server](https://github.com/borgius/jobspy-mcp-server)
139- [mcp-jobs](https://github.com/mergedao/mcp-jobs)
140- [104-mcp-server](https://github.com/bigbrainw/104-mcp-server)
141 
142Company roster data cross-referenced from:
143 
144- [OpenPostings](https://github.com/Masterjx9/OpenPostings) — company/ATS discovery data used to expand the curated roster
145 
146Jobindex search reference:
147 
148- [ai-job-search](https://github.com/MadsLorentzen/ai-job-search)
149 
150## License
151 
152[MIT](LICENSE)
153