Skip to content
Back to search

openings-mcp

💼 One MCP server to search job boards and company career sites

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/amikai--openings-mcp/badge.svg)](/listings/amikai--openings-mcp)

HTML

<a href="/listings/amikai--openings-mcp"><img src="/api/listings/amikai--openings-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 159 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.