# Manatal MCP Connector MCP

> Manatal MCP connects your favorite AI client directly to your entire recruitment pipeline. Manage candidate profiles, track job openings, and review applications without leaving your agent chat. It lets you query everything about your talent pool—from listing all potential candidates to getting deep details on a specific application or organization in minutes.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** applicant-tracking, candidate-sourcing, recruitment-pipeline, talent-management, job-posting

## Description

Managing a hiring process means constantly jumping between tabs: the job board, the candidate spreadsheet, the client portal. This MCP changes that by bringing Manatal's full capabilities into natural conversation with your AI agent. You can talk to your system about your workforce—for example, asking it to list every active job opening or fetch a specific candidate’s profile based on their name. It handles all the complex data retrieval for you, letting you stay focused on hiring people, not clicking buttons. Since this MCP is hosted on Vinkius, you connect once from your preferred AI client and get immediate access to Manatal's entire set of tools. This means whether you need to look up organizational details or track an applicant’s progress across multiple stages, your agent just handles the request.

## Tools

### list_career_pages
Lists all the company career pages set up within your account.

### get_application
Retrieves all detailed information for a single job application.

### get_candidate
Fetches the full profile and history of a specific candidate in your pool.

### get_job
Gets detailed information about one particular job opening.

### get_organization
Retrieves details for a named client or organization within your network.

### list_applications
Lists all the applications currently tracked in your recruitment system.

### list_candidates
Retrieves a list of all candidates stored in Manatal.

### list_departments
Retrieves a list of every department tracked in your organization's structure.

### list_jobs
Lists all the active and past job openings available to view.

### list_organizations
Provides a complete list of associated client organizations.

## Prompt Examples

**Prompt:** 
```
List the first page of candidates.
```

**Response:** 
```
Fetching candidates... I found several candidates including John Doe and Jane Smith. Would you like to see more details for any of them?
```

**Prompt:** 
```
What are the active job openings?
```

**Response:** 
```
Querying job openings... There are currently 5 active jobs, such as 'Senior Developer' and 'Product Manager'.
```

**Prompt:** 
```
Get details for organization ID 123.
```

**Response:** 
```
Inspecting organization... Organization 123 is 'TechCorp Inc.', with 10 active job openings.
```

## Capabilities

### Manage candidate records
List all candidates in your system and fetch detailed profiles for any individual.

### Review job openings
Query active jobs, list departments, or view details about specific job roles.

### Track applications
List all submitted applications and inspect the full progress or details for any single applicant.

### Identify client groups
View lists of organizations or clients associated with your recruitment firm, along with their specific details.

## Use Cases

### The 'Who is the best fit?' query
A hiring manager needs to know if John Doe, who applied two weeks ago, has been assigned a role. They ask their agent: 'What are all the open roles in the engineering department and can you check Jane Smith's application status for those?'. The agent uses `list_departments` and then executes `get_job` followed by `get_application`, giving an immediate comparison.

### Auditing a client’s data
An ops manager needs to check how many active jobs TechCorp Inc. has posted this month. They ask: 'How many roles does organization ID 123 have?'. The agent uses `get_organization` and then checks the job count using `list_jobs`, providing a definitive number.

### Pipeline health check
A recruiter needs a quick overview of all current applicants. They ask: 'Give me a list of everyone who applied last week.' The agent uses `list_applications` and then can run `get_candidate` on any name found to verify their status.

### Onboarding new departments
A department head is setting up a new team. They ask: 'What departments are available, and what's the job structure for Marketing?'. The agent executes `list_departments` followed by targeted calls to `get_job`, providing both the list and specific role details.

## Benefits

- Stop manually compiling candidate reports. Use `list_candidates` and `get_candidate` to pull detailed profiles directly into your chat window, letting you compare multiple candidates instantly.
- Audit job listings quickly. Instead of navigating through departments, just ask the agent to use `list_departments` and then `list_jobs` to see every active opening across the company structure.
- Get application status at a glance. If you need to know where an applicant stands, asking for applications allows you to use `get_application` without ever touching the main dashboard.
- Understand your client base better. Use `list_organizations` or `get_organization` to verify details and job counts for any partner company on demand.
- Consolidate data access. By grouping tools like `list_jobs`, `list_candidates`, and `list_applications`, you keep all core recruitment data in one conversation stream.

## How It Works

The bottom line is that you talk naturally to your agent, and it executes complex data requests across Manatal.

1. Subscribe to this MCP and input your Manatal API token credentials.
2. Connect the MCP to any compatible AI client like Claude or Cursor.
3. Ask your agent a natural language question, such as 'What are all the open roles in the marketing department?'

## Frequently Asked Questions

**Can the Manatal MCP list all my active job openings?**
Yes. The connector provides a dedicated `list_jobs` tool, allowing your agent to query and provide you with a complete overview of every current opening.

**Does the Manatal MCP help me track where an applicant is in the process?**
Yes. You can use the `list_applications` tool, followed by `get_application`, to inspect specific application details and see their current status within the pipeline.

**How do I get a candidate's full profile using Manatal MCP?**
You simply ask your agent for the candidate’s name. The system executes `get_candidate` to pull all detailed information and history associated with that person.

**Is the Manatal MCP limited to only listing data?**
This MCP is designed solely for retrieval, meaning it reads and reports on your data. It does not have tools for modifying or deleting records within Manatal.

**Can I get details about a specific client organization using this MCP?**
Absolutely. The `get_organization` tool lets you specify an organization ID and retrieve all associated data, such as job counts and contact info.

**Where can I find my Manatal API Token?**
Log in to Manatal, go to Administration > Integration > API, and you will find your API Token there.

**Can I list candidates by page?**
Yes, use the `list_candidates` tool and provide the `page` parameter to navigate through your results.

**Is my data secure?**
Absolutely. Your token is encrypted at rest and injected securely at runtime.