# Jaicob MCP > Jaicob MCP Server connects your AI agent to recruitment functions. It lets you list candidates, manage job applications, and track client organizations. Use it to automate the data gathering and initial screening stages of hiring. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** text-generation, sentiment-analysis, summarization, translation, ai-agent, data-extraction ## Description The Jaicob MCP Server hooks up your AI agent to all your recruiting functions. It lets your agent list candidates, manage job applications, and track client organizations. You'll use it to automate data gathering and initial screening stages of hiring. To manage candidate profiles, use `create_candidate` to build a new candidate record. To see every candidate you've got, `list_candidates` fetches a complete list. You can also grab a directory of every client company with `list_clients`. When you're tracking open jobs, `list_vacancies` gets you a list of all active vacancies. You can view the current status and details of all recruitment leads by running `list_recruitment_leads`. To check all job applications submitted through the system, `list_applications` retrieves that list. Finally, you can get a list of all candidates and job applications by running `list_candidates` and `list_applications`. ## Tools ### create_candidate Build a new candidate profile in Jaicob. ### list_applications Get a list of all job applications. ### list_candidates Fetch a list of all candidates in Jaicob. ### list_clients List all client organizations. ### list_recruitment_leads List active recruitment leads. ### list_vacancies List all current job vacancies. ## Prompt Examples **Prompt:** ``` Generate a product description for a SaaS analytics tool and analyze its sentiment. ``` **Response:** ``` Generated: 'Transform your data into actionable insights with our powerful analytics platform. Track user behavior, measure conversion funnels, and visualize trends in real-time. Built for teams that demand precision and speed.' (148 words). Sentiment analysis: Very Positive (0.92). Tone: Professional, confident. Key topics: analytics, data visualization, user behavior. Readability: Grade 8. ``` **Prompt:** ``` Summarize this 5-page report and translate the summary to Portuguese. ``` **Response:** ``` Summary (120 words): Key findings: Q1 revenue grew 18% YoY driven by enterprise segment (+34%). Customer retention stable at 92%. Three risks identified: competitive pressure, hiring delays, supply chain dependencies. Recommendations: expand enterprise sales team, accelerate product roadmap. Portuguese translation: 'Resultados Q1: receita cresceu 18% YoY impulsionada pelo segmento enterprise (+34%). Retenção estável em 92%. Três riscos: pressão competitiva, atrasos de contratação, dependências de supply chain.' ``` **Prompt:** ``` Extract key entities and data points from this customer feedback text. ``` **Response:** ``` Extracted entities: Company: 'Acme Corp'. Contact: 'Sarah Chen' (VP Engineering). Product: 'Analytics Pro'. Sentiment: Positive (0.78). Key data points: NPS score: 8/10. Feature requests: 'real-time dashboards', 'API access'. Pain points: 'slow report generation'. Competitor mention: 'Mixpanel'. Would you like to generate a response or analyze more feedback? ``` ## Capabilities ### Manage Candidate Profiles Create a new candidate record using the `create_candidate` tool. ### View Job Applications Retrieve a list of all job applications submitted through the system using `list_applications`. ### List All Candidates Fetch a complete list of every candidate stored in Jaicob using `list_candidates`. ### List Client Organizations Retrieve a directory of all client companies using `list_clients`. ### List Open Jobs Get a list of all active job vacancies using `list_vacancies`. ### Track Leads View the current status and details of all recruitment leads using `list_recruitment_leads`. ## Use Cases ### Need to vet a new hire candidate quickly. A recruiter gets a referral. Instead of emailing a manual intake form, they ask their agent to run `list_candidates` to see if the person is already in the system. If not, they use `create_candidate` right away, gathering all necessary data in one flow. ### Client requests a new internal job role. An HR analyst needs to know if the company already has a similar role open. They use `list_vacancies` to check the existing roles, and then use `list_clients` to see which client organization needs the new position. ### Reviewing a batch of job submissions. A talent manager needs to see every application submitted for a specific role. They prompt their agent to use `list_applications`, getting a clean list of all submissions for immediate review and follow-up. ### Auditing the entire pipeline from start to finish. A team lead wants a full picture of the business. They ask their agent to use `list_recruitment_leads` to see who is hot right now, then use `list_clients` to understand which client accounts are generating the most leads. ## Benefits - Stop digging through spreadsheets to find who applied. Use `list_applications` to pull a list of job submissions instantly, letting your agent do the heavy lifting. - Build a candidate profile from scratch. The `create_candidate` tool lets you capture all necessary data points and put them into the system without manual data entry. - Keep track of your leads. `list_recruitment_leads` shows exactly who needs a follow-up call, ensuring nothing slips through the cracks in your pipeline. - Understand your market size. Run `list_candidates` to get a full roster of everyone in the system, giving you a clean view of your talent pool. - Match roles to needs. Use `list_vacancies` and `list_clients` together to see which open roles align with which client organizations. - Never lose context on a client. `list_clients` provides an immediate directory of all partner organizations, keeping your entire team aligned on who you serve. ## How It Works The bottom line is you let your AI agent run HR functions through natural language prompts, accessing structured data in Jaicob. 1. Subscribe to this server and enter your Jaicob API Key. 2. Connect your preferred AI client (Claude, Cursor, etc.) to the MCP Server. 3. Prompt your agent to execute a specific recruitment task, such as listing job vacancies. ## Frequently Asked Questions **How do I use the `list_candidates` tool with Jaicob MCP Server?** You ask your agent to run `list_candidates`. It fetches a complete list of everyone in your system. You can then ask follow-up questions about those specific profiles. **Can I use `list_applications` to see who applied for a job?** Yes. Running `list_applications` pulls up all job submissions. You can then filter that list by dates or job titles within your chat agent. **What is the difference between `list_clients` and `list_recruitment_leads`?** Clients are the organizations you work for. Leads are specific people or companies that need follow-up to become clients or candidates. `list_clients` is the source, `list_recruitment_leads` is the action. **How do I create a new candidate using the `create_candidate` tool?** You simply instruct your agent to create a candidate and provide all the required data points (name, email, etc.) in the prompt. The agent handles the API call. **How do I use `list_vacancies` to check for open jobs?** It lists all active job openings. This tool returns a structured list including the vacancy ID, job title, and the date the position was posted. **What happens if I run `list_recruitment_leads` and get no results?** It means there are currently no leads saved in the system. You'll need to check your lead intake process or manually add new leads before the tool can return data. **Does `list_candidates` show details about a candidate's job history?** Yes, the results include a summary of their past roles and educational background. This lets you quickly assess if they meet the core requirements for the role. **How does `list_clients` help manage organization data?** It provides a roster of all client organizations linked to your account. This is useful for tracking client status and ensuring you have the correct billing or contact details on file. **Can I generate and analyze content through the AI agent?** Yes. Use the generation tools with prompts and parameters. Use analysis tools to extract sentiment, topics, and key insights from any text. **How does Jaicob API authentication work?** Jaicob uses a custom `x-api-key` header (not Bearer) for all requests to `api.jaicob.ai/v1`. Your API key is generated from the Jaicob dashboard. **Can I translate content between languages?** Yes. The translation tools support multiple languages. Provide source text and target language for accurate translations.