MCP server

Connect your AI assistant to GreenHired with MCP

The GreenHired MCP server connects an AI assistant such as Claude to GreenHired. MCP, the Model Context Protocol, is the standard way an assistant calls outside tools. The assistant can search green jobs and, if you allow it, read or change parts of your own account. You add one address, sign in and tick what it may do, and there is no GreenHired app to install.

  • No GreenHired app to install
  • You choose each permission
  • Remove it at any time
What it does

Six things your assistant can do with GreenHired

Each one is a tool, a named action the assistant can call, such as search_jobs.

Search live jobs

Filter by category, country, work mode, employment type, seniority, pay with its currency, and how recently a job was posted. The filters match the public jobs API.

search_jobs

Read one job in full

Get the whole description as plain text, with a link back to the job on greenhired.com.

get_job

Browse 28 green categories

See every category with the number of live jobs in it, then search inside the one you want.

list_categories

Read and update your profile

Job seekers can let an assistant read their headline, skills and job search status, and change them if they allow it. Email, phone and CV are never included.

get_my_profile, update_my_profile

Track applications and saved jobs

List your applications and where each stands, and save or unsave open jobs. An assistant cannot apply for you.

list_my_applications, save_job

See your company's jobs

Employers can ask for the company profile and a list of the company's jobs with status, dates and number of applications. Applicants are not included.

get_my_company, list_company_jobs
How to connect

Connect in four steps

The screens differ a little in each assistant. The guides further down cover the main ones.

  1. 01

    Add the address

    Add https://mcp.greenhired.com/mcp to your assistant as a remote MCP server. In Claude this is a custom connector, and in ChatGPT a custom MCP server.

  2. 02

    Sign in with GreenHired

    Your assistant opens a GreenHired page. Sign in as a job seeker or an employer.

  3. 03

    Tick what it may do

    Read what the app asks for, tick the permissions you are happy with and allow it.

  4. 04

    Ask for something

    Go back to the assistant and ask in plain words. Each job it finds links to greenhired.com.

An example

Mia searches, saves and checks

Mia is a solar project engineer who lives in Leeds and wants a remote job with a German employer. She connected Claude to her job seeker account, left the pre-ticked read permissions on and ticked saving jobs. Mia and her prompts are invented. The tool names and limits come from the live server.

Mia, job seeker
  1. Find remote renewable energy jobs in Germany paying over 60,000 euros.

    The assistant calls search_jobs with a category, a work mode, a country, a minimum pay and the currency, then lists the matching jobs with links.

  2. Save the second one.

    It calls save_job. This works because Mia ticked saving jobs. Without that permission, the tool is not offered at all.

  3. Which of my applications are still in review?

    It calls list_my_applications and shows each job with its status. It cannot see her CV, cover letter or recruiter notes.

Claude shows which GreenHired tools it calls, so Mia can see what ran.

Permissions

The permissions you can tick

Job seekers see five, employers see three. Reading permissions are ticked for you, and writing permissions never are.

PermissionWhat the assistant can do
profile:readSee your profile: headline, summary, location, skills, desired roles, job search status and work mode
profile:writeEdit parts of your profile
applications:readSee the jobs you applied to and where each one stands
saved:readSee your saved jobs
saved:writeSave and unsave jobs for you
company:readEmployers: see your company profile and your role in it
jobs:readEmployers: see your company's jobs, with the number of applications each has

The jobs:write permission is for personal keys only, so an assistant cannot create or change jobs.

Limits

What an assistant cannot do

These actions have no tool, permission or endpoint, so no assistant can do them, whatever you tick.

No assistant can

  • Apply to a job or message anyone
  • Read an email address, phone number, CV or cover letter
  • See an applicant, a recruiter note or a score
  • Create, change, publish or close a job
  • Change an email, password, two-factor, privacy or notification setting
Assistants

Guides for each assistant

Any assistant that supports remote MCP servers with sign-in should be able to connect. We tested Claude on the live server on 21 November 2026. The other guides follow each vendor's own documentation, read on the same date.

For developers

Building your own agent?

Developers can point their own agent at the same server. Job search can use a public jobs API key, which the GreenHired team issues on request, and your own account data is available through the account API with a personal key.

Questions

Questions people ask

What is MCP?

MCP stands for Model Context Protocol. It is an open standard that lets an AI assistant use outside tools and data. GreenHired runs one MCP server, so an assistant that speaks MCP can search our jobs and, with your permission, use your account.

Who can use it, and do I need a developer account?

Job seekers and employers can both use it, and neither needs a developer account. You need a GreenHired account and an assistant that supports remote MCP servers. Company owners decide which roles in a company may connect an assistant.

Can an assistant apply for jobs for me?

No. There is no tool to apply, message anyone or change a job. The search tools only read, and a job seeker can also allow profile edits and saved jobs.

What does the assistant see about me, and where does it go?

Only the fields each permission lists, such as your headline and skills. Never your email address, phone number, CV, cover letter, recruiter notes or scores. What an assistant reads goes to the company that runs it, under its own terms, so tick only what you are happy to share.

Which assistants work with it?

Any assistant that supports remote MCP servers with sign-in should be able to connect. We tested Claude on the live server. The guides for ChatGPT, Cursor, Claude Code and VS Code follow each vendor's own documentation.

How do I disconnect an assistant?

Job seekers open Profile and settings, then Account, then Connected apps. Employers open Company, then Connected app. Press Remove and the assistant stops working at once.

Try it with your own assistant

Add one address, sign in and ask for a job search. You can remove the connection at any time.