Skip to content
Back to search

birjob-mcp

BirJob MCP server: search Azerbaijan's job market from any MCP client

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

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

HTML

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

Install

i

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 · 158 lines
  1. # BirJob MCP server
  2. Search Azerbaijan's job market from any MCP client.
  3. [BirJob](https://www.birjob.com) reads more than 120 Azerbaijani job sites and employers' career pages, about 90 of them with open vacancies at any time, and lists each job once (about 10,000 open jobs). It also lists jobs in Uzbekistan, Kazakhstan, Turkey, Georgia and Kyrgyzstan.
  4. BirJob runs a remote MCP server, so ChatGPT, Cursor, VS Code, Gemini CLI, Kiro, Raycast, Windsurf and any other MCP client can search those jobs, read a posting with its apply link and rank jobs against a CV. Every job and employer in a result links to its page on birjob.com.
  5. This repository holds no code: only the server's address, a Gemini CLI extension manifest and these setup notes.
  6. | | |
  7. |---|---|
  8. | Endpoint | `https://www.birjob.com/mcp` |
  9. | Transport | Streamable HTTP |
  10. | Sign-in | None for search; OAuth 2.1 for the account tools |
  11. | MCP Registry | `com.birjob/jobs` |
  12. | Setup page | https://www.birjob.com/ai |
  13. ## Demo
  14. BirJob in ChatGPT, in 74 seconds: a search, one job's details, matching by skills, the BirJob sign-in, saving a job, tracking an application, and a request it does not do (applying for you).
  15. ![BirJob in ChatGPT: search, job details, sign-in, saved jobs and the application tracker](demo/birjob-chatgpt-walkthrough.gif)
  16. ## Connect
  17. Add the server in your client's MCP or connector settings; pasting the address into a chat is not enough. Most clients take this:
  18. ```json
  19. {
  20. "mcpServers": {
  21. "birjob": {
  22. "url": "https://www.birjob.com/mcp"
  23. }
  24. }
  25. }
  26. ```
  27. If the client asks for a transport, choose Streamable HTTP (often labelled HTTP). A client that runs only local servers can reach it through a proxy such as `npx -y mcp-remote https://www.birjob.com/mcp`.
  28. ### Gemini CLI
  29. Install this repository as an extension:
  30. ```sh
  31. gemini extensions install https://github.com/jobloom/birjob-mcp
  32. ```
  33. Or add the server on its own:
  34. ```sh
  35. gemini mcp add --scope user --transport http birjob https://www.birjob.com/mcp
  36. ```
  37. To use your BirJob account, run `/mcp auth birjob` and sign in in the browser.
  38. ### Cursor
  39. Add this to `~/.cursor/mcp.json` for every project, or to `.cursor/mcp.json` for one:
  40. ```json
  41. {
  42. "mcpServers": {
  43. "birjob": {
  44. "url": "https://www.birjob.com/mcp"
  45. }
  46. }
  47. }
  48. ```
  49. Cursor runs the BirJob sign-in itself when an account tool needs it.
  50. ### VS Code
  51. Run **MCP: Add Server** from the Command Palette, choose **HTTP (HTTP or Server-Sent Events)**, enter `https://www.birjob.com/mcp`, use `birjob` as the server ID and select **Global**. To share it with a workspace instead, put this in `.mcp.json` at the workspace root:
  52. ```json
  53. {
  54. "mcpServers": {
  55. "birjob": {
  56. "type": "http",
  57. "url": "https://www.birjob.com/mcp",
  58. "tools": ["*"]
  59. }
  60. }
  61. }
  62. ```
  63. For the account tools, select **Authenticate** when VS Code offers it.
  64. ### Kiro
  65. [![Add to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=birjob&config=%7B%22url%22%3A%22https%3A%2F%2Fwww.birjob.com%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D)
  66. Or add this to `~/.kiro/settings/mcp.json` for every workspace, or to `.kiro/settings/mcp.json` for one:
  67. ```json
  68. {
  69. "mcpServers": {
  70. "birjob": {
  71. "url": "https://www.birjob.com/mcp"
  72. }
  73. }
  74. }
  75. ```
  76. Kiro opens the BirJob sign-in in the browser when it is needed.
  77. ### ChatGPT
  78. Custom MCP servers (formerly developer mode) are added on the web:
  79. 1. Go to [chatgpt.com/plugins](https://chatgpt.com/plugins), select **+** and then **Add custom MCP server**.
  80. 2. Name it BirJob and enter `https://www.birjob.com/mcp` as the **Server URL**.
  81. 3. For authentication, choose **OAuth or no authentication**. Search then works without signing in, and ChatGPT asks you to sign in to BirJob when you use an account tool.
  82. 4. Confirm the warning, select **Create as a plugin** and install it. In a chat, type `@` and pick BirJob.
  83. If ChatGPT answers "This app does not provide a browser setup URL right now" when it asks for more access, sign in from the plugin's settings instead: **Settings → Plugins → BirJob → Connect another account**, then allow access on the BirJob page that opens.
  84. ## Tools
  85. Without signing in:
  86. | Tool | What it does |
  87. |---|---|
  88. | `search_jobs` | Searches open jobs by role, skill or company, city, country, category, work format, employment type, seniority and minimum salary. |
  89. | `get_job` | Reads one job in full: its text, the salary if the posting states one, its dates and the apply link. |
  90. | `similar_jobs` | Finds open jobs like a given one. |
  91. | `new_since` | Lists the jobs BirJob first listed after a given time. |
  92. | `list_companies` | Finds employers, with their open-job counts and company pages. |
  93. | `match_jobs` | Ranks open jobs against a role, skills or pasted CV text, which is used for that call and not stored. |
  94. With a BirJob account. Your client asks you to sign in to BirJob and allow access the first time you use one of these:
  95. | Tool | What it does |
  96. |---|---|
  97. | `save_job`, `get_saved_jobs`, `unsave_job` | Your saved jobs, the same list as on birjob.com. |
  98. | `track_application`, `get_applications` | Where you are with each job: saved, applied, interview, offer or rejected. |
  99. | `create_job_alert`, `get_job_alerts`, `delete_job_alert`, `get_new_matches` | Saved searches, checked for new jobs when you ask. Nothing is emailed. |
  100. | `match_jobs` with `use_profile` | Ranks jobs against your BirJob CV profile. |
  101. Titles are mostly in Azerbaijani, and a query in Azerbaijani, English or Russian finds the same jobs. A call returns 10 results by default and up to 25, and a search reads at most 20 pages. No tool applies to a job, contacts an employer or sends email for you.
  102. ## Sign-in
  103. The account tools use OAuth 2.1: the authorization code flow with PKCE (S256), dynamic client registration and client ID metadata documents, so no key or client ID is needed. Clients find it from the server's `401` answer and its protected resource metadata at https://www.birjob.com/.well-known/oauth-protected-resource/mcp. You can withdraw an assistant's access at any time in your BirJob profile, under "AI köməkçiləri".
  104. ## Privacy
  105. Without sign-in, BirJob keeps only daily counts of tool use: which tool was called, how many times, and whether it returned results. No query text, IP address or assistant name is recorded. CV text or skills sent to `match_jobs` are used for that one call and never stored. When you sign in, BirJob keeps the assistant's registration, your grant, hashes of the tokens, and the saved jobs, application statuses and saved searches the assistant makes for you. Section 2.6 of the privacy policy has the details.
  106. - Privacy policy: https://www.birjob.com/privacy
  107. - Terms: https://www.birjob.com/terms
  108. - Contact: https://www.birjob.com/contact or contact@birjob.com
  109. ## License
  110. The files in this repository are under the [MIT License](LICENSE). Using the BirJob service is covered by its terms.

Ratings and comments

Sign in to rate this skill.

Sign in

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