# Jaicob MCP

> Jaicob uses AI to manage the entire candidate lifecycle for your organization. It lets agents interact with job vacancies, client data, and candidate profiles in natural conversation. You can generate new candidate records, review active applications, or list all current clients using just a prompt.

## Overview
- **Category:** customer-support
- **Price:** Free
- **Tags:** text-generation, sentiment-analysis, summarization, translation, ai-agent, data-extraction

## Description

This MCP connects your agent directly into your recruiting systems. Instead of manually jumping between spreadsheets to check who applied for what role, you talk to the system. Your agent reads through internal documentation and client details while answering user questions. You can generate new content based on existing data, analyze text sentiment from feedback, or condense large reports into actionable summaries.

This capability is available via Vinkius, connecting your preferred AI client (Claude, Cursor, Windsurf, VS Code) to the full catalog of specialized MCPs. It handles everything from generating job descriptions to extracting key insights from candidate responses. You just ask for it.

## Tools

### create_candidate
Generates a brand new profile record for an individual job applicant.

### list_applications
Retrieves a list of all submitted job applications from the system.

### list_candidates
Pulls a comprehensive, up-to-date roster of every candidate in the system.

### list_clients
Shows all client organizations that your company currently works with.

### list_recruitment_leads
Provides a focused list of potential leads identified through recruitment efforts.

### list_vacancies
Lists all active job positions that are currently open and hiring.

## 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 Records
The system lets you generate new profiles or list existing candidates and clients.

### Review Job Pipeline Status
You can pull lists of current job vacancies, leads, and submitted applications.

### Analyze Text Data
The agent analyzes text for sentiment, key topics, or specific data points that need extraction.

## Use Cases

### Onboarding a New Client
The TA Manager needs context on the client's history. They prompt the agent to list clients, review their current vacancies, and then check general recruitment leads associated with that account.

### Reviewing Hiring Funnel Status
A recruiter asks for a status report. The agent pulls all job applications, lists the candidates who submitted them, and cross-references which clients are involved.

### Identifying High-Potential Leads
The team wants to focus on warm leads. They ask the MCP to list recruitment leads, analyze their associated documents for positive sentiment, and suggest next steps.

## Benefits

- You stop juggling multiple tabs. Instead of manually checking the status of every job application, you simply ask your agent to list all applications and get a consolidated view.
- New candidate profiles are created instantly when needed using `create_candidate`, keeping your data accurate without manual form filling.
- The MCP keeps track of who needs attention. You can review general recruitment leads or check the status of active vacancies, ensuring nothing falls through the cracks.
- Need context? By calling `list_clients` and running sentiment analysis on candidate responses, you get immediate insights into client satisfaction levels.
- You eliminate spreadsheet drift. Instead of copying data to summarize documents, your agent can condense long reports or extract specific metrics from raw text.

## How It Works

The bottom line is: you tell the system what data you need, and it executes the necessary queries and actions automatically.

1. First, subscribe to this MCP and provide your Jaicob API Key.
2. Next, connect your AI client through Vinkius.
3. Finally, you prompt the agent to perform a specific recruiting action, like listing all active vacancies or generating a new candidate profile.

## Frequently Asked Questions

**How do I check who applied for a job using list_applications?**
The agent gathers all submitted jobs by calling `list_applications`. This gives you an immediate, comprehensive view of the application status without needing to filter manual spreadsheets.

**Can Jaicob MCP help me find new hiring targets? (using list_recruitment_leads)**
Yes. By calling `list_recruitment_leads`, your agent pulls together all potential leads, allowing you to prioritize which prospects need attention first.

**What is the difference between listing clients and listing candidates? (using list_clients vs list_candidates)**
The key distinction is the entity type. `list_clients` shows organizations you work with, while `list_candidates` displays individual people in your talent pool.

**I need to add a new person to our records; do I use create_candidate?**
Yes, that's the correct function. Using `create_candidate` lets you build a structured profile for someone immediately, ensuring all necessary data points are captured right away.

**When I run `list_vacancies`, how do I filter results by location or job type?**
The function accepts dedicated filters. You can narrow down the search using parameters like 'location' (e.g., "New York") or 'job_type' (e.g., "Engineer"). This lets you target specific openings immediately.

**Using `list_clients`, what key organizational details does the MCP retrieve for each client?**
It retrieves core profile information, including the company name, primary contact person, and industry sector. You get immediate context on the organization without needing to visit an external site.

**If I run `list_candidates`, how do I handle pagination if there are hundreds of records?**
The MCP supports standard pagination parameters. Just specify the desired page number and limit when calling the tool. This lets you process all candidate profiles in manageable batches.

**When I use `list_applications`, can I filter the results by application status?**
Yes, you pass a 'status' parameter to refine your search. This is useful for isolating applications that are currently pending review or those that have been withdrawn.

**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.