MCP server · Start here

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.

2 min read Updated Maintained by the GreenHired team
View Markdown
On this page
  1. What it is
  2. What an assistant can do
  3. Connect
  4. Frequently asked questions

#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.

ItemSign in with GreenHiredAPI key
CredentialYou 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
ToolsYour account tools (job seeker or employer) and the three job search toolssearch_jobs, get_job and list_categories
Who it is forA job seeker or an employer connecting their own assistantA developer building an agent over public jobs
Where you go nextConnect an assistantAuthentication

#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."

#Connect

AssistantGuide
Claude (web, desktop)Connect Claude
Claude CodeConnect Claude Code
ChatGPTConnect ChatGPT
CursorConnect Cursor
VS Code, MCP Inspector, anything elseOther 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.
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.