hunaras-mcp

MCP server for Hunaras — an AI-native recruiting platform.

Connect any MCP-compatible AI assistant (Claude, ChatGPT, etc.) to Hunaras and manage your entire recruiting workflow through natural language.

What You Can Do

Candidates (17 tools):

• Search and apply for jobs
• Check AI interview assessments and scores
• Manage your profile and LinkedIn sync
• Respond to meeting proposals
• Rate employers
• Track notifications

Employers (6 tools):

• Post jobs and manage listings
• Search the talent pool (semantic search)
• Source candidates from LinkedIn
• View candidate profiles and AI assessments

Shared (1 tool):

• Get market insights (job counts, salary ranges, demand data)

Setup

1. Get an API key

Sign up at hunaras.com, then go to Settings > API Keys to create one.

2. Configure your MCP client

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "hunaras": {
      "command": "npx",
      "args": ["-y", "hunaras-mcp"],
      "env": {
        "HUNARAS_API_KEY": "hnar_your_api_key_here"
      }
    }
  }
}

Other MCP clients

{
  "command": "npx",
  "args": ["-y", "hunaras-mcp"],
  "env": {
    "HUNARAS_API_KEY": "hnar_your_api_key_here"
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | HUNARAS_API_KEY | Yes | — | Your API key (starts with hnar_) | | HUNARAS_API_URL | No | https://hunaras.com | API base URL (for self-hosted instances) |

Tools

Candidate Tools

| Tool | Description | |------|-------------| | search_jobs | Search jobs using AI semantic search | | get_job_details | Get full job posting details | | apply_to_job | Submit a job application | | get_my_profile | View your candidate profile | | get_my_applications | List applications with statuses | | update_profile | Update profile fields | | update_visibility | Show/hide from talent pool | | get_my_assessments | List AI interview assessments | | get_assessment_details | Full assessment report with scores | | get_my_appointments | List meeting proposals | | respond_to_appointment | Accept, reschedule, or reject meetings | | get_my_notifications | List notifications | | mark_notifications_read | Mark notifications as read | | get_my_ratings | View ratings from employers | | rate_employer | Rate an employer | | get_pending_ratings | See which employers you can rate | | sync_linkedin | Sync profile with LinkedIn |

Employer Tools

| Tool | Description | |------|-------------| | create_job | Post a new job listing | | list_my_jobs | List your job postings | | search_candidates | Semantic search across talent pool (Pro) | | get_candidate_profile | View candidate profile + assessment (Pro) | | hunt_candidates | Source candidates from LinkedIn (Pro) | | invite_candidate | Invite external candidate to platform |

Shared Tools

| Tool | Description | |------|-------------| | get_market_insights | Job market data, salary ranges, demand |

Example Conversations

Find a job:

"Find me React developer jobs in Berlin" "Show me details for the first one" "Apply with a cover letter highlighting my 5 years of experience"

Check interview results:

"How did I do on my interviews?" "Show me the detailed assessment for the frontend role"

Employer hiring:

"Post a senior backend engineer role, remote, $150k-$180k" "Search for candidates with Python and AWS experience"

Pricing

• Candidates: Always free
• Employers Free: 2 active jobs, 1 candidate reveal
• Employers Pro ($200/mo): Unlimited jobs, reveals, talent pool search, scheduling

Links

• Hunaras
• Documentation
• Issues

License

MIT