Once you’ve connected the MCP Server, Claude has access to the following tools. Each tool maps to an action Claude can take on your behalf — read data from your workspace, create jobs and companies, or move candidates through your pipeline.Documentation Index
Fetch the complete documentation index at: https://docs.hirempire.com/llms.txt
Use this file to discover all available pages before exploring further.
Companies
get_companies
get_companies
Read-only. Returns every company in your workspace along with current plan limits (e.g.,
active_jobs_remaining, can_activate_job).Claude calls this automatically before creating a job — it needs the company_id and uses the limit fields to decide whether a new job can be activated or must be saved as a draft.Inputs: none.create_company
create_company
Create a new company in your workspace. Claude will ask you for the required details before calling.Required inputs:
name— company namewebsite— company website URLlogo— logo image URLindustry— one of the supported industries (Accounting, Advertising, Healthcare, Information Technology, etc.)
linkedin_url— LinkedIn company page URLlocation— headquarters locationsize— employee size range (1-10,11-50,51-100, …10000+)
Jobs
get_jobs
get_jobs
Read-only. Lists all job postings in your workspace.Optional input:
status— filter bydraft,active,paused,closed, orarchived
create_job
create_job
Create a new job posting. Claude follows a strict step-by-step flow and asks you for every field — title, department, location, employment type, career level, salary structure, description, sourcing channels, application form fields, and custom screening questions.Plan limits are respected. If your workspace has reached its active jobs limit (
can_activate_job is false from get_companies), Claude will save the job as a draft and tell you to upgrade or close an existing job to activate it.Highlights of what Claude will ask you for:- Title, industry, department
- Location type (
onsite/remote/hybrid), country, city - Employment type and career level
- Salary structure (fixed vs range), currency, period, amount, and whether to hide it from candidates
- Description (write your own or have Claude generate it)
- Sourcing channels (LinkedIn, Indeed, Referral, Company Website, etc.)
- Whether to post the job on LinkedIn
- Status —
activeto publish now,draftto save for later - Application form: which built-in fields to show or require (cover letter, photo, experience years, languages, nationality, location, salary expectation), plus any custom screening questions
Candidates
get_candidates
get_candidates
Read-only. Fetches all candidates for a specific job.Required input:
job_id— the job to fetch candidates for
update_candidate_stage
update_candidate_stage
Moves a candidate to a different pipeline stage.Required inputs:
candidate_idstage— one ofuploaded,applied,reviewed,accepted,scheduled,met,hired,rejected
Example prompts
Each tool can be invoked with natural language — Claude picks the right tool based on what you ask:- “What companies do I have set up?” →
get_companies - “Create a new company called Acme Corp” →
create_company - “Show me all my active jobs” →
get_jobs - “Create a Senior Backend Engineer job in Engineering, remote, 150k” →
create_job - “Who applied to the Marketing Manager role?” →
get_candidates - “Move Ahmed Hassan to the scheduled stage” →
update_candidate_stage
Pipeline stages reference
The full pipeline used byupdate_candidate_stage:
| Stage | Meaning |
|---|---|
uploaded | CV added to your bank, no application yet |
applied | Candidate has submitted an application |
reviewed | You’ve reviewed the application |
accepted | Candidate accepted for the next step |
scheduled | Interview scheduled |
met | Interview completed |
hired | Offer accepted, candidate hired |
rejected | Not moving forward |