• MATCHED
  • MISMATCH
  • LISTED
  • HUMAN

How to audit payroll earnings and deductions with your AI

Connect KeyPay to your agent to pull granular pay run data. Once connected, you can ask your AI to cross-reference specific line items against your expected totals.

Ask AI about this page

Short answer

How can I audit payroll earnings and deductions with my AI?

Your agent pulls individual earnings and deduction line items from a specific KeyPay pay run. It then compares these values to the total amount to spot discrepancies. You get a clear breakdown of the math used for the run.

Audit outcomes

Where the data lands.

What your agent produces after checking the pay run.

MATCHED

Verified totals

The AI confirms the sum of all earnings and deductions matches the pay run total. You get a simple confirmation that the math is correct.

MISMATCH

Discrepancy alerts

If the math is off, your agent flags the exact difference. It points out which specific line item caused the imbalance.

LISTED

Itemized breakdowns

The agent generates a clean list of every earning and deduction found in the run. This replaces manual spreadsheet exports.

HUMAN

Manual corrections

The AI identifies errors but cannot change the payroll data. You must log into KeyPay to fix any incorrect entries yourself.

The workflow

What your AI does when the data arrives.

The agent moves through the pay run data to isolate and verify specific values.

  1. Fetch pay run data

    The agent pulls the high-level details for the specific pay run you are auditing.

    get_pay_run_details

  2. Extract earnings

    It pulls a complete list of every earning type and amount recorded in that run.

    list_pay_run_earnings

  3. Extract deductions

    The agent retrieves all deduction entries to ensure they are accounted for in the final total.

    list_pay_run_deductions

  4. Verify totals

    The agent sums the individual components and compares them to the pay run summary to find errors.

    get_pay_run_detailslist_pay_run_earningslist_pay_run_deductions

Try it

Copy these to start.

Use these prompts to begin your audit.

Starting points

Swap out the bracketed text for your actual pay run ID or employee name.

KeyPay Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_vs5aCUuKDAsrOmTWYJGNHpzCEssitb2WepI0qq0l/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — KeyPay capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "keypay-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_vs5aCUuKDAsrOmTWYJGNHpzCEssitb2WepI0qq0l/mcp"
    }
  }
}
Copy into chat04

  • Pull the earnings and deductions for pay run [ID] and check if they match the total.

  • List all deductions for [Employee Name] in the most recent pay run.

  • Compare the total earnings in pay run [ID] against the sum of individual earnings items.

  • Show me a breakdown of all deductions for the pay run from [Date].

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect KeyPay once, then ask.

Just link your account through the Vinkius dashboard. Your credentials stay encrypted, and you can immediately start asking your agent about your payroll data.

Connect KeyPay to your AI

FAQ

How this task behaves

  • 01

    Can my AI change a pay run if it finds an error?

    No. The agent can only read data. You have to go into KeyPay to make any actual changes to payroll records.

  • 02

    Can the AI delete deductions?

    No. This MCP only provides read access to your earnings and deductions.

  • 03

    Does the AI see my bank account details?

    No. The agent only accesses the specific earnings and deduction data provided by the KeyPay tools.

  • 04

    How does the AI know which pay run to look at?

    You tell the agent which pay run you want to audit by providing the ID or date in your prompt.

  • 05

    Can I audit multiple employees at once?

    Yes. You can ask your agent to compare earnings across different employees or multiple pay runs.

  • More questions about KeyPay? The Connector page answers them. See everything the KeyPay Connector can do

Connect KeyPay to Claude, Cursor, ChatGPT & more