# Troops MCP for AI Agents AI Agent Connect

> Troops lets you manage your entire recruitment and HR pipeline through your AI agent. You can create job offers, track candidate profiles, generate contracts, and handle timesheet submissions without leaving your chat interface. It connects your HR data directly to your workspace, making it easier to move talent through the funnel and manage active contracts.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_V93ptDCtFqMuhlR2LYnEezGRYkTGEv1YBTFPYNT0/ai-agent-connect
- **Tags:** job-management, candidate-tracking, timesheets, hr-automation, recruitment-workflow

## Description

Managing a growing workforce usually means jumping between different tabs to check job statuses, update candidate notes, and chase down signed contracts. It's a fragmented mess that pulls you away from actual hiring and high-level strategy. This Connector changes that by letting you handle those tasks through a single conversation. Instead of hunting for a specific candidate's profile or manually drafting a new job post, you just ask your agent to do it. You can pull up a list of open roles, register a new lead, or trigger a contract for signature in seconds. It's a way to keep your HR operations moving at the speed of your conversation. By connecting to the Vinkius catalog, you get a reliable way to turn your AI into a dedicated HR coordinator that handles the heavy lifting of data entry and document generation. You no longer have to worry about the tedious parts of the hiring funnel. Whether you're trying to organize a massive recruitment drive or just want to make sure your contractors are submitting their hours on time, this tool puts the controls in your hands. You get a clean, conversational interface to manage your entire workforce lifecycle without the typical headache of clicking through multiple dashboards.

## Tools

### sign_contract
Trigger the electronic signature process for a contract. This pushes the document to the candidate for signing.

### create_candidate
Register a new candidate into your system. This lets you build your talent pool faster without manual forms.

### get_candidate
Retrieve specific details about a candidate. Use this to quickly check qualifications or contact info.

### submit_timesheet
Submit a timesheet for an active contract. This keeps your payroll records accurate and up to date.

### create_job
Create a new job offer with specific details. It helps you launch new roles across different locations instantly.

### generate_contract
Generate a legal contract for a specific job. This automates the drafting process for new hires.

### list_jobs
List your current job offers. You can filter these by status to see what's still open.

## Prompt Examples

**Prompt:** 
```
List all our current job openings that are still active.
```

**Response:** 
```
I've pulled the active job list for you. Here are the current openings:

| Job Title | Location | Status |
| :--- | :--- | :--- |
| **Senior Frontend Developer** | Remote | Open |
| **Product Manager** | New York | Open |
| **HR Specialist** | Chicago | Open |

Would you like me to filter these by a specific location or status?
```

**Prompt:** 
```
Register a new candidate named Sarah Jenkins with the email sarah.j@example.com.
```

**Response:** 
```
I've registered **Sarah Jenkins** as a new candidate in your system.

*   **Candidate ID:** `cand_552`
*   **Email:** sarah.j@example.com

You can now use this ID to generate a contract or view her profile whenever you're ready.
```

**Prompt:** 
```
Generate a contract for candidate cand_123 for the Senior Dev role at a rate of 90.
```

**Response:** 
```
I've generated the contract for the **Senior Dev** position.

*   **Contract ID:** `ct_889`
*   **Rate:** 90
*   **Candidate:** `cand_123`

Should I trigger the electronic signature process for this contract now?
```

## Capabilities

### Register new candidates
Add new talent to your pipeline with a few words.

### Pull candidate details
Get instant info on any person in your system.

### Create job offers
Launch new positions with specific dates and locations.

### Generate legal contracts
Produce ready-to-sign documents for new hires.

### Trigger signatures
Send contracts out for electronic signing immediately.

### Track work hours
Submit timesheets to keep payroll accurate.

### View open positions
See your current job board status at any time.

## Use Cases

### High-volume recruiting
A recruiter registers 10 candidates from a career fair by asking the agent to create profiles for each one. This avoids manual entry and keeps the pipeline moving.

### Contract renewal
An ops manager asks the agent to generate a contract for a freelancer and trigger the signature for a new project. This automates the repetitive admin work.

### Job board updates
An HR lead asks the agent to list all jobs with "Pending" status to see which ones need more attention. This helps identify bottlenecks in the hiring process.

### Payroll submission
A remote worker asks the agent to submit their timesheet for the week to ensure they get paid on time. This simplifies the end-of-week reporting for the whole team.

## Benefits

- Stop manual data entry by using create_candidate to add talent to your pipeline instantly. This saves you from copy-pasting info from emails into your database.
- Speed up hiring by using generate_contract to create documents the moment a candidate accepts. You can get the paperwork out of the way in seconds.
- Keep your job board organized by using list_jobs to see what's active and what's filled. It gives you a clear view of your current recruiting status.
- Reduce payroll errors by using submit_timesheet to track hours directly through your agent. This ensures your contractors get paid correctly and on time.
- Cut down on email back-and-forth by using sign_contract to trigger electronic signatures automatically. It moves the process forward without your constant input.
- Access candidate info faster by using get_candidate to pull profiles without opening a browser. You can quickly verify details during a live call.

## How It Works

The bottom line is you get a voice-controlled HR dashboard that does the clicking for you.

1. Subscribe to the Troops MCP on the Vinkius marketplace.
2. Add your Troops API key to your configuration.
3. Start asking your agent to manage jobs, candidates, and contracts.

## Frequently Asked Questions

**Can the Troops MCP help me manage my hiring pipeline?**
Yes, it lets you register candidates, list open jobs, and track your recruitment progress through a simple chat interface.

**How does Troops handle contract signatures?**
You can ask your agent to generate a contract and then immediately trigger the electronic signature process for your new hire.

**Can I use this to track employee hours?**
Yes, you can use the tool to submit timesheets for active contracts, ensuring your payroll data stays accurate without manual entry.

**Does the Troops MCP work with my existing job offers?**
It connects directly to your Troops account, allowing you to list, filter, and create job offers dynamically.

**How do I add new candidates to my database?**
Just tell your agent the candidate's details, and it will use the registration tool to add them to your system automatically.

**Can I use this for remote team management?**
It's great for that because it handles contract generation and timesheet submissions, which are key for managing remote contractors.

**How can I see all currently published job offers?**
You can use the `list_jobs` tool. You can also filter the results by status, such as 'published', to see only active listings.

**Is it possible to register a new candidate directly through the AI?**
Yes! Use the `create_candidate` tool by providing the candidate's first name, last name, and email address to add them to your Troops database.

**How do I submit hours worked for a specific contract?**
Use the `submit_timesheet` tool. You will need to provide the `contract_id` and a JSON array representing the daily hours worked.