Skip to content
๐Ÿ’ธMintage Payroll

AI agents & integrations โ€‹

Mintage can be operated by other systems โ€” HR platforms, finance systems, other Mintage companies โ€” and by approved AI agents. Every route in is credentialed, scoped and audited.

Agent Gateway (MCP) โ€‹

The Agent Gateway module is an server. MCP (Model Context Protocol) is an open standard that lets AI assistants call tools. Mintage exposes roughly 90 payroll tools, for example:

AreaExample tools
Employeeslist, get, create, bulk create, update, terminate
Payrollassign to / remove from a period, read and update a period's values, recalculate, PAYE/NIS overrides, net-pay adjustments
Loans & childrencreate and adjust loans, add child allowances
Organisationdepartments (including a merge with preview), designations, locations
Configurationcustom fields, tax table versions, company settings
Lifecyclelock/unlock net pay, preview โ†’ close a payroll, preview โ†’ purge an employee

Setting up an agent โ€‹

Customization โ†’ MCP โ†’ Create client, then:

  1. Choose an access preset โ€” Read only or Manage โ€” and scopes (employees, payroll, settings, company, organisation).
  2. Add extra grants only if needed: Purge employees, Read sensitive data (otherwise bank details and TIN are hidden), Manage payroll lifecycle (lock and unlock net pay, close a payroll).
  3. Optionally restrict the IP addresses it can connect from.
  4. Copy the one-time configuration into the AI client. Tokens expire and can be rotated or revoked.

There is no self-registration: an administrator creates every agent client.

Built-in safety โ€‹

RuleWhy
Every write carries a unique request IDRetries can't apply the same change twice
Writes must send the record's last-seen version or checksumNo overwriting someone else's newer change
Changing a past period needs explicit confirmationHistory isn't rewritten by accident
Locked payrolls must be unlocked by a humanApproved pay stays approved
Close and purge are two-step: preview โ†’ short-lived token โ†’ confirmNo irreversible action in one call
The agent acts as its own service user, never as an adminClear accountability
Everything is auditedYou can see what the agent did

Machine-to-machine (M2M) clients โ€‹

Customization โ†’ M2M API Clients issues OAuth "client credentials" for system-to-system integrations, each with its own scopes: employees, users, payroll fields, PAYE versions, data sync, exchange, the employee-app relay and billing. The secret is shown once.

Typical integrations:

  • Mintage Workforce (HR) โ†’ employee changes flow into Data Sync, where staff accept or reject them.
  • Mintage Connect โ†’ the employee app reads payslips, loans and Form 7B through a relay.
  • Another Mintage company โ†’ move one employee with full history (Exchange).
  • Finance / ERP โ†’ journal exports mapped to the general ledger.
  • Time & attendance โ†’ biometric clocks, scheduling and time-tracking imports.

Built with the Invernisoft KB house.