# Argyle MCP

> Argyle connects automated employment and income verification directly to your AI client. Quickly verify applicant financials, track payroll details, and audit job history for compliance or lending decisions using natural language prompts.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** employment-verification, income-verification, payroll-data, identity-verification, compliance

## Description

This MCP brings professional-grade financial data straight into your agent. Instead of manually compiling documents from various sources, you ask your AI client for specific user information—like current employment status or year-to-date income totals—and it gets the verified facts instantly. You can manage entire verification workflows simply by asking questions. For example, you'll start by listing all users in your account to see who needs checking, then retrieve their detailed job history. You can also monitor individual payout records to understand deductions and net pay. The system even lets you pull verified name and address details directly from payroll sources. Because this MCP lives on the Vinkius catalog, you connect once and get access to all these core financial tools for your entire organization.

## Tools

### create_user
Generates and registers a unique ID for a new individual to start the verification process.

### get_account_check
Runs a check to ensure your AI client is properly authorized to use Argyle's data.

### get_employment
Pulls the complete work history for a specific user ID, including job titles and start dates.

### get_income
Gathers detailed income figures for a user, breaking down YTD and monthly totals.

### list_identities
Retrieves verified personal data—like name, address, and contact info—for an individual.

### list_payouts
Provides a list of every payroll payment record for a user to show gross pay vs. deductions.

### list_users
Retrieves a list of all user accounts currently set up within your Argyle workspace.

## Prompt Examples

**Prompt:** 
```
List all users in my Argyle account.
```

**Response:** 
```
I've retrieved your user list. You have 50 users registered for verification, including recent IDs 'user_abc123' and 'user_xyz789'.
```

**Prompt:** 
```
Show me the employment history for user 'user_12345'.
```

**Response:** 
```
User 'user_12345' is currently employed as a 'Senior Developer' at 'TechCorp', with a hire date of Jan 15, 2020.
```

**Prompt:** 
```
What is the total YTD income for user 'user_abc'?
```

**Response:** 
```
The total YTD income for user 'user_abc' is $45,200.50, based on 12 verified payouts from their payroll source.
```

## Capabilities

### Check Account Status
Verifies that your AI client has proper authorization to access Argyle data.

### Manage User Records
Lists existing users or creates new unique IDs for verification flows.

### Verify Employment History
Pulls verified details like job title, employer name, and start dates for a specific individual.

### Calculate Income Totals
Retrieves comprehensive income breakdowns, including YTD figures and monthly totals.

### Analyze Payout Details
Lists every pay period record to show gross/net pay and specific deductions.

### Get Identity Information
Retrieves verified name, address, and contact details straight from the payroll source.

## Use Cases

### Underwriting a new loan applicant
The underwriter asks their agent, 'What is this user's employment status and total YTD income?' The agent uses get_employment and get_income to pull the necessary details in one go, avoiding a week of manual document collection.

### Internal HR audit for compliance
An HR officer needs to check if 50 employees have updated addresses. They run list_users first, then use list_identities on the resulting IDs to verify current contact information against the payroll source.

### Due diligence for a fintech partnership
A developer needs to build a new credit scoring tool. They connect Argyle MCP and use get_payouts combined with get_income to feed accurate, structured financial data into their product logic.

### Investigating discrepancies in payroll records
A finance manager suspects incorrect deductions. They ask the agent for list_payouts on a specific user ID and can immediately see the detailed breakdown of gross pay versus net pay, pinpointing the error.

## Benefits

- Audit history instantly: Instead of pulling paper documents, you can use get_employment to retrieve a user's full job history right through your agent.
- See the money trail: The list_payouts tool lets you examine every single pay period, showing exactly what was deducted and how much net pay arrived.
- Build profiles quickly: You start by listing all users or creating_user IDs to build a roster of people who need verification before running any checks.
- Get verified identity data: The list_identities tool pulls name, address, and contact information directly from the payroll source, removing manual entry errors.
- Calculate totals on demand: Need to know the total YTD income? Use get_income to pull accurate financial breakdowns in seconds.

## How It Works

The bottom line is that you get accurate, verified financial data without ever opening a separate HR dashboard.

1. First, your AI client confirms the Argyle account connection using the account check tool.
2. Next, you prompt your agent with a natural language request, asking it to pull specific data like income totals or employment history for a user.
3. The MCP executes the required function, and your agent returns clean, structured payroll data directly to your chat window.

## Frequently Asked Questions

**How do I list all users in my Argyle account?**
You call the list_users tool. This returns an immediate roster of every user ID you have registered for verification within your system.

**What is the difference between get_employment and list_identities using Argyle MCP?**
get_employment focuses only on job titles, employers, and dates. list_identities pulls general personal data like verified name, address, and phone number.

**Can I check an account's connection status with Argyle MCP?**
Yes, you run get_account_check. This confirms that your AI client has the necessary permissions to access all payroll data.

**How do I verify income totals using Argyle MCP?**
You use the get_income tool. Simply providing a user ID allows the agent to retrieve the full YTD and monthly breakdown of their earnings.

**Does list_payouts show deductions?**
Yes, it does. The list_payouts tool provides detailed information on every pay period, making sure you see both the gross pay amount and all associated deductions.