Hirejack MCP README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Hirejack MCP listing page.
@hirejack/mcp
Model Context Protocol server that exposes HireJack's tech job market intelligence to MCP-compatible clients (Claude Desktop, Claude Code, Cursor, Cline, etc.) — tech jobs, companies, skills, salaries, hiring trends.
Quick start
Claude Code:
Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Restart Claude Desktop and ask away (see Example prompts).
The npm package uses stdio transport — no auth, runs locally as a subprocess, and the five public tools work out of the box.
claude.ai / Claude Desktop connector (all 31 tools): add
https://hirejack.com/api/mcp as a custom connector (Settings → Connectors →
Add custom connector), sign in with your HireJack account when prompted, and
the full Pro/Premium/Analyst intelligence surface lights up — tier-gated
server-side to your subscription.
Example prompts
Job search (public, no account):
- "Find remote senior backend roles paying $200K+ that sponsor visas"
- "What is Stripe currently hiring? Break it down by team."
- "Show me staff-level ML jobs in New York with published salary ranges"
- "Which companies are hiring Rust engineers right now?"
Market research (public, no account):
- "Which fintech companies are scaling hiring fastest this month?"
- "What skills are trending in tech right now?"
- "Compare the tech stacks of Datadog and Grafana Labs"
- "What's the median advertised salary for senior data engineers?"
Career intelligence (Pro/Premium, via the hosted connector):
- "Score my fit for this posting and tell me what's missing: hirejack.com/jobs/…"
- "Which skill should I learn next to unlock the most jobs?"
- "Where does my salary sit vs the market for staff platform engineers?"
- "Rewrite my resume bullets for this Anthropic role"
Analyst (historical/segmentation, via the hosted connector):
- "Which companies' hiring grew >50% in the last quarter from a real base?"
- "Show Nvidia's hiring trajectory over the last 12 months"
- "What skills are climbing consistently from a low base — early signals only"
Slash commands (MCP prompts)
Clients that support MCP prompts (Claude Desktop, Cursor) surface these as slash commands. All four are built only on the tools that work without an account, so they never dead-end on an auth error:
| Prompt | Arguments | What it does |
|---|---|---|
find_jobs | constraint (required) | Maps a free-form ask ("remote, $200K+, Rust") onto search_jobs filters, loosens one at a time if results are thin, pulls the strongest postings in full. |
company_deep_dive | company (required) | Resolves a name to a domain, pulls the hiring profile, then shows what is open right now. |
market_snapshot | focus (optional) | Aggregate market picture, optionally narrowed to a role, skill or city. |
salary_landscape | role_or_skill (required), location (optional) | What a role actually pays, using only postings that disclose a range. |
The hosted endpoint serves a different, personalized set (career check-ins, interview prep, match-scored role hunts) because those need an authenticated profile.
Resources
The server exposes HireJack's controlled vocabulary as MCP resources:
| URI | Contents |
|---|---|
hirejack://vocabulary/skills | Every skill HireJack extracts, with canonical name, id and category |
hirejack://vocabulary/roles | The role taxonomy: titleId, title, family, IC/management track, typical skills |
Read these before filtering. search_jobs.skill substring-matches the
canonical names, so Kubernetes returns jobs while K8s returns none — and
update_preferences.desired_roles expects titleId values from the roles
resource.
Transports
| Transport | Where | Tools available |
|---|---|---|
| stdio (this package) | npx -y @hirejack/mcp | 5 public tools (search_jobs, get_job, get_company_profile, search_companies, get_market_pulse). Pro+/Analyst tools surface but require auth — point users at the hosted endpoint. |
| HTTP + OAuth 2.1 (HireJack-hosted) | https://hirejack.com/api/mcp | All 31 tools, including Pro+/Analyst intelligence and account actions tied to a HireJack subscription. Implementation lives in HireJack's private Lambda; this OSS package is the stdio half. |
Tools
Public (no auth required):
| Tool | Purpose |
|---|---|
search_jobs | Search live tech job postings: role family, seniority, skill, location, salary, remote, visa, education, experience |
get_job | Fetch one job posting by domain + jobId or HireJack URL: full details, salary, skills, AI summary |
get_company_profile | Full hiring profile for one company (tech stack, trends, salary, AI brief) |
search_companies | List tracked companies, filter by industry |
get_market_pulse | Market-wide stats: totals, top skills, trending skills, top companies |
Pro tier (requires authenticated HireJack user with pro or higher):
| Tool | Purpose |
|---|---|
match_job | Score how well the user matches a specific job (matchPct + 5-dim breakdown + ATS tips) |
company_fit | Score the user's fit for a company (fitScore + tech-stack/role/seniority breakdown) |
recommendations | Top jobs ranked by composite match against the user's profile |
salary_benchmark | Percentile + career-ladder benchmark vs the live market for a role/seniority |
skill_gap | Compare user skills to desired-roles' market requirements; ranked missing skills |
market_position | 0–100 market-position score (skill demand, seniority fit, remote, breadth) + matching jobs, salary median, top-aligned companies |
skill_impact | Simulate learning each missing skill: jobs unlocked, boosted matches, companies needing it — ranked by impact |
watchlist_intelligence | Aggregate hiring signals across every watched company: open jobs, week-over-week trend %, top skills, median salary, sparkline |
Premium tier (requires premium):
| Tool | Purpose |
|---|---|
resume_rewrite | Bullet-by-bullet resume rewrites tailored to a specific job |
interview_prep | Targeted prep: key topics, likely questions by type, company research items |
Analyst (dedicated Analyst tier — $49/mo founding pricing; free for working journalists in exchange for a linked citation):
| Tool | Purpose |
|---|---|
get_company_history | Per-company time-series: monthly hiring snapshots + wider job-count history |
get_skill_history | Per-skill time-series: companyCount + jobMentions per month with MoM deltas |
get_market_history | Market-wide time-series: 90 days daily or 24 months monthly |
compare_companies | Up to 5 companies side-by-side: current state + monthly trajectory |
find_companies | Multi-axis segmentation: industry × family × skill × trend × job-count band |
find_breakout_companies | Companies with extreme hiring growth (% threshold + min size) |
find_emerging_skills | Skills climbing consistently across the last 3 monthly snapshots from a low base, with a real absolute company-count gain — early signal, not small-base noise (the "what should I learn before everyone else" tool) |
find_emerging_roles | Roles gaining company adoption over a tunable window (default 21 days, daily rollup) plus genuinely new titles the classifier just started seeing — the role-level companion to find_emerging_skills |
Account & profile (any authenticated HireJack account — reads and writes on the user's own data):
| Tool | Purpose |
|---|---|
save_job | Save a job to (or remove it from) the user's saved-jobs list |
watch_company | Follow (or unfollow) a company — powers watchlist intelligence, alerts, and the weekly digest |
track_application | Track an application through the pipeline: applied → phone_screen → interview → offer / rejected / withdrawn, with notes |
list_saved_jobs | List the user's saved jobs (read companion to save_job), flagging postings that have since closed |
list_applications | List tracked applications with their pipeline stage (read companion to track_application) |
list_watchlist | List watched companies (read companion to watch_company) |
get_profile | Read the user's profile: skills, desired roles, tier, and the matching preferences (seniority, city, remote, US-only, minimum salary) that hard-filter recommendations and alerts |
update_preferences | Update matching preferences from the conversation — minimum salary, require-listed-salary, remote / US-only, seniority, city — persists to the profile and re-filters everything immediately |
Unlike the website's toggle endpoints, these use explicit, idempotent
actions (state is checked first), so an agent retrying a "save" can never
silently unsave. The write tools (save_job, watch_company,
track_application, update_preferences) are annotated readOnlyHint: false so MCP clients ask for approval appropriately.
Pro+ tools are thin wrappers over the website's existing intelligence Lambdas. Tier gating happens server-side in those Lambdas — the MCP server just forwards the user's identity. If the user lacks the required tier, the API returns 403 and the tool surfaces a clear upgrade hint.
Build from source
Releasing
Publishing is automated by GitHub Actions (.github/workflows/release.yml).
Pushing a version tag builds, publishes to npm, and updates the MCP Registry:
The workflow verifies the tag matches package.json, then runs npm publish
(using the NPM_TOKEN repo secret) and a best-effort MCP Registry update via
GitHub OIDC. Keep server.json's version in step with package.json.
Configuration
| Env var | Default | Purpose |
|---|---|---|
HIREJACK_API_BASE | https://hirejack.com/api | Override if you're self-hosting a fork against a different backend |
HIREJACK_SITE_BASE | https://hirejack.com | Used in citation_url fields returned by tools |
The npm package ships the stdio transport only. The hosted HTTP+OAuth
endpoint at https://hirejack.com/api/mcp is run separately by HireJack
and not implemented in this repo.
Project layout
License
MIT — see LICENSE.
Support
- Issues / feature requests: https://github.com/TVLSS/hirejack-mcp/issues
- General feedback: https://hirejack.com/feedback.html
- Site / product: https://hirejack.com