Agentic job hunt: scan careers pages, score against your resume, draft applications. Never applies.
io.github.tarunlnmiit/autopilot-jobhunt (MCP) Server
The MCP server “autopilot-jobhunt” is an agentic job-hunting service that scans company careers pages, scores roles against a user’s resume using an LLM, and drafts tailored materials. It can send top matches to the user via Telegram and produces resume/cover-letter drafts on demand. It explicitly never submits applications automatically.
🛠️ Key Features
Nightly scanning of “130+” company careers pages
LLM-based scoring of roles against a resume
Telegram delivery of top-matching roles
Drafts tailored resume and cover letter on demand
Draft-only behavior: “Never applies”
🚀 Use Cases
Finding and ranking job roles from multiple careers pages
Reviewing drafts before submitting applications
Using Telegram notifications to track recommended roles
⚡ Developer Benefits
Draft generation workflow with user review before submission
Availability of “PRIVACY.md” to document what data leaves the machine
⚠️ Limitations
Does not apply to jobs automatically; it only drafts.
Your AI job agent. Finds, scores, and drafts applications — while you sleep.
Scans 130+ company careers pages nightly → scores every role against your resume with an LLM → sends you the top matches on Telegram → drafts a tailored resume + cover letter on demand.
🔒 Drafts only — never applies. You review every draft and submit applications yourself. See PRIVACY.md for exactly what data leaves your machine.
This tool is free, open source, and runs entirely on your machine — no subscription, no credit card. The only "payment" I ask: if it surfaces a role you apply to (or land), drop a star. It takes one click, costs you nothing, and it's the single thing that pushes the project in front of the next person grinding through 130 careers pages by hand. ⭐ Star it here →
How it works
flowchart LR
A["🌐 130+ Careers Pages"] -->|TinyFish API| B["Job Discovery"]
B --> C["LLM Batch Scorer\n(0–100 fit score)"]
C -->|score ≥ min| D["📱 Telegram Alert\nTop N matches"]
C -->|on demand| E["✉️ Cover Letter\n+ Resume Bullets"]
C --> F["📊 CSV Export"]
The scoring prompt uses your actual resume — not keywords. The LLM reads your full work history and the job description, then explains in one sentence why you fit or don't. No more guessing.
What a scan result looks like
code
Scanning Mistral AI...
3 new job URLs. Fetching details...
Scoring jobs...
Saved 2 jobs from Mistral AI
Scanning HuggingFace...
5 new job URLs. Fetching details...
Scoring jobs...
Saved 3 jobs from HuggingFace
Scanning Stripe...
No new jobs found
...
Scan complete.
Top 5 sent to Telegram.
What the Telegram notification looks like
code
Job Hunt — 06 Jun 2026
5 matches found
#1 | Mistral AI | Applied AI Engineer, ML Infrastructure
📍 Paris/London/Marseille, On-site
🔧 Python, LLMs, RAG, AWS, MLOps, DevOps
✅ Role combines applied AI + ML infrastructure in EU, aligns with MLOps/RAG expertise and relocation goal
Score: 85/100 → https://jobs.lever.co/mistral/...
#2 | HuggingFace | Staff ML Engineer
📍 Remote (EU)
🔧 Python, PyTorch, Transformers, CUDA, MLOps
✅ Open-source ML role matches deep learning and distributed training background
Score: 80/100 → https://apply.workable.com/huggingface/...
...
Reply "apply to #N" to draft a tailored application.
What it does
code
Every night at 2:30 AM:
┌─────────────────────────────────────────────────────────┐
│ Scans careers pages → Scores with LLM → Notifies │
│ (130+ cos) (0–100 fit) (Telegram) │
└─────────────────────────────────────────────────────────┘
On demand:
autopilot draft 1 → tailored resume + cover letter in 60s
Usage modes
code
Mode 1: Standalone CLI (no Claude Code required)
pip install autopilot-jobhunt
autopilot scan / autopilot draft 1 / autopilot export
Mode 2: Claude Code MCP (control via natural language)
pip install 'autopilot-jobhunt[mcp]'
claude mcp add autopilot-jobhunt ...
→ "Scan for ML jobs" / "Draft application for job #2"
Both modes use the same config and produce the same output.
Quick start
Option A — pip install
bash
pip install autopilot-jobhunt # or: pip install 'autopilot-jobhunt[mcp]' for Claude Codemkdir my-job-hunt && cd my-job-hunt
autopilot init # creates config.json, companies.json, resume/, .env# Fill in config.json (API keys + your profile) and resume/YOUR_RESUME.md, then:
autopilot scan
Option B — clone (recommended if you want to customize companies or contribute)
bash
git clone https://github.com/tarunlnmiit/autopilot-jobhunt.git
cd autopilot-jobhunt
pip install -e '.'# standalone CLI# pip install -e '.[mcp]' # + Claude Code MCP integrationcp config.example.json config.json && cp .env.example .env# Fill in your API keys and candidate profile, then:
autopilot scan
For the full walkthrough — API key setup, Claude Code MCP registration, rate limit details, and troubleshooting — see SETUP.md.
Note:cwd must point to the cloned repo — the server reads config.json and companies.json from there.
Step 3: Use it
In any Claude Code session:
code
"Scan for ML jobs"
"Draft an application for job #2"
"Export jobs from the last 7 days with score above 70"
Claude Desktop
Same JSON block — add it under mcpServers in Claude Desktop → Settings → Developer.
Customize your target companies
Edit companies.json. Each entry needs:
json
{"name":"Stripe","careers_url":"https://stripe.com/jobs","search_domain":"stripe.com","location":"Remote / San Francisco, CA","region":"Remote"}
The repo ships with 130+ pre-configured EU, NZ, and remote-friendly tech companies. Add or remove as you like.
How scoring works
The LLM reads your full resume + the full job description and assigns a score 0–100:
Score
Meaning
80–100
Near-perfect fit — apply immediately
60–79
Good fit — worth applying
40–59
Partial fit — apply if pipeline is thin
< 40
Poor fit — skipped
Set min_score in config to filter. Default: 60.
Project structure
code
autopilot-jobhunt/
├── job_hunt/
│ ├── main.py # CLI entry point
│ ├── scanner.py # Job discovery + LLM scoring
│ ├── drafter.py # Resume tailoring + cover letter
│ ├── notifier.py # Telegram notifications
│ ├── llm_utils.py # OpenRouter wrapper with fallback
│ ├── tools.py # Protocol-agnostic tool layer
│ └── mcp_server.py # MCP server (Claude/AI assistant integration)
├── demo/ # Demo scripts for recording GIF
├── resume/ # Put your resume here (gitignored)
├── state/ # Scan state (gitignored)
├── output/ # Generated applications (gitignored)
├── companies.json # 130+ target companies
├── config.example.json # Config template (copy to config.json — gitignored)
└── config.json # Your config (gitignored — never committed)
LLM options
Default: OpenRouter (free)
Uses a 4-model fallback chain — all free, no credit card needed:
Model
Role
meta-llama/llama-3.3-70b-instruct:free
Primary — best quality
nvidia/nemotron-3-super-120b-a12b:free
Fallback 1 — 120B
google/gemma-4-31b-it:free
Fallback 2
qwen/qwen3-coder:free
Fallback 3
If one model hits its daily free-tier quota, the tool automatically tries the next. Zero LLM cost by default.
Alternative A: Claude Code CLI (no API key needed)
If you have Claude Code installed and authenticated, you can use it as the LLM backend — no separate API key required:
In config.json:
json
"llm_provider":"claude_cli"
Or via environment variable: LLM_PROVIDER=claude_cli autopilot scan
Optionally set a model: "claude_cli_model": "sonnet" (or "opus", "haiku", empty = Claude's default).
Note: Requires the claude binary in your PATH. Verify with claude --print "hi" first.
The MCP server and cron jobs must run in an environment where your claude auth session is active.
Rate-limit note: Each call loads your global Claude Code context (~25–30k tokens). A nightly scan
(5–15 LLM calls) burns significantly against your subscription's 7-day rate limit. Prefer OpenRouter
for nightly automation; use Claude CLI for occasional on-demand drafts.
claude-haiku-4-5-20251001 is fast and cheap; claude-sonnet-4-6 gives higher quality scores. A nightly scan uses ~5–15 LLM calls total (jobs scored in batches of 10).