{
  "markdown": "# @hirejack/mcp\n\nModel Context Protocol server that exposes HireJack's tech job market\nintelligence to MCP-compatible clients (Claude Desktop, Claude Code, Cursor,\nCline, etc.) — tech jobs, companies, skills, salaries, hiring trends.\n\n[![npm](https://img.shields.io/npm/v/@hirejack/mcp.svg)](https://www.npmjs.com/package/@hirejack/mcp)\n[![Glama score](https://glama.ai/mcp/servers/TVLSS/hirejack-mcp/badges/score.svg)](https://glama.ai/mcp/servers/TVLSS/hirejack-mcp)\n\n## Quick start\n\n**Claude Code:**\n\n```bash\nclaude mcp add hirejack -- npx -y @hirejack/mcp\n```\n\n**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`\n(macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"hirejack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@hirejack/mcp\"]\n    }\n  }\n}\n```\n\nRestart Claude Desktop and ask away (see [Example prompts](#example-prompts)).\n\nThe npm package uses **stdio transport** — no auth, runs locally as a\nsubprocess, and the five public tools work out of the box.\n\n**claude.ai / Claude Desktop connector (all 31 tools):** add\n`https://hirejack.com/api/mcp` as a custom connector (Settings → Connectors →\nAdd custom connector), sign in with your HireJack account when prompted, and\nthe full Pro/Premium/Analyst intelligence surface lights up — tier-gated\nserver-side to your subscription.\n\n## Example prompts\n\n**Job search (public, no account):**\n\n- *\"Find remote senior backend roles paying $200K+ that sponsor visas\"*\n- *\"What is Stripe currently hiring? Break it down by team.\"*\n- *\"Show me staff-level ML jobs in New York with published salary ranges\"*\n- *\"Which companies are hiring Rust engineers right now?\"*\n\n**Market research (public, no account):**\n\n- *\"Which fintech companies are scaling hiring fastest this month?\"*\n- *\"What skills are trending in tech right now?\"*\n- *\"Compare the tech stacks of Datadog and Grafana Labs\"*\n- *\"What's the median advertised salary for senior data engineers?\"*\n\n**Career intelligence (Pro/Premium, via the hosted connector):**\n\n- *\"Score my fit for this posting and tell me what's missing: hirejack.com/jobs/…\"*\n- *\"Which skill should I learn next to unlock the most jobs?\"*\n- *\"Where does my salary sit vs the market for staff platform engineers?\"*\n- *\"Rewrite my resume bullets for this Anthropic role\"*\n\n**Analyst (historical/segmentation, via the hosted connector):**\n\n- *\"Which companies' hiring grew >50% in the last quarter from a real base?\"*\n- *\"Show Nvidia's hiring trajectory over the last 12 months\"*\n- *\"What skills are climbing consistently from a low base — early signals only\"*\n\n## Slash commands (MCP prompts)\n\nClients that support MCP prompts (Claude Desktop, Cursor) surface these as\nslash commands. All four are built **only** on the tools that work without an\naccount, so they never dead-end on an auth error:\n\n| Prompt | Arguments | What it does |\n|--------|-----------|--------------|\n| `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. |\n| `company_deep_dive` | `company` (required) | Resolves a name to a domain, pulls the hiring profile, then shows what is open right now. |\n| `market_snapshot` | `focus` (optional) | Aggregate market picture, optionally narrowed to a role, skill or city. |\n| `salary_landscape` | `role_or_skill` (required), `location` (optional) | What a role actually pays, using only postings that disclose a range. |\n\nThe hosted endpoint serves a different, personalized set (career check-ins,\ninterview prep, match-scored role hunts) because those need an authenticated\nprofile.\n\n## Resources\n\nThe server exposes HireJack's controlled vocabulary as MCP resources:\n\n| URI | Contents |\n|-----|----------|\n| `hirejack://vocabulary/skills` | Every skill HireJack extracts, with canonical name, id and category |\n| `hirejack://vocabulary/roles` | The role taxonomy: titleId, title, family, IC/management track, typical skills |\n\nRead these before filtering. `search_jobs.skill` substring-matches the\ncanonical names, so `Kubernetes` returns jobs while `K8s` returns none — and\n`update_preferences.desired_roles` expects `titleId` values from the roles\nresource.\n\n## Transports\n\n| Transport | Where | Tools available |\n|-----------|-------|-----------------|\n| **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. |\n| **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. |\n\n## Tools\n\n**Public** (no auth required):\n\n| Tool | Purpose |\n|------|---------|\n| `search_jobs` | Search live tech job postings: role family, seniority, skill, location, salary, remote, visa, education, experience |\n| `get_job` | Fetch one job posting by domain + jobId or HireJack URL: full details, salary, skills, AI summary |\n| `get_company_profile` | Full hiring profile for one company (tech stack, trends, salary, AI brief) |\n| `search_companies` | List tracked companies, filter by industry |\n| `get_market_pulse` | Market-wide stats: totals, top skills, trending skills, top companies |\n\n**Pro tier** (requires authenticated HireJack user with `pro` or higher):\n\n| Tool | Purpose |\n|------|---------|\n| `match_job` | Score how well the user matches a specific job (matchPct + 5-dim breakdown + ATS tips) |\n| `company_fit` | Score the user's fit for a company (fitScore + tech-stack/role/seniority breakdown) |\n| `recommendations` | Top jobs ranked by composite match against the user's profile |\n| `salary_benchmark` | Percentile + career-ladder benchmark vs the live market for a role/seniority |\n| `skill_gap` | Compare user skills to desired-roles' market requirements; ranked missing skills |\n| `market_position` | 0–100 market-position score (skill demand, seniority fit, remote, breadth) + matching jobs, salary median, top-aligned companies |\n| `skill_impact` | Simulate learning each missing skill: jobs unlocked, boosted matches, companies needing it — ranked by impact |\n| `watchlist_intelligence` | Aggregate hiring signals across every watched company: open jobs, week-over-week trend %, top skills, median salary, sparkline |\n\n**Premium tier** (requires `premium`):\n\n| Tool | Purpose |\n|------|---------|\n| `resume_rewrite` | Bullet-by-bullet resume rewrites tailored to a specific job |\n| `interview_prep` | Targeted prep: key topics, likely questions by type, company research items |\n\n**Analyst** (dedicated [Analyst tier](https://hirejack.com/analyst/) — $49/mo founding pricing; free for working journalists in exchange for a linked citation):\n\n| Tool | Purpose |\n|------|---------|\n| `get_company_history` | Per-company time-series: monthly hiring snapshots + wider job-count history |\n| `get_skill_history` | Per-skill time-series: companyCount + jobMentions per month with MoM deltas |\n| `get_market_history` | Market-wide time-series: 90 days daily or 24 months monthly |\n| `compare_companies` | Up to 5 companies side-by-side: current state + monthly trajectory |\n| `find_companies` | Multi-axis segmentation: industry × family × skill × trend × job-count band |\n| `find_breakout_companies` | Companies with extreme hiring growth (% threshold + min size) |\n| `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) |\n| `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` |\n\n**Account & profile** (any authenticated HireJack account — reads and writes on the user's own data):\n\n| Tool | Purpose |\n|------|---------|\n| `save_job` | Save a job to (or remove it from) the user's saved-jobs list |\n| `watch_company` | Follow (or unfollow) a company — powers watchlist intelligence, alerts, and the weekly digest |\n| `track_application` | Track an application through the pipeline: applied → phone_screen → interview → offer / rejected / withdrawn, with notes |\n| `list_saved_jobs` | List the user's saved jobs (read companion to `save_job`), flagging postings that have since closed |\n| `list_applications` | List tracked applications with their pipeline stage (read companion to `track_application`) |\n| `list_watchlist` | List watched companies (read companion to `watch_company`) |\n| `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 |\n| `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 |\n\nUnlike the website's toggle endpoints, these use explicit, idempotent\nactions (state is checked first), so an agent retrying a \"save\" can never\nsilently unsave. The write tools (`save_job`, `watch_company`,\n`track_application`, `update_preferences`) are annotated `readOnlyHint:\nfalse` so MCP clients ask for approval appropriately.\n\nPro+ tools are thin wrappers over the website's existing intelligence\nLambdas. Tier gating happens server-side in those Lambdas — the MCP server\njust forwards the user's identity. If the user lacks the required tier,\nthe API returns 403 and the tool surfaces a clear upgrade hint.\n\n\n## Build from source\n\n```bash\ngit clone https://github.com/TVLSS/hirejack-mcp\ncd hirejack-mcp\nnpm install\nnpm run build       # tsc → dist/\nnode dist/index.js  # waits on stdin/stdout for JSON-RPC\n```\n\n## Releasing\n\nPublishing is automated by GitHub Actions (`.github/workflows/release.yml`).\nPushing a version tag builds, publishes to npm, and updates the MCP Registry:\n\n```bash\nnpm version patch          # bumps package.json + creates the vX.Y.Z tag\ngit push && git push --tags\n```\n\nThe workflow verifies the tag matches `package.json`, then runs `npm publish`\n(using the `NPM_TOKEN` repo secret) and a best-effort MCP Registry update via\nGitHub OIDC. Keep `server.json`'s `version` in step with `package.json`.\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `HIREJACK_API_BASE` | `https://hirejack.com/api` | Override if you're self-hosting a fork against a different backend |\n| `HIREJACK_SITE_BASE` | `https://hirejack.com` | Used in `citation_url` fields returned by tools |\n\nThe npm package ships the stdio transport only. The hosted HTTP+OAuth\nendpoint at `https://hirejack.com/api/mcp` is run separately by HireJack\nand not implemented in this repo.\n\n## Project layout\n\n```\nsrc/\n├── index.ts            # stdio entry point\n├── registry.ts         # transport-agnostic tool registry\n├── prompts.ts          # slash commands (public-tool-only by design)\n├── resources.ts        # controlled vocabulary (skills, roles)\n├── lib/\n│   ├── api.ts          # HireJack REST client\n│   ├── format.ts       # tool result helpers\n│   └── proAuth.ts      # Pro+ auth check (returns \"use hosted endpoint\" in stdio)\n└── tools/              # 29 files, 31 registered tools\n```\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\n## Support\n\n- Issues / feature requests: https://github.com/TVLSS/hirejack-mcp/issues\n- General feedback: https://hirejack.com/feedback.html\n- Site / product: https://hirejack.com\n",
  "bytes": 11816,
  "sha": "754519a2dc657a70a97a1e154407f406cc947fd6de25eb40af89e22839807171",
  "repo_slug": "tvlss/hirejack-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tvlss_hirejack_mcp_e9c2f95b/readme"
}