Skip to content
Back to search

mcp

Official remote Model Context Protocol (MCP) server for GreenHired — the global sustainability job board, free Applicant Tracking System (ATS), and green career roadmap platform.

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/greenhired--mcp/badge.svg)](/listings/greenhired--mcp)

HTML

<a href="/listings/greenhired--mcp"><img src="/api/listings/greenhired--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 · 141 lines
  1. # [GreenHired](https://greenhired.com/) MCP Server
  2. The official remote [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **GreenHired**, a job board for green careers (climate, energy, sustainability and nature roles) with a free applicant tracking system and free career roadmaps.
  3. [MCP overview](https://greenhired.com/mcp/) · [Developer docs](https://greenhired.com/developers/mcp/) · [REST API](https://greenhired.com/developers/api/v1/) · [Career roadmaps](https://greenhired.com/roadmaps/) · [Browse green jobs](https://greenhired.com/jobs/)
  4. > This repository holds documentation only. The server itself is hosted by GreenHired at the address below.
  5. ---
  6. ## Overview
  7. The GreenHired MCP server lets an AI assistant such as Claude search live green jobs across 28 categories and, if you allow it, read or change parts of your own GreenHired job seeker or employer account. Job search currently covers jobs posted directly on GreenHired. There is nothing to install: it is a remote server.
  8. - **Endpoint:** `https://mcp.greenhired.com/mcp`
  9. - **Transport:** Streamable HTTP, stateless, MCP `2025-03-26`
  10. - **Sign in with GreenHired** (OAuth 2.1 with PKCE and dynamic client registration): the 3 job search tools, plus the account tools for your job seeker or employer account. You choose the permissions.
  11. - **API key** (`ghk_`): for developers who build agents over the 3 job search tools. Keys are issued by the GreenHired team on request (partners@greenhired.com).
  12. ---
  13. ## Quick connect
  14. The screens differ in each assistant and the vendors change them, so the steps below are short. The full guides are in the [developer docs](https://greenhired.com/developers/mcp/).
  15. ### Claude (web and desktop)
  16. 1. Open **Customize**, then **Connectors**, press **+ Add**, then **Add custom connector**.
  17. 2. Enter a name such as "GreenHired" and this address:
  18. ```text
  19. https://mcp.greenhired.com/mcp
  20. ```
  21. 3. Choose **Sign in now**, press **Add**, sign in with GreenHired and tick the permissions you want to give.
  22. ### Claude Code
  23. ```bash
  24. claude mcp add --transport http greenhired https://mcp.greenhired.com/mcp
  25. ```
  26. Then start `claude`, type `/mcp`, choose `greenhired` and follow the browser sign-in.
  27. ### Cursor (`mcp.json`)
  28. ```json
  29. {
  30. "mcpServers": {
  31. "greenhired": {
  32. "url": "https://mcp.greenhired.com/mcp"
  33. }
  34. }
  35. }
  36. ```
  37. ### ChatGPT, VS Code and other clients
  38. Add `https://mcp.greenhired.com/mcp` as a remote Streamable HTTP MCP server and choose OAuth sign-in (discovery is at `/.well-known/oauth-protected-resource`). Steps for [ChatGPT](https://greenhired.com/developers/mcp/chatgpt/), [VS Code and other clients](https://greenhired.com/developers/mcp/other-clients/) are in the docs.
  39. > **Tested with:** Claude, on the live server, on 21 November 2026. Other clients that support remote MCP servers with sign-in should be able to connect. Their guides follow each vendor's own documentation.
  40. ---
  41. ## Tools (12)
  42. Nine tools only read. Three change something in your account and are marked as such to your assistant (`readOnlyHint` and `destructiveHint`). A tool is offered only when you gave its permission.
  43. ### Job search
  44. Available to anyone who signed in with GreenHired, or to a `ghk_` key with the scope shown.
  45. | Tool | Changes data | What it does |
  46. |---|---|---|
  47. | `search_jobs` (key scope `jobs:read`) | No | Search live jobs by category, country, work mode, employment type, seniority, company, posting date and pay (`salary_min` needs `currency`), newest first, with cursor paging. |
  48. | `get_job` (key scope `jobs:read`) | No | One job by its slug, with the full description as plain text and sanitised HTML, and a link back to the job on greenhired.com. |
  49. | `list_categories` (key scope `categories:read`) | No | The 28 green job categories with the number of live jobs in each. |
  50. ### Your account, as a job seeker
  51. | Tool | Permission you give | Changes data | What it does |
  52. |---|---|---|---|
  53. | `get_my_account` | any | No | Whose account this is (job seeker or employer), the company for an employer, and the permissions you gave. |
  54. | `get_my_profile` | `profile:read` | No | Your headline, summary, location, skills, desired roles, job search status and work mode. |
  55. | `update_my_profile` | `profile:write` | Yes | Change those fields. A list you send replaces the whole list. |
  56. | `list_my_applications` | `applications:read` | No | The jobs you applied to and where each stands (`submitted`, `reviewing`, `shortlisted`, `rejected`, `hired`, `withdrawn`), newest first. |
  57. | `list_my_saved_jobs` | `saved:read` | No | Your saved jobs, newest first. |
  58. | `save_job` | `saved:write` | Yes | Save an open job by its slug. It does not apply for the job. |
  59. | `unsave_job` | `saved:write` | Yes | Remove a job from your saved jobs. |
  60. ### Your account, as an employer
  61. | Tool | Permission you give | Changes data | What it does |
  62. |---|---|---|---|
  63. | `get_my_company` | `company:read` | No | Your company profile and your role in the company. |
  64. | `list_company_jobs` | `jobs:read` | No | Your company's jobs with title, status, dates and the number of applications. Never applicants. |
  65. ---
  66. ## Example prompts
  67. - "List the 28 green job categories on GreenHired and show which have the most live openings."
  68. - "Find remote renewable energy or ESG jobs that state a salary, and save the top three to my GreenHired account."
  69. - "Which of my GreenHired applications are still in review?"
  70. - "List our active company jobs on GreenHired and how many applications each has."
  71. ---
  72. ## Privacy, consent and what an assistant can never do
  73. - **You choose, one permission at a time.** Reading permissions are ticked for you; writing permissions never are. The consent page says the app is not verified by GreenHired, because assistants register themselves, so continue only if you started the connection.
  74. - **You can remove it at any time** on your [Connected apps](https://greenhired.com/connected-apps/) page (sign-in needed). Changing your password or turning off two-factor sign-in removes every connected assistant.
  75. - **Employers:** company owners decide which roles may connect an assistant and can see and remove their team's connections.
  76. - **Where the data goes:** what an assistant reads goes to the company that runs it, under that company's own terms. Tick only what you are happy to share.
  77. - **Short-lived access:** access tokens last 60 minutes and refresh tokens 30 days and rotate.
  78. There is no tool, permission or endpoint for an assistant to:
  79. - apply to a job or message anyone;
  80. - read an email address, phone number, CV, cover letter, applicant, recruiter note or score;
  81. - change an email, password, two-factor, privacy or notification setting;
  82. - create, change, publish or close a job (`jobs:write` exists only for personal API keys on the account API).
  83. ---
  84. ## If something goes wrong
  85. - **Sign-in asked again, or a 401:** connect the assistant again.
  86. - **429:** wait for the time in the `Retry-After` header and try again.
  87. - **Anything else:** write to support@greenhired.com.
  88. ---
  89. ## More from GreenHired
  90. - [MCP documentation](https://greenhired.com/developers/mcp/) and [tool reference](https://greenhired.com/developers/mcp/tools/)
  91. - [Public jobs API](https://greenhired.com/developers/api/v1/) ([OpenAPI file for the public jobs API](https://api.greenhired.com/v1/openapi.json))
  92. - [API for job seekers](https://greenhired.com/candidates/api/) and [API for recruiters](https://greenhired.com/recruiters/api/)
  93. - [Free applicant tracking system for recruiters](https://greenhired.com/recruiters/features/ats/)
  94. - [Career roadmaps](https://greenhired.com/roadmaps/): ESG analyst, solar PV technician and EHS officer
  95. - [Privacy policy](https://greenhired.com/legal/privacy/) · [Terms of service](https://greenhired.com/legal/tos/) · [Security](https://greenhired.com/security/)
  96. ## Support
  97. - Help and bug reports: support@greenhired.com
  98. - A public jobs API key (`ghk_`) or an integration: partners@greenhired.com
  99. - Security problems: see [greenhired.com/security](https://greenhired.com/security/)
  100. Built and operated by [GreenHired](https://greenhired.com/).

Ratings and comments

Sign in to rate this skill.

Sign in

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