# GreenHired MCP server

> Connect an AI assistant to GreenHired: search green jobs, or let it work with your own account inside the permissions you choose. Remote MCP, no install.

- Source: https://greenhired.com/developers/mcp/
- Section: GreenHired developers · MCP server · Start here
- Last updated: 2026-11-21

## What it is

The GreenHired MCP server lets an AI assistant such as Claude, ChatGPT or Cursor search green jobs and, if you allow it, work with your own GreenHired account. It is a **remote** Model Context Protocol server at `https://mcp.greenhired.com/mcp`, so there is nothing to install: you give the address to your assistant.

There are two ways in. Most people use the first.

|  | Sign in with GreenHired | API key |
| --- | --- | --- |
| Credential | You sign in on greenhired.com and choose permissions. The assistant gets a token that starts with `ghat_` | A `ghk_` key issued by the GreenHired team |
| Tools | Your account tools (job seeker or employer) and the three job search tools | `search_jobs`, `get_job` and `list_categories` |
| Who it is for | A job seeker or an employer connecting their own assistant | A developer building an agent over public jobs |
| Where you go next | [Connect an assistant](https://greenhired.com/developers/mcp/quickstart/) | [Authentication](https://greenhired.com/developers/mcp/authentication/) |

## What an assistant can do

- **Anyone who signs in:** search public jobs, read one job, list the 28 categories.
- **Job seekers:** read your profile, applications and saved jobs; update your headline, skills and job search status; save and unsave jobs.
- **Employers:** read your company profile and list your company's jobs.

Things you can say: "Find remote renewable energy jobs in Germany paying over 60,000 euros." "Save the second one." "Which of my applications are still in review?" "List my company's active jobs."

> **Tip:** Tested end to end with Claude. Other clients that follow the MCP authorization standard should work, and the guides for them follow each vendor's own documentation as read on 21 November 2026. If one does not work, tell us at [support@greenhired.com](mailto:support@greenhired.com).

> **Info:** There is deliberately **no tool** to apply to a job, message anyone, see an applicant, change your email or password, or publish or change a job. An assistant only does what each permission you tick allows. See [Security and what assistants cannot do](https://greenhired.com/developers/mcp/security/).

## Connect

| Assistant | Guide |
| --- | --- |
| Claude (web, desktop) | [Connect Claude](https://greenhired.com/developers/mcp/claude/) |
| Claude Code | [Connect Claude Code](https://greenhired.com/developers/mcp/claude-code/) |
| ChatGPT | [Connect ChatGPT](https://greenhired.com/developers/mcp/chatgpt/) |
| Cursor | [Connect Cursor](https://greenhired.com/developers/mcp/cursor/) |
| VS Code, MCP Inspector, anything else | [Other clients](https://greenhired.com/developers/mcp/other-clients/) |

## Frequently asked questions

**Do I need a developer account?**

No. To connect your own assistant you only need a GreenHired account (job seeker or employer). Sign in when the assistant asks, and choose what it may do.

**Is it read-only?**

The job search tools are read-only. A job seeker can also let an assistant update parts of their profile and save jobs, if they tick those permissions. Nothing can apply, message, publish jobs or touch applicants.

**Which protocol version does it use?**

MCP 2025-03-26 over Streamable HTTP in its simplest, stateless form: one JSON-RPC message per POST, one JSON answer. See [Protocol notes](https://greenhired.com/developers/mcp/protocol/).

**How do I remove an assistant?**

Open the Connected apps page of your account and press Remove. It stops at once. Changing your password removes every connected app.

## Related pages

- https://greenhired.com/developers/mcp/quickstart/
- https://greenhired.com/developers/mcp/tools/
- https://greenhired.com/developers/mcp/security/
