# Bilflo MCP

> Bilflo helps you manage complex staffing operations through natural conversation. List clients, track contractors, and review timecards without logging into the dashboard. Get detailed reports on placements, direct hires, and overtime rules instantly from any AI client.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** staffing, time-tracking, contractor-management, payroll-integration, crm, back-office

## Description

Connecting your Bilflo account lets your agent handle everything from basic record lookups to full payroll preparation. You talk to it like you're talking to a coworker; it pulls the data you need across client profiles, contractor records, placements, and time entries. No more opening ten different tabs just to check someone’s hours or find out who works for which client.

Whether you're verifying an active placement status or pulling all approved timecards for payroll, your agent handles the heavy lifting. This MCP makes sure that crucial staffing data is always accessible through a natural conversation layer. When you subscribe via Vinkius, you get access to this functionality alongside thousands of others—it’s one connection point for everything.

## Tools

### get_client
Retrieves specific details for one identified client account.

### get_contractor
Pulls specific details for one individual contractor worker.

### get_direct_hire
Gets the detailed record for a specific employee hired directly by the agency.

### get_timecard
Retrieves specific information about one timecard entry, like hours and dates.

### list_clients
Generates a list of every active client in the system.

### list_contractors
Provides a list of all available contractors and contingent workers.

### list_direct_hires
Generates a list of all direct hire employees in the database.

### list_overtime_rules
Lists the system's official overtime rules and configurations for payroll review.

### list_placements
Generates a list detailing all current temporary placements and assignments.

### list_timecards
Provides a list of multiple timecards for a specified period or worker.

## Prompt Examples

**Prompt:** 
```
List all active clients in Bilflo.
```

**Response:** 
```
I've retrieved your clients. You have 3 active clients: 'Acme Corp' (ID: cli_1), 'Tech Innovations' (ID: cli_2), and 'Global Solutions' (ID: cli_3).
```

**Prompt:** 
```
Find the details for contractor con_992.
```

**Response:** 
```
Contractor 'John Smith' (ID: con_992) is currently on an active placement with 'Acme Corp'. Their next timesheet is due on Friday.
```

**Prompt:** 
```
Show my recent timecards.
```

**Response:** 
```
Retrieving timecards... I found 5 recent timecards. 3 are 'Approved' and ready for payroll, and 2 are still in 'Submitted' status awaiting manager approval.
```

## Capabilities

### List and inspect all client accounts
You can see a comprehensive list of every client in the system.

### Retrieve specific client details by name or ID
Get deep into a single client's record to check their full history and setup information.

### Manage contractor records and lists
Pull up detailed profiles for individual contractors, or list every available contingent worker in your database.

### Track all placements and direct hires
List current temporary assignments or check specific details on employees hired directly by the agency.

### Access timecard data for payroll
Retrieve a list of timecards, or get detailed information on one specific timesheet entry.

### Check compliance rules and history
List the current overtime rules or retrieve system configurations necessary for auditing purposes.

## Use Cases

### Checking compliance for an audit
A manager needs to confirm pay rates meet current labor laws. They ask their agent, 'What are the overtime rules?' The agent uses `list_overtime_rules` and provides the exact system configuration details instantly.

### Onboarding a new placement
A recruiter needs to confirm if a candidate has been hired before. They prompt their agent to run `get_direct_hire` using the employee ID, confirming background and tenure status without leaving their workflow.

### Payroll processing deadline rush
The payroll team needs all hours for a specific week. They ask the agent to use `list_timecards`, which returns five time entries—three approved and two pending manager review—so they know exactly what's ready to process.

### Client status check during a meeting
A sales team member needs quick info on an existing client. They ask the agent for `get_client` details, immediately pulling up account history and current contacts so the conversation flows smoothly.

## Benefits

- Stop digging through dashboards. You can pull all timecards using `list_timecards` and instantly see which ones are approved, saving hours of manual checking.
- Check contractor details without context switching. Use `get_contractor` to verify a worker’s status immediately while talking to your agent.
- Keep client relationships strong by having instant access to history. You can run `list_clients` and quickly pull up any past placement data using `list_placements`.
- Payroll is painless. By listing all overtime rules via `list_overtime_rules`, you ensure that every paycheck calculation adheres exactly to compliance standards.
- Get a full view of your workforce, combining direct hires with temporary staff. You can compare lists from both `list_direct_hires` and `list_contractors` in one query.

## How It Works

The bottom line is, your agent reads the staffing system data and spits out an answer you can use right away.

1. Subscribe to this MCP on Vinkius and enter your Bilflo API Key.
2. Direct your AI client to use the Billing Management tools, specifying what data you need (e.g., 'Show me all timecards for last month').
3. Your agent executes the necessary calls and presents the structured information—like a list of approved hours or specific contractor details—in plain text.

## Frequently Asked Questions

**How do I find out who is currently placed? (Using list_placements)**
Run `list_placements`. This tool provides a current roster of all temporary assignments, letting you see which contractors and employees are working where right now.

**Can I check client details using get_client?**
Yes. You can use `get_client` to pull up specific account records instantly. This is useful for verifying a single company's contract history without listing every other client.

**What if I need all my workers listed? (Using list_contractors)**
Use `list_contractors`. It compiles a complete roster of your contingent workforce, giving you the names and IDs for everyone who works through the agency.

**How do I get timecards to check hours? (Using list_timecards)**
To see multiple timesheets, use `list_timecards`. This tool returns a batch of records, letting you quickly sort and filter entries by approval status or date range.

**Is there an easy way to check overtime rules? (Using list_overtime_rules)**
Yes, `list_overtime_rules` pulls the official configuration for payroll. It gives you the current system-wide standards so you don't have to search through policy manuals.

**I need detailed information on a single worker; how do I use `get_contractor`?**
It retrieves the full file for one specific contractor. You supply an ID, and the MCP returns their employment history, service agreements, and current billing rates.

**How do I get a new hire's record using `get_direct_hire`?**
This tool pulls all details for a single direct employee. You just need the ID to access their specific placement status, start date, and payroll information.

**If I know the client name but not the ID, how can I check them with `get_client`?**
You must provide the unique Client ID. This allows you to get a complete profile of that business, including contacts and billing details.

**Can I check the status of a specific timecard using the agent?**
Yes! Use the `get_timecard` tool with the Timecard ID. Your agent will fetch the latest status, including hours worked and approval state.

**How do I list all the active contractors in Bilflo?**
Simply ask the agent to `list_contractors`. It will retrieve the directory of all contingent workers registered in your Bilflo account.

**Does the integration allow me to approve timecards directly?**
Currently, the toolset is focused on querying and auditing (listing timecards, checking statuses). Approving timecards for payroll must be performed within the Bilflo platform for compliance.