job-search-mcp
The job-search-mcp server is a personal job-search assistant that searches real job boards, scores jobs for your fit, and lets you triage them in an interactive ranked board — all from an MCP client like Claude Desktop.
Search for jobs: Query live boards including LinkedIn, Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, and Remotive, with filters for location, seniority, job type, remote preference, salary, recency, and applicant count.
Save your profile: Paste your resume to extract and store your name, skills, target roles, location, years of experience, remote preference, and blocked companies — used to personalize search and scoring.
Score jobs for fit: Automatically or manually assign each job a 0–100 fit score with a one-line reason, calibrated against your profile.
Display an interactive board: Render a ranked, clickable job board with score, reason, and Apply/Skip buttons per card, or switch to the saved/applied tracker view.
Triage individually: Mark a single job as saved, applied, dismissed, or discovered, with optional notes.
Bulk triage: Dismiss, save, or apply to many jobs at once by score threshold (e.g., dismiss everything under 60) or by source.
Review the board: List all current jobs — scored and unscored — with IDs and descriptions, or view your saved/applied tracker as text.
Re-score the board: Wipe existing scores and re-evaluate every job from scratch, optionally including saved/applied jobs.
Clear jobs: Remove unscored leftovers or wipe the entire board without affecting your applied/dismissed history.
Data persistence: Triage decisions are stored locally; dismissed jobs won't reappear for six months.
Optional LinkedIn Premium integration: Connect via cookies for richer data, with a guest-mode fallback.
Searches and evaluates job listings from Greenhouse's ATS, providing fit scores and triage capabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@job-search-mcp find senior backend engineer jobs in California"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
job-search-mcp
A personal job-search assistant for Claude Desktop. You ask Claude to find jobs; it searches the real job boards, scores each one 0–100 for how well it fits you, and shows them on a ranked board you can triage with one click. Everything runs locally — no API keys, no accounts required.
It's an MCP App: a small server Claude Desktop talks to, plus an inline board that renders right in the chat.
Scope: it's tuned for US software-engineering roles (the built-in sources and role filters target US tech employers). Other fields or regions will return sparse results.
Works in: built and tested for Claude Desktop. It should also work in other MCP clients that both run a local (stdio) server and render MCP App UIs, such as VS Code (Copilot), Cursor, or Goose (untested). Remote-only clients (ChatGPT, Claude on web/mobile) can't launch a local server, so they won't work.

What it does
Searches real job boards — LinkedIn plus 8 ATS/job sources (Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, Remotive), using your target roles and location.
Scores each job for you — Claude reads the full description and gives it a 0–100 fit score with a one-line reason, weighing your skills, years of experience, seniority fit, and the role.
Lets you triage fast — Apply / Skip on each card, or in bulk ("dismiss everything under 60").
Remembers — keeps a running shortlist, a tracker of what you've applied to, and won't show you the same job twice (for 6 months).
Related MCP server: Jobless MCP
Setup
1. Tell Claude Desktop about it. Open your config file:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Add this under "mcpServers" — npx fetches the published package
for you, no cloning or building required:
{
"mcpServers": {
"job-search": {
"command": "npx",
"args": ["-y", "@servation/job-search-mcp"]
}
}
}2. Fully quit and reopen Claude Desktop (on Windows, quit it from the system tray — closing the window isn't enough). That's it.
npm install
npm run buildThen point the config at this folder's dist/main.js instead:
{
"mcpServers": {
"job-search": {
"command": "node",
"args": ["D:\\job-search-mcp\\dist\\main.js"]
}
}
}How to use it
Just talk to Claude. For example:
"Save my profile" — paste your resume first; Claude pulls out your skills, roles, years, and location so searches and scoring are tailored to you.
"Find backend engineer jobs in California, senior level, posted this week."
"Find low-applicant jobs" — adds LinkedIn's early-applicant filter.
"Dismiss everything under 60."
"Show what I've applied to."
"Re-score the board."
A typical first run: save your profile → "find jobs" → Claude scores them and shows the ranked board → you Apply/Skip.
The board
The board is a running shortlist. A job stays on it until you Apply (moves to your tracker) or Skip (hidden for good). New searches automatically skip jobs already on the board, in your tracker, dismissed, or shown in the last 6 months — so you never see the same listing twice in a row.
Click Applied or Skip on a card, or ask Claude to do it. Triaged in the widget, it sticks.
Tools (for reference)
You rarely call these by name — Claude picks the right one — but here's what's under the hood:
Tool | What it does |
| Search the boards for your roles/location (with optional filters: seniority, type, recency, remote, salary, applicants, source). |
| Claude scores the found jobs 0–100 for fit (runs automatically after a search). |
| Display the ranked board (or your |
| Apply / Skip / save a single job (also the card buttons). |
| Triage many at once by score or source, e.g. dismiss everything under 60. |
| List the current board as text (all scored jobs + anything still unscored). |
| Your tracker — jobs you've saved or applied to. |
| Re-score every job on the board from scratch. |
| Declutter: clear unscored leftovers or the whole board (never touches applied/dismissed). |
| Save your resume profile (drives search + scoring). |
Where your data lives
One JSON file on your machine — no cloud, nothing sent anywhere except the job boards you search:
Installed:
~/.job-search-mcp/jobs.jsonRunning from source:
./data/jobs.jsonOverride with the
JOB_SEARCH_MCP_DATAenvironment variable.
Optional: LinkedIn Premium mode
By default LinkedIn uses its public guest endpoints: no login and no account-login risk, and you
already get full job descriptions. Note that automated access still runs from your own IP and is against
LinkedIn's User Agreement even in guest mode, so use it at your discretion. If you want richer/Premium
data, you can use your logged-in account by adding an env block to the server config:
"job-search": {
"command": "npx",
"args": ["-y", "@servation/job-search-mcp"],
"env": {
"LINKEDIN_LI_AT": "<your li_at cookie>",
"LINKEDIN_JSESSIONID": "ajax:1234567890123456789"
}
}Get both cookies from a logged-in linkedin.com tab → DevTools → Application → Cookies.
⚠️ Heads up: this is against LinkedIn's Terms of Service and can get your account flagged or restricted. The cookies also expire about monthly and LinkedIn's internal endpoints change without notice. If anything fails it falls back to guest mode automatically. Leave the
envblock out to stay fully safe (guest-only).
How scoring works
Claude (the host model) does the scoring directly — it reads each description and judges fit, which is
well-calibrated. A deterministic formula (computeMatchScore in scoring.ts) is kept as a fallback for
anyone running a weaker local model that tends to over-rank everything; it's not active by default.
Development
npm run typecheck # type-check UI + server + harness
npm run build # build the UI bundle (vite single-file) + compile the server (tsc)
npm run serve:stdio # run the server from source (tsx) for local testing
npm run harness # work on the review UI without Claude Desktop (see harness/)
npm run canary # check every job source is still returning postingsThe server is stdio-only (main.ts → server.ts); the UI is a React app bundled to a single inlined
HTML file (src/mcp-app.tsx → dist/mcp-app.html) that the server serves as a ui:// resource.
Working on the UI, use harness/. It is a local stand-in for Claude Desktop that renders
the widget against a synthetic job store and a real ui/* bridge. Opening dist/mcp-app.html in a
browser tab just gets you "Connecting…", and the things most likely to break (link opening, theming,
the post-mount refresh) are all host-mediated, so they only show up with a host on the other end.
If a job source goes dark, npm run canary tells you which one. Company slugs rot often, so the fix
usually belongs in the remote slug registry that updateCompanyDirectoriesFromRegistry() re-reads at
runtime, rather than in a new release.
Available Tools
10 toolsbulk_statusBulk TriageA
Triage MANY board jobs at once by score and/or source — e.g. dismiss every scored job under 60. Applies status to all scanned (board) jobs matching the filters; the server selects them, so you do NOT need the individual job ids. below_score/above_score match SCORED jobs only (use clear_jobs for un-evaluated ones). Provide at least one filter. Returns text; call show_board afterward to display.
Inputs: status (required), notes, source, above_score, +1 more.
clear_jobsClear JobsA
Clear jobs from the review board. which='unscored' (default) removes only the not-yet-evaluated leftovers; which='all' clears the whole board. Saved/applied jobs (the tracker) and dismissed jobs are NOT affected — dismissed jobs still won't be re-sourced. Returns text; call show_board to display.
Inputs: which.
evaluate_jobsEvaluate JobsA
Score one or more sourced jobs for THIS candidate (holistic). YOU assign each job a 0-100 fit score directly, using the candidate summary (shown in find_jobs / whats_promising) and the job description. Weigh the must-have requirements, the candidate's actual skills and years of experience (a role demanding far more seniority/years than the candidate has should score LOWER), domain fit, and standout strengths. Calibrate and use the FULL range — do not bunch everything at 80+: 80-100 = strong fit and realistic; 60-79 = good with real gaps; 40-59 = partial/stretch (e.g. wrong level); below 40 = poor or wrong field. Pass { job_id, score, reason } per job. Use the EXACT bracketed ids; do not invent them. Score every job in one call. Returns text; call show_board afterward to display the ranked board.
Inputs: evaluations (required).
find_jobsFind JobsA
Source live jobs (LinkedIn + Greenhouse, Lever, Ashby, Workday, SmartRecruiters, Hacker News, RemoteOK, Remotive), dedup them, and return them as text with full descriptions. Uses the saved profile's roles/location by default; pass query/location/filters to override. This returns UNSCORED jobs and does NOT show a card UI — immediately score all of them with evaluate_jobs (a 0-100 fit score + reason each), then show_board once, to present the single ranked board. Do not just list them back.
Inputs: limit, query, remote, sort_by, +9 more.
rescore_boardRe-score BoardA
Re-score the WHOLE board from scratch — every job, INCLUDING ones that already have a score. Use this when the user asks to 'rescore'/'re-evaluate' the board or after the scoring approach changed. Returns all board jobs with their ids + descriptions; call evaluate_jobs with a FRESH { job_id, score, reason } for EACH (do not skip already-scored ones), then call show_board. Set include_saved=true to also re-score the saved/applied tracker.
Inputs: include_saved.
review_savedReview Saved JobsA
List the tracker as text: jobs marked saved (interested) or applied, with their status, score, and notes. Use this to see what you're tracking or have applied to. To DISPLAY the tracker widget, call show_board with view='saved'.
Inputs: no named parameters.
save_profileSave Resume ProfileA
Extract the candidate's profile from their resume text (which the user pastes in chat) and save it. Pull: full name; core technical skills; suggested target roles; preferred/search location; total years of professional experience (integer); and pass the resume text as rawText. The profile is used by find_jobs (target roles + location) and by scoring (years of experience drives the experience penalty), so set yearsOfExperience accurately. Merges with any existing profile.
Inputs: name, skills, rawText, targetRoles, +4 more.
set_statusSet Job StatusA
Triage a job by id: 'saved' (interested/tracking), 'applied' (also stamps the date), 'dismissed' (skip), or 'discovered' (undo back to the board). Moves it between the scanned/saved/dismissed lists and persists. Optionally attach notes. Called by the review UI; also usable directly.
Inputs: job_id (required), status (required), notes. Returns: jobs, view, count, scored, +1 more
show_boardShow BoardA
Display the job board (or the saved/applied tracker) as an interactive widget. Call this ONCE, at the end of a request, after doing the work (find_jobs/evaluate_jobs/bulk_status/clear_jobs/whats_promising are text-only and do NOT render). view='board' (default) shows the ranked board; view='saved' shows the tracker.
Inputs: view. Returns: jobs, view, count, scored, +1 more
whats_promisingWhat's PromisingA
List the current job board as text: every scored job (with its id) and any UNSCORED jobs with their ids + descriptions so you can evaluate them. To score the unscored ones, call evaluate_jobs with the EXACT bracketed ids shown. Use this to review jobs already found (find_jobs only returns brand-new ones). To re-score jobs that ALREADY have a score, use rescore_board instead. To DISPLAY the board widget to the user, call show_board (this returns text for you to act on).
Inputs: limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clearly distinct purpose: bulk_status for bulk triage, clear_jobs for clearing, evaluate_jobs for scoring single jobs, find_jobs for sourcing, rescore_board for re-evaluating all, review_saved for tracker text, save_profile for profile, set_status for individual triage, show_board for display, and whats_promising for listing. No overlap.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., bulk_status, evaluate_jobs, save_profile). The only minor deviation is 'whats_promising' using a contraction, but it still follows the pattern and is easily readable.
10 tools is well within the ideal 3-15 range for a focused job search server. Each tool addresses a necessary function without bloat, and the count feels natural for the domain.
The tool set covers the core workflow: sourcing (find_jobs), scoring (evaluate_jobs, rescore_board), triaging (bulk_status, set_status, clear_jobs), tracking (review_saved), display (show_board), and profile management (save_profile). Minor gaps like no explicit profile update tool exist, but save_profile merges, so it's almost complete.
Maintenance
Related MCP Connectors
AI job matching in your assistant: ranked offers, tailored resumes, application tracking.
Run your job search from your AI assistant. Career Rift gives every job its own resume, then works out the fit score, interview prep and cover letter from it, while your inbox keeps the job board current. Track applications, companies, notes, calendar events and profiles in plain language.
Tailor resumes, score ATS fit, find hiring leads, and send cold outreach, from your agent.
Job search for your AI: save jobs, research companies, keep stories, track applications.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables job search and scraping across multiple job boards (LinkedIn, Indeed, Glassdoor, etc.) with advanced filtering, directly from Claude Desktop or other MCP clients.6MIT
- AlicenseNot gradedqualityBmaintenancePersonalized job search inside Claude. Get ranked job matches based on your actual skills, not keywords.2MIT
- AlicenseAqualityDmaintenanceTransforms Claude into an AI job-hunting assistant that searches remote job boards, scores roles against your CV, generates tailored cover letters, and logs everything to a Notion tracker.11MIT
- AlicenseNot gradedqualityDmaintenanceEnables searching and evaluating job postings from LinkedIn and freehire.me directly through Claude Desktop. Provides tools to search jobs, fetch full posting details, and assess candidate fit using eligibility scans and a scoring rubric.MIT