Content
[](LICENSE)
[](https://discord.gg/hmHujPetXH)
# Shortlist MCP Server
**Apply to hundreds of jobs from Claude in minutes.**
Shortlist connects to Claude Code, Claude Desktop, or Cursor and lets you search for jobs, fill out applications with AI, and submit them automatically — without leaving your terminal.
<!-- TODO: Add demo GIF showing full workflow: search → queue → prefill → apply -->
<!-- Record with: search "senior frontend engineer remote" → add 3 URLs → prefill → approve → start applying → show progress -->
## How it works
### 1. Connect
Add the MCP server and log in — takes 30 seconds.
```bash
claude mcp add shortlist --transport http https://shortlist.jobs/mcp
```
Restart Claude Code, then type `/mcp` and select `shortlist`. A browser window opens — sign in with your [Shortlist account](https://shortlist.jobs) and you're connected.
<details>
<summary>Claude Desktop setup (macOS)</summary>
Add this to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"shortlist": {
"transport": "http",
"url": "https://shortlist.jobs/mcp"
}
}
}
```
Restart Claude Desktop. You'll be prompted to authenticate on first use.
</details>
<details>
<summary>Claude Desktop setup (Windows)</summary>
Add this to `%APPDATA%\Claude\claude_desktop_config.json`:
```json
{
"mcpServers": {
"shortlist": {
"transport": "http",
"url": "https://shortlist.jobs/mcp"
}
}
}
```
Restart Claude Desktop. You'll be prompted to authenticate on first use.
</details>
### 2. Search and queue jobs
Find jobs by role, location, or company. Or paste URLs directly from any supported job board.
```
You: Find me remote senior frontend engineer jobs
```
```
You: Add these to my queue:
https://jobs.ashbyhq.com/stripe/senior-frontend
https://jobs.lever.co/figma/senior-fe-engineer
https://boards.greenhouse.io/vercel/jobs/frontend-eng
```
### 3. Apply
Shortlist scrapes each application form, fills in answers from your profile, and submits. You review before anything goes out.
```
You: Prefill and approve all jobs, then start applying
```
The bot handles the rest — form fields, dropdowns, file uploads, the works. All AI-generated text is humanized and reads identical to human writing — no "passionate team player" filler that gets your application filtered out.
## Example session
Here's what a real workflow looks like in Claude Code:
```
You: Search for senior software engineer jobs in San Francisco, posted this week
Claude: Found 47 jobs. Showing 20:
1. Senior Software Engineer at Stripe
Location: San Francisco, CA
Posted: 2 days ago
URL: https://jobs.lever.co/stripe/abc123
2. Senior Backend Engineer at Figma
Location: San Francisco, CA (Hybrid)
Posted: 1 day ago
URL: https://boards.greenhouse.io/figma/jobs/def456
3. Staff Software Engineer at Vercel
...
You: Add the Stripe and Figma jobs to my queue
Claude: Added 2 job(s) to queue:
+ Senior Software Engineer at Stripe (lever)
+ Senior Backend Engineer at Figma (greenhouse)
You: Prefill both applications
Claude: Application Form Scraped Successfully
Job: Senior Software Engineer at Stripe
Form Fields (12):
- First Name (text, required)
- Last Name (text, required)
- Email (email, required)
- Resume (file, required)
- LinkedIn URL (url, optional)
- Why are you interested in Stripe? (textarea, required)
...
I've filled all 12 fields using your profile. Here's what I wrote for
"Why are you interested in Stripe?":
"I've spent the last four years building payment infrastructure at scale.
At my current role I reduced checkout latency by 40% across 12M monthly
transactions. Stripe's API design is something I've admired as a user —
I'd like to work on the other side of it."
Ready to submit?
You: Looks good. Approve both and start applying.
Claude: Approved 2 job(s). Bot started!
Use get_application_progress to check status.
You: How's it going?
Claude: Application Progress
Done: 2 (2 success, 0 failed) | Remaining: 0
Status: Batch complete
Last: Senior Backend Engineer at Figma — success
```
Two applications, start to finish, without opening a browser.
## Supported platforms
Works with 6 major applicant tracking systems, covering thousands of companies from startups to Fortune 500:
| Platform | Domain | Notable companies |
|----------|--------|-------------------|
| Ashby | ashbyhq.com | Notion, Figma, Ramp |
| Lever | lever.co | Netflix, Stripe, Shopify |
| SmartRecruiters | smartrecruiters.com | Visa, McDonald's, Skechers |
| Workable | workable.com | Miro, Samsara, Deel |
| Greenhouse | coming soon | Airbnb, DoorDash, HubSpot |
| Workday | coming soon | Amazon, Salesforce, Adobe |
+8 more coming soon
More platforms coming. [Request one on Discord](https://discord.gg/hmHujPetXH) or open an issue.
## Works with
| Client | Status |
|--------|--------|
| Claude Code | Fully supported |
| Claude Desktop | Fully supported |
| Cursor | Supported (MCP compatible) |
| Any MCP client | Should work — [let us know](https://github.com/mathhire/shortlistjobs-mcp/issues) |
## Privacy and security
- **Source code is public.** This repo contains the full MCP tool definitions and HTTP client so you can see what each tool does before you use it.
- **Your credentials stay local.** OAuth tokens are stored in your Claude config on your machine. We never see them.
- **No chat data is stored.** Your conversations with Claude are between you and Anthropic. Shortlist only receives the specific API calls you trigger (search queries, profile updates, job submissions).
- **Applications run on Shortlist's servers.** The bot needs a browser to fill out forms and submit them — that runs on our infrastructure, not your machine. Your profile data is used to fill applications and is stored in your Shortlist account.
- **Delete anytime.** You can delete your account and all associated data from the Shortlist dashboard.
## Pricing
Free for as long as we can support it. [Join the Discord](https://discord.gg/hmHujPetXH) for updates.
<details>
<summary>FAQ</summary>
### Do I need a paid Claude plan?
No. The MCP server works with any Claude plan, including free. However, free Claude accounts have message limits that may interrupt longer sessions.
### Which job boards are supported?
Shortlist works with jobs posted on Ashby, Lever, SmartRecruiters, Workable, Greenhouse, and Workday. These cover thousands of companies. Indeed, LinkedIn, and other boards are not yet supported — [request them on Discord](https://discord.gg/hmHujPetXH).
### Can it apply without my approval?
No. Every job goes through your queue. You can review prefilled answers, edit them, and explicitly approve before anything is submitted. The bot only submits jobs you've approved.
### Is my resume shared with anyone besides the companies I apply to?
No. Your resume is stored in your Shortlist account and only sent to companies as part of job applications you've approved.
### What happens if the bot fails on a job?
Failed applications are logged with the reason (e.g., "required field not found", "CAPTCHA detected"). Nothing is submitted partially — it either completes the full application or reports the error. Failed jobs are automatically reviewed by another agent within 24–48 hours, which will diagnose the issue and attempt to resubmit. You can also view failures with `get_applied_jobs` and retry manually.
### Can I use this with my own MCP client?
Yes. Any client that supports the MCP HTTP transport should work. The server is a standard MCP endpoint at `https://shortlist.jobs/mcp`.
</details>
<details>
<summary>Full tool reference (33 tools)</summary>
### Search
| Tool | Description |
|------|-------------|
| `search_jobs` | Search for jobs by title, location, and filters |
### Queue Management
| Tool | Description |
|------|-------------|
| `add_to_queue` | Add jobs by URL (auto-detects title, company, ATS) |
| `get_queue` | View your application queue |
| `remove_from_queue` | Remove a job from the queue |
| `clear_queue` | Clear all jobs from the queue |
| `approve_job` | Approve a job for submission (with optional form answers) |
| `approve_all` | Approve all pending jobs |
### Application Forms
| Tool | Description |
|------|-------------|
| `get_job_details` | Get full job details, form fields, and answers |
| `prefill_job` | Scrape application form and prepare answers |
### Bot Control
| Tool | Description |
|------|-------------|
| `start_applying` | Start the bot to submit approved applications |
| `stop_applying` | Stop the bot |
### Profile
| Tool | Description |
|------|-------------|
| `get_profile` | View your full profile |
| `update_personal_details` | Update name, email, phone, address |
| `add_skills` / `remove_skills` | Manage skills |
| `add_languages` / `remove_languages` | Manage languages |
| `add_work_experience` | Add work experience or project |
| `update_work_experience` | Update existing work experience |
| `delete_work_experience` | Delete work experience |
| `add_education` | Add degree, certification, or clearance |
| `update_education` | Update existing education entry |
| `delete_education` | Delete education entry |
| `update_application_questions` | Update salary, sponsorship, work auth, etc. |
### Resumes
| Tool | Description |
|------|-------------|
| `list_resumes` | List uploaded resumes (max 5) |
| `upload_resume` | Upload a resume (PDF, DOC, DOCX) |
| `set_default_resume` | Set a resume as default |
| `delete_resume` | Delete a resume |
### Progress & History
| Tool | Description |
|------|-------------|
| `get_applied_jobs` | View application history with filters |
| `get_applied_jobs_count` | Get total application count |
| `get_application_summary` | Detailed summary with match analysis |
| `get_application_progress` | Check current batch progress |
</details>
<details>
<summary>Architecture</summary>
```
┌──────────────┐ MCP Protocol ┌──────────────────┐
│ Claude Code │ ◄──────────────────── │ Shortlist MCP │
│ (or any │ │ Server │
│ MCP client)│ │ (this repo) │
└──────────────┘ └────────┬─────────┘
│ HTTPS
┌────────▼─────────┐
│ Shortlist API │
│ (hosted) │
│ │
│ - Job search │
│ - Form scraping │
│ - Bot automation│
│ - Profile mgmt │
└──────────────────┘
```
This repo contains the MCP interface layer — tool definitions and the HTTP client that talks to Shortlist's API. The form scraping, browser automation, and AI form filling all run on Shortlist's infrastructure.
</details>
## Support
- [Discord](https://discord.gg/hmHujPetXH) — Fastest way to get help, request features, and report bugs
- [GitHub Issues](https://github.com/mathhire/shortlistjobs-mcp/issues) — Bug reports and feature requests
- [X / Twitter](https://x.com/buildShortlist) — Updates and announcements
## Development
```bash
# Install dependencies
npm install
# Build
npm run build
# Watch mode
npm run dev
```
## License
MIT
