boss-agent-cli MCP Server for BOSS Zhipin (Job Seekers and Recruiters)

• Searches BOSS Zhipin job listings with filters

  Searches jobs by keyword with filters for city, salary, experience, education and benefits such as a two-day weekend.

  Try: “Find Golang jobs in Guangzhou paying 20-50K with a two-day weekend.”

  Runs code · boss_search

• Shows job picks based on your resume

  Reads the jobs the platform recommends for your resume.

  Try: “Show me the jobs BOSS recommends for me.”

  Runs code · boss_recommend

• Opens the full details of one job

  Fetches the full posting for a job, using the ID from a search or recommendation result.

  Try: “Show the full details of job 3 from the last search.”

  Runs code · boss_detail

• Sends a first hello to a recruiter

  Starts a chat with the recruiter of a job by sending a greeting. It writes to your real BOSS Zhipin account.

  Try: “Say hello to the recruiter of the second job.”

  Runs code · boss_greet

• Greets recruiters for many search results at once

  Runs a search and sends greetings to the recruiters it finds, up to 10 in one call.

  Try: “Greet the first 5 recruiters from this search.”

  Runs code · boss_batch_greet

• Applies to a job or starts a chat about it

  Sends your application or starts the chat for a job. It is built not to apply twice to the same job.

  Try: “Apply to the Hangzhou backend job we just looked at.”

  Runs code · boss_apply

• Lists your recruiter conversations

  Lists your chat threads, filterable by who started them and when, with an ID for each contact.

  Try: “Which recruiters have written to me this week?”

  Runs code · boss_chat

• Reads the message history with one contact

  Returns the chat history with the chosen contact.

  Try: “Show my messages with the recruiter from the Shenzhen job.”

  Runs code · boss_chatmsg

• Asks a contact to swap phone or WeChat

  Sends a request to exchange a phone number or WeChat ID with a contact. This shares personal details.

  Try: “Ask this recruiter to swap WeChat.”

  Runs code · boss_exchange

• Adds or removes a label on a contact

  Tags a contact with a label such as new, in talks, interview booked or not a fit, or removes it. The label is saved on the platform.

  Try: “Mark this recruiter as interview booked.”

  Runs code · boss_mark

• Lists your interview invitations

  Shows the interview invitations on your account.

  Try: “Do I have any interviews this week?”

  Runs code · boss_interviews

• Writes a read-only daily summary

  Summarizes new jobs, chats that need a follow-up and interviews. It only reads, and can output Markdown for an email.

  Try: “Give me today's job-hunt digest.”

  Runs code · boss_digest

• Scores your resume against a job description

  Analyzes a job description and rates how well your saved resume matches, with a gap analysis.

  Try: “How well does my resume match this job?”

  Runs code · boss_ai_analyze_jd

• Drafts replies to a recruiter message

  Writes 2 or 3 reply drafts to a recruiter message, using your resume and a tone you choose. It only drafts.

  Try: “Draft a polite reply to this recruiter.”

  Runs code · boss_ai_reply

• Drafts a cover letter for a job

  Writes a draft cover letter or self-introduction from your local resume and the job. It does not send it.

  Try: “Write a cover letter for this job.”

  Runs code · boss_ai_cover_letter

• Makes mock interview questions for a job

  Builds practice questions and preparation tips from the job description, tailored to your resume if you give one.

  Try: “Prepare me for the interview for this job.”

  Runs code · boss_ai_interview_prep

• Lists the resumes saved on your computer

  Lists the local resumes with name, creation time and the number of linked jobs.

  Try: “Which resumes do I have saved?”

  Runs code · boss_resume_list

• Saves a job to your local shortlist

  Adds a job to a shortlist on your computer, with optional tags and notes. Nothing is sent to the platform.

  Try: “Add this job to my shortlist with the tag remote.”

  Runs code · boss_shortlist_add

• Removes a job from your local shortlist

  Deletes a job from the shortlist saved on your computer.

  Try: “Remove the Beijing job from my shortlist.”

  Delete · boss_shortlist_remove

• Saves a search to be watched for new jobs

  Stores search conditions so later runs can report only the new jobs.

  Try: “Watch for new Python backend jobs in Shanghai.”

  Runs code · boss_watch_add

• Deletes a saved watch

  Deletes the named saved watch from your computer.

  Try: “Stop watching the Shanghai search.”

  Delete · boss_watch_remove

• Cleans out old cache and temporary files

  Clears expired cache and temporary files.

  Try: “Clean up the old cache.”

  Delete · boss_clean

• Runs one round of automated recruiting

  Recruiter mode: runs one round of scanning, decision and action under thresholds, then records leads. It can send messages, so check its limits first.

  Try: “Run one round of the recruiting agent.”

  Runs code · boss_agent_run

• Trips the breaker on recruiter automation

  Opens the circuit breaker so the automation stops running further actions.

  Try: “Stop the recruiting agent now.”

  Runs code · boss_agent_stop

• Recruiter mode: sends a first message to a candidate

  Creates a chat with a candidate and sends the first greeting. The tool description says the operator must approve it explicitly.

  Try: “Greet the top candidate from the recommendations.”

  Runs code · boss_hr_greet

• Recruiter mode: replies to a candidate

  Sends a reply to a candidate message from your recruiter account.

  Try: “Reply to this candidate and offer a call on Friday.”

  Runs code · boss_hr_reply

• Recruiter mode: saves a candidate's resume file

  Downloads the attached resume a candidate has already shared. It does not overwrite an existing file and writes to your computer.

  Try: “Download the resume this candidate sent.”

  Runs code · boss_hr_download_resume

Watch out for

• It sends messages from your real account

  boss_greet, boss_batch_greet, boss_apply, boss_exchange and the recruiter tools write to real people. The code sets no consent gate on them, so confirm each action in the chat. github.com

• Bulk and automated actions can get your account restricted

  The project says the platform may limit accounts and change its interface at any time. Keep batch counts low, and stop when it reports an account-risk error. github.com

• Chats, resumes and candidate data pass through the assistant

  Chat history, resumes and recruiter-side candidate details are returned to your AI app. Share them only with an assistant you trust with that data. github.com

• It deletes local saved data

  boss_shortlist_remove, boss_watch_remove, boss_preset_remove and boss_clean delete data on your computer, not on the platform. github.com

• Your login session is stored on disk

  The session lives in ~/.boss-agent. Treat that folder like a password. github.com

Security advisories