hirejack mcp

@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 mcp add hirejack -- npx -y @hirejack/mcp

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "hirejack": {
      "command": "npx",
      "args": ["-y", "@hirejack/mcp"]
    }
  }
}

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

git clone https://github.com/TVLSS/hirejack-mcp
cd hirejack-mcp
npm install
npm run build       # tsc → dist/
node dist/index.js  # waits on stdin/stdout for JSON-RPC

Releasing

Publishing is automated by GitHub Actions (.github/workflows/release.yml). Pushing a version tag builds, publishes to npm, and updates the MCP Registry:

npm version patch          # bumps package.json + creates the vX.Y.Z tag
git push && git push --tags

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

src/
├── index.ts            # stdio entry point
├── registry.ts         # transport-agnostic tool registry
├── prompts.ts          # slash commands (public-tool-only by design)
├── resources.ts        # controlled vocabulary (skills, roles)
├── lib/
│   ├── api.ts          # HireJack REST client
│   ├── format.ts       # tool result helpers
│   └── proAuth.ts      # Pro+ auth check (returns "use hosted endpoint" in stdio)
└── tools/              # 29 files, 31 registered tools

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