Appearance
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:
| Area | Example tools |
|---|---|
| Employees | list, get, create, bulk create, update, terminate |
| Payroll | assign to / remove from a period, read and update a period's values, recalculate, PAYE/NIS overrides, net-pay adjustments |
| Loans & children | create and adjust loans, add child allowances |
| Organisation | departments (including a merge with preview), designations, locations |
| Configuration | custom fields, tax table versions, company settings |
| Lifecycle | lock/unlock net pay, preview โ close a payroll, preview โ purge an employee |
Setting up an agent โ
Customization โ MCP โ Create client, then:
- Choose an access preset โ Read only or Manage โ and scopes (employees, payroll, settings, company, organisation).
- 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).
- Optionally restrict the IP addresses it can connect from.
- 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 โ
| Rule | Why |
|---|---|
| Every write carries a unique request ID | Retries can't apply the same change twice |
| Writes must send the record's last-seen version or checksum | No overwriting someone else's newer change |
| Changing a past period needs explicit confirmation | History isn't rewritten by accident |
| Locked payrolls must be unlocked by a human | Approved pay stays approved |
| Close and purge are two-step: preview โ short-lived token โ confirm | No irreversible action in one call |
| The agent acts as its own service user, never as an admin | Clear accountability |
| Everything is audited | You 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.