MLS-Tech-Inc

Shortlist MCP Server

Community MLS-Tech-Inc
Updated

MCP server for Shortlist — search, queue, and auto-apply to jobs from Claude Code

MIT LicenseDiscord

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.

How it works

1. Connect

Add the MCP server and log in — takes 30 seconds.

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 and you're connected.

Claude Desktop setup (macOS)

Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "shortlist": {
      "transport": "http",
      "url": "https://shortlist.jobs/mcp"
    }
  }
}

Restart Claude Desktop. You'll be prompted to authenticate on first use.

Claude Desktop setup (Windows)

Add this to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "shortlist": {
      "transport": "http",
      "url": "https://shortlist.jobs/mcp"
    }
  }
}

Restart Claude Desktop. You'll be prompted to authenticate on first use.

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

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 for updates.

FAQ

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.

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.

Full tool reference (33 tools)

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
Architecture
┌──────────────┐     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.

Support

  • Discord — Fastest way to get help, request features, and report bugs
  • GitHub Issues — Bug reports and feature requests
  • X / Twitter — Updates and announcements

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

License

MIT

MCP Server · Populars

MCP Server · New