Back to search
mcp
MCP serverGitHub
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
Markdown
[](/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
- # [GreenHired](https://greenhired.com/) MCP Server
- 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.
- [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/)
- > This repository holds documentation only. The server itself is hosted by GreenHired at the address below.
- ---
- ## Overview
- 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.
- - **Endpoint:** `https://mcp.greenhired.com/mcp`
- - **Transport:** Streamable HTTP, stateless, MCP `2025-03-26`
- - **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.
- - **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).
- ---
- ## Quick connect
- 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/).
- ### Claude (web and desktop)
- 1. Open **Customize**, then **Connectors**, press **+ Add**, then **Add custom connector**.
- 2. Enter a name such as "GreenHired" and this address:
- ```text
- https://mcp.greenhired.com/mcp
- ```
- 3. Choose **Sign in now**, press **Add**, sign in with GreenHired and tick the permissions you want to give.
- ### Claude Code
- ```bash
- claude mcp add --transport http greenhired https://mcp.greenhired.com/mcp
- ```
- Then start `claude`, type `/mcp`, choose `greenhired` and follow the browser sign-in.
- ### Cursor (`mcp.json`)
- ```json
- {
- "mcpServers": {
- "greenhired": {
- "url": "https://mcp.greenhired.com/mcp"
- }
- }
- }
- ```
- ### ChatGPT, VS Code and other clients
- 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.
- > **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.
- ---
- ## Tools (12)
- 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.
- ### Job search
- Available to anyone who signed in with GreenHired, or to a `ghk_` key with the scope shown.
- | Tool | Changes data | What it does |
- |---|---|---|
- | `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. |
- | `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. |
- | `list_categories` (key scope `categories:read`) | No | The 28 green job categories with the number of live jobs in each. |
- ### Your account, as a job seeker
- | Tool | Permission you give | Changes data | What it does |
- |---|---|---|---|
- | `get_my_account` | any | No | Whose account this is (job seeker or employer), the company for an employer, and the permissions you gave. |
- | `get_my_profile` | `profile:read` | No | Your headline, summary, location, skills, desired roles, job search status and work mode. |
- | `update_my_profile` | `profile:write` | Yes | Change those fields. A list you send replaces the whole list. |
- | `list_my_applications` | `applications:read` | No | The jobs you applied to and where each stands (`submitted`, `reviewing`, `shortlisted`, `rejected`, `hired`, `withdrawn`), newest first. |
- | `list_my_saved_jobs` | `saved:read` | No | Your saved jobs, newest first. |
- | `save_job` | `saved:write` | Yes | Save an open job by its slug. It does not apply for the job. |
- | `unsave_job` | `saved:write` | Yes | Remove a job from your saved jobs. |
- ### Your account, as an employer
- | Tool | Permission you give | Changes data | What it does |
- |---|---|---|---|
- | `get_my_company` | `company:read` | No | Your company profile and your role in the company. |
- | `list_company_jobs` | `jobs:read` | No | Your company's jobs with title, status, dates and the number of applications. Never applicants. |
- ---
- ## Example prompts
- - "List the 28 green job categories on GreenHired and show which have the most live openings."
- - "Find remote renewable energy or ESG jobs that state a salary, and save the top three to my GreenHired account."
- - "Which of my GreenHired applications are still in review?"
- - "List our active company jobs on GreenHired and how many applications each has."
- ---
- ## Privacy, consent and what an assistant can never do
- - **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.
- - **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.
- - **Employers:** company owners decide which roles may connect an assistant and can see and remove their team's connections.
- - **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.
- - **Short-lived access:** access tokens last 60 minutes and refresh tokens 30 days and rotate.
- There is no tool, permission or endpoint for an assistant to:
- - apply to a job or message anyone;
- - read an email address, phone number, CV, cover letter, applicant, recruiter note or score;
- - change an email, password, two-factor, privacy or notification setting;
- - create, change, publish or close a job (`jobs:write` exists only for personal API keys on the account API).
- ---
- ## If something goes wrong
- - **Sign-in asked again, or a 401:** connect the assistant again.
- - **429:** wait for the time in the `Retry-After` header and try again.
- - **Anything else:** write to support@greenhired.com.
- ---
- ## More from GreenHired
- - [MCP documentation](https://greenhired.com/developers/mcp/) and [tool reference](https://greenhired.com/developers/mcp/tools/)
- - [Public jobs API](https://greenhired.com/developers/api/v1/) ([OpenAPI file for the public jobs API](https://api.greenhired.com/v1/openapi.json))
- - [API for job seekers](https://greenhired.com/candidates/api/) and [API for recruiters](https://greenhired.com/recruiters/api/)
- - [Free applicant tracking system for recruiters](https://greenhired.com/recruiters/features/ats/)
- - [Career roadmaps](https://greenhired.com/roadmaps/): ESG analyst, solar PV technician and EHS officer
- - [Privacy policy](https://greenhired.com/legal/privacy/) · [Terms of service](https://greenhired.com/legal/tos/) · [Security](https://greenhired.com/security/)
- ## Support
- - Help and bug reports: support@greenhired.com
- - A public jobs API key (`ghk_`) or an integration: partners@greenhired.com
- - Security problems: see [greenhired.com/security](https://greenhired.com/security/)
- Built and operated by [GreenHired](https://greenhired.com/).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.