# What is an MCP job search server, and how does Openings work?

*Updated 21 September 2026 · Avagama Consulting · https://avagama.co/openings/blog/what-is-an-mcp-job-search-server/*

**Short answer:** the Model Context Protocol lets an AI assistant call outside tools. Openings is an MCP server for job search: seven read-only tools over 469,607 live postings read from employers' own boards, at `https://openings.avagama.co/mcp`.

## The seven tools

| Tool | What it does |
| --- | --- |
| prepare_job_search | Builds or refreshes the index for your countries and reports what it holds |
| get_job_coverage | Says how many employers and roles exist for a country |
| search_jobs | Keyword search by title and employer, with country, city and remote filters |
| recommend_jobs | Ranks roles against a resume, in direct, hidden and stretch groups |
| analyze_job_fit | Explains one role against verbatim resume evidence |
| optimize_resume | Proposes grounded changes and a diff |
| get_job | Fetches one posting in full, with the application link |

## Freshness

Results start with the last seven days and widen to 14, then 30, then everything, only when a week is thin, and say when they widened. Each role carries its age and whether the date came from the employer or from our first sighting.

## Two ways to run it

| | On your machine | Hosted connector |
| --- | --- | --- |
| Install | `bun add --global openings` | Paste one address |
| Account | None | Email and a six-digit code |
| Index | Built and stored locally | Shared, refreshed centrally |
| Resume | Parsed in memory, never written to disk | Sent, used once, discarded |

## What it will not do

- No applying: every tool is read-only.
- No invented experience in resume suggestions.
- No completeness claim: coverage is reported before you share a resume.
- No crawling where robots rules or terms forbid it.

## Common questions

### What is MCP?

The Model Context Protocol is an open standard that lets an AI assistant call outside tools and read outside data. An MCP server publishes a set of tools; an app such as Claude, ChatGPT, Cursor or VS Code connects to it and the assistant can then use them during a conversation.

### What is an MCP job search server?

It is an MCP server whose tools search job postings. Openings publishes seven: prepare a search for your countries, report coverage, search by keyword, recommend roles against a resume, analyse fit for one role, suggest resume improvements, and fetch one posting in full.

### How is that different from a job board?

A job board is a website you read. An MCP server is a source your assistant can query while reasoning, so it can compare a resume against hundreds of postings and explain each match with quoted evidence rather than leaving you to read them all.

### Where do the postings come from?

From employers' own boards: Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Workable, Breezy, Freshteam, Keka, Zoho Recruit, Oracle Cloud Recruiting, and company career sites that publish structured job data. Every link opens the employer's own posting.

### Is my resume stored anywhere?

No. Run locally, the resume is parsed in memory for one request and never written to disk. Through the hosted connector it is sent to the server, used for that request and discarded. Nothing derived from it is kept except anonymous skill and title words, which you can turn off.

### Can it apply to jobs for me?

No, and it is built so it cannot. All seven tools are read-only and declare themselves as such, so an app can auto-approve them safely.

## For agents

- Site index for language models: https://avagama.co/llms.txt
- Live counts: https://avagama.co/openings/jobs/summary.json
- Connector: https://openings.avagama.co/mcp