# Moka HR MCP > Moka HR connects your AI client directly to its Applicant Tracking System data. You manage candidates, jobs, and interviews by speaking to your agent, completely bypassing the complex Moka dashboard. Need a recruitment summary or candidate history? Your agent handles it in natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** applicant-tracking, talent-acquisition, interview-scheduling, hiring-workflow, candidate-management ## Description Listen up. You got a whole ATS sitting there, right? The Moka HR MCP Server hooks your AI client directly into that data stream so you don't gotta mess around with the clunky dashboard. Your agent handles the messy parts of hiring—managing candidates, tracking jobs, and sorting out interviews—just from plain conversation. It's like having a real talent assistant sitting right in your chat window. **Job Discovery & Requirements:** When you need to know what roles are open or what a specific job actually demands, your agent handles it fast. You can **list all open job positions**, getting a rundown of every role currently active at the company using `list_jobs`. If you wanna dive deep into one of those openings, you just ask for the requirements and status on a particular post, and the agent uses `get_job` to pull everything right up. It gives you the full specs so you know exactly what they're looking for. **Managing Applications & Candidates:** This is where most people get lost in paperwork. Your agent makes it easy. If you gotta see every application that’s come through—regardless of which department or role it’s for—you can **list all recorded job applications** using `list_applications`. And if you need the full scoop on any single applicant, whether they applied to a job last week or two years ago, your agent pulls their complete profile and entire history with one command, running `get_candidate`. Need to add someone manually? You can **create a new candidate** record straight into the system using `create_candidate`. If you wanna check out the nitty-gritty details of a specific job application—linking it back to both the person and the role it applies to—you use `get_application` to retrieve all those specifics. And if you're just trying to find an applicant by name or ID, the agent can pull up their full profile using `get_candidate`, making sure every single detail is visible. **Interview & Interview Tracking:** Don’t wanna miss a meeting time or forget what was discussed? Your agent handles the scheduling headache. You can **list all upcoming and past interviews**, getting dates, times, and who's involved by running `list_interviews`. If you need to review notes from a specific session—like pulling out feedback or action items from last Tuesday’s chat—the agent uses `get_interview` to fetch those precise details and any accompanying notes. It gives you the whole picture for every single scheduled talk. **Metrics & Reporting:** You don't wanna sift through thousands of rows of data just to figure out if your hiring funnel is working, right? Your agent pulls it all together for you. You can **generate high-level metrics on recruitment activity**, getting an aggregated report that shows total applications received this month or conversion rates across the board using `get_hiring_summary`. This gives you a macro view of the whole pipeline without needing to build a complicated dashboard filter. **The Bottom Line:** Basically, your agent handles every single piece of data—from listing all open roles (`list_jobs`) and checking which candidates are in play (`list_candidates`) to pulling detailed notes from an interview (`get_interview`). You talk to it like you're talking to a coworker, and it pulls the exact, structured data point you need, period. ## Tools ### create_candidate Adds a completely new candidate record into the system. ### get_application Retrieves all specific details for one job application instance. ### get_candidate Gets the complete profile and history for a single candidate. ### get_hiring_summary Pulls an aggregated, high-level report on overall hiring activity metrics. ### get_interview Retrieves specific details and notes for a scheduled interview. ### get_job Gets the full requirements and status for one job posting. ### list_applications Lists all recorded job applications across different roles or departments. ### list_candidates Returns a searchable list of all candidates currently in the system. ### list_interviews Lists every scheduled interview date and time for easy reference. ### list_jobs Lists every open job position currently active in the organization. ## Prompt Examples **Prompt:** ``` List all open job positions in our organization. ``` **Response:** ``` I've retrieved the active job postings from Moka. You have 8 open positions, including 'Senior Frontend Engineer' and 'Product Marketing Manager'. Would you like to see the details for any of them? ``` **Prompt:** ``` Show me the recruitment pipeline for candidate 'Mario'. ``` **Response:** ``` I've found candidate Mario in the system. He is currently in the 'Technical Interview' stage for the 'Backend Developer' position. His last interaction was a coding test review yesterday. ``` **Prompt:** ``` Get a summary of our hiring activity for this month. ``` **Response:** ``` I've compiled the monthly hiring summary. You've received 150 new applications, scheduled 42 interviews, and made 5 offers. The conversion rate from interview to offer is currently 12%. Would you like a breakdown by department? ``` ## Capabilities ### List Open Job Positions Retrieves a list of all currently active job postings in your organization. ### Get Candidate Profile Details Pulls the full record and history for a specific candidate by name or ID. ### Check Application Status Retrieves details about an application, linking it to both a job role and a candidate. ### Monitor Interview Schedule Lists all upcoming or past interviews and pulls specific session notes. ### Generate Hiring Metrics Compiles high-level summaries of recruitment activity, like conversion rates or total applications received this month. ### Add New Candidates Creates a new candidate record within the system for manual data entry. ## Use Cases ### The Mid-Cycle Status Check A recruiter needs to know where 'Jane Doe' is in the process. Instead of searching by email and clicking into a separate application record, they ask their agent: 'What's Jane Doe's current status?' The agent runs `get_candidate` followed by `list_applications`, giving them the exact stage (e.g., 'Technical Interview') immediately. ### The Department Head Overview A hiring manager needs a quick pulse on departmental recruiting health. They prompt: 'Give me a summary of our Q3 hiring.' The agent runs `get_hiring_summary`, providing metrics like total applications, interviews scheduled, and conversion rates in one shot. ### The New Role Deployment A new VP joins the team and needs to see what roles are open. They ask: 'What jobs do we currently have posted?' The agent runs `list_jobs`, providing a clean list of all active positions so they can get started immediately. ### The Quick Data Entry Someone finds an excellent candidate via LinkedIn but doesn't have the full file yet. They use the agent to run `create_candidate`, logging the basic details and ensuring the person is tracked in your system for later review. ## Benefits - **Instant Reporting:** Instead of running reports in the Moka dashboard, you simply ask for it. Use `get_hiring_summary` to get conversion rates and total applications instantly. - **Candidate Deep Dives:** Need Mario's full history? Don't search through tabs. Call `get_candidate` and pull up his complete profile and interaction log immediately. - **Job Visibility:** Quickly check the current job market status by listing all openings using `list_jobs`. You always know what roles are available right now. - **Interview Coordination:** Forget checking your calendar for scheduling conflicts. Use `list_interviews` to see every scheduled session and pull up detailed notes via `get_interview`. - **Data Integrity:** If you have a new candidate source, use the `create_candidate` tool to log them right away, keeping all data centralized. ## How It Works The bottom line is you skip the dashboard. You talk to your AI client, which handles all the complex backend lookups across candidate records and job pipelines for you. 1. Subscribe to this server on Vinkius and enter your Moka API Key. 2. Connect your AI client (Claude, Cursor, etc.) to the MCP endpoint. 3. Prompt your agent using natural language. Your agent translates that request into specific tool calls (e.g., `list_candidates`) and returns the structured data. ## Frequently Asked Questions **How do I check if a job position is active using Moka HR MCP Server?** Run `list_jobs`. This tool pulls every open role currently listed in your ATS. It's the fastest way to see what roles are available without navigating the main jobs section. **Can I find a candidate’s full profile using Moka HR MCP Server?** Yes, use `get_candidate`. This retrieves all data points for that person, including their contact history and application records. It's much more comprehensive than just viewing the application record. **How do I get a summary of our hiring numbers?** Use `get_hiring_summary`. This single call gives you aggregated metrics like total applications, interviews scheduled, and conversion rates for defined periods. It's your quick dashboard readout. **Does Moka HR MCP Server help with scheduling?** Yes, `list_interviews` lets you see all scheduled dates. You can also use `get_interview` to pull up the specific details or notes associated with a meeting time. **How do I set up my connection for Moka HR MCP Server?** You must subscribe to this server on Vinkius. Then, enter your unique Moka API Key into your AI client's settings to connect the service. **What data can I create using the `create_candidate` tool with Moka HR MCP Server?** The server requires basic identifying information. You pass the candidate's name, contact details, and other required fields to register a new record in your system. **How do I use the `get_application` tool with Moka HR MCP Server?** This retrieves all necessary data for one specific job application. You get details on when it was submitted and which open position it relates to. **What does the `list_candidates` tool provide from Moka HR MCP Server?** The tool returns a list of candidate records. This lets you see names, current statuses, and IDs across your entire recruitment pipeline. **How do I obtain a Moka API Key?** You must contact your Moka Customer Success Manager (CSM) to enable the API Platform feature and receive your unique API Key. **Can I see interview schedules for my team?** Yes. Use the `list_interviews` tool to see upcoming sessions. You can then use `get_interview` with a specific ID to see the full details, including participants and meeting links. **Is it possible to add a new candidate through the agent?** Yes! Use the `create_candidate` tool. You will need to provide the candidate's name and email address. You can also optionally include their mobile number.