Odel
hirejack mcp

hirejack mcp

@tvlssDeveloper ToolsTypeScriptMITUpdated 3w ago

Tech job market intelligence: jobs, companies, salaries, skill velocity, hiring trends.

Server endpointStreamable HTTP

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

@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.

npm

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. Then try:

  • "Find remote senior backend roles paying $200K+ that sponsor visas"
  • "What is Stripe currently hiring?"
  • "Which fintech companies are scaling fastest?"
  • "What skills are trending in tech right now?"

The npm package uses stdio transport — no auth, runs locally as a subprocess. The public tools work out of the box. Pro+ intelligence tools (match_job, company_fit, resume_rewrite, etc.) require an authenticated user; for that you'll want the hosted HTTP transport at https://hirejack.com/api/mcp once the claude.ai connector regression is resolved (see below).

Why stdio first? The hosted HTTP transport at https://hirejack.com/api/mcp works end-to-end via direct API (curl/SDK), but claude.ai's web connector and Claude Desktop's remote MCP UI have an upstream auth-handshake regression that drops the connection after OAuth succeeds. Stdio sidesteps the bug entirely. Tracking: anthropics/claude-ai-mcp#136.

Transports

TransportWhereTools available
stdio (this package)npx -y @hirejack/mcp5 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/mcpAll 22 tools, including Pro+/Analyst intelligence tied to a HireJack subscription. Implementation lives in HireJack's private Lambda; this OSS package is the stdio half.

Tools

Public (no auth required):

ToolPurpose
search_jobsSearch live tech job postings: role family, seniority, skill, location, salary, remote, visa
get_jobFetch one job posting by domain + jobId or HireJack URL: full details, salary, skills, AI summary
get_company_profileFull hiring profile for one company (tech stack, trends, salary, AI brief)
search_companiesList tracked companies, filter by industry
get_market_pulseMarket-wide stats: totals, top skills, trending skills, top companies

Pro tier (requires authenticated HireJack user with pro or higher):

ToolPurpose
match_jobScore how well the user matches a specific job (matchPct + 5-dim breakdown + ATS tips)
company_fitScore the user's fit for a company (fitScore + tech-stack/role/seniority breakdown)
recommendationsTop jobs ranked by composite match against the user's profile
salary_benchmarkPercentile + career-ladder benchmark vs the live market for a role/seniority
skill_gapCompare user skills to desired-roles' market requirements; ranked missing skills
market_position0–100 market-position score (skill demand, seniority fit, remote, breadth) + matching jobs, salary median, top-aligned companies
skill_impactSimulate learning each missing skill: jobs unlocked, boosted matches, companies needing it — ranked by impact
watchlist_intelligenceAggregate hiring signals across every watched company: open jobs, week-over-week trend %, top skills, median salary, sparkline

Premium tier (requires premium):

ToolPurpose
resume_rewriteBullet-by-bullet resume rewrites tailored to a specific job
interview_prepTargeted prep: key topics, likely questions by type, company research items

Analyst (Pro+ tier today; will tighten to a dedicated analyst tier when that pricing plan ships):

ToolPurpose
get_company_historyPer-company time-series: monthly hiring snapshots + wider job-count history
get_skill_historyPer-skill time-series: companyCount + jobMentions per month with MoM deltas
get_market_historyMarket-wide time-series: 90 days daily or 24 months monthly
compare_companiesUp to 5 companies side-by-side: current state + monthly trajectory
find_companiesMulti-axis segmentation: industry × family × skill × trend × job-count band
find_breakout_companiesCompanies with extreme hiring growth (% threshold + min size)
find_emerging_skillsSkills 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)

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 varDefaultPurpose
HIREJACK_API_BASEhttps://hirejack.com/apiOverride if you're self-hosting a fork against a different backend
HIREJACK_SITE_BASEhttps://hirejack.comUsed 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
├── lib/
│   ├── api.ts          # HireJack REST client
│   ├── format.ts       # tool result helpers
│   └── proAuth.ts      # Pro+ auth check (returns "use hosted endpoint" in stdio)
└── tools/              # 22 tool implementations

License

MIT — see LICENSE.

Support