Payroll

Every Payroll tool, with the scope it needs, its arguments and the API operation it calls.

47 tools

Approve payroll compensation revisions HR

Changes data

atlas_payroll_compensation_revisions_hr_approve

HR-approve a MANAGER_APPROVED comp revision. Creates new EmployeeSalary atomically.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/compensation-revisions/{id}/hr-approve
Example prompt: HR-approve rev_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll compensation revisions

Read only

atlas_payroll_compensation_revisions_list

List compensation revision requests. Filter by employee or status.

Scope: payroll:read
Calls: GET /v1/hr/payroll/compensation-revisions
Example prompt: Show me PENDING comp revisions.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	No
`status`	`"PENDING" \| "MANAGER_APPROVED" \| "HR_APPROVED" \| "REJECTED" \| "APPLIED"`	No

Approve payroll compensation revisions manager

Changes data

atlas_payroll_compensation_revisions_manager_approve

Manager-approve a PENDING comp revision (requester cannot self-approve).

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/compensation-revisions/{id}/manager-approve
Example prompt: Manager-approve rev_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Reject payroll compensation revisions

Changes data

atlas_payroll_compensation_revisions_reject

HR: reject a compensation revision with a reason.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/compensation-revisions/{id}/reject
Example prompt: Reject rev_xyz: out of band.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Request payroll compensation revisions

Changes data

atlas_payroll_compensation_revisions_request

File a new compensation revision for an employee (lands in PENDING).

Scope: payroll:write
Calls: POST /v1/hr/payroll/compensation-revisions
Example prompt: Request a 12L revision for emp_xyz effective 1 Jul.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	Yes
`newSalaryStructureId`	`string`	No
`newBaseAmount`	`number`	Yes
`newCurrency`	`string`	Yes
`effectiveFrom`	`string`	Yes	ISO date the revision takes effect.
`reason`	`string`	No

Approve payroll employee loans

Changes data

atlas_payroll_employee_loans_approve

HR: approve a pending employee loan or advance request.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/approve
Example prompt: Approve loan loan_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Close payroll employee loans

Changes data

atlas_payroll_employee_loans_close

HR: close an employee loan or advance (early settlement).

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/close
Example prompt: Close loan loan_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Disburse payroll employee loans

Changes data

atlas_payroll_employee_loans_disburse

HR: disburse an approved loan (move to ACTIVE and seed the running balance).

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/disburse
Example prompt: Disburse loan loan_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`asPayslipId`	`string`	No

List payroll employee loans

Read only

atlas_payroll_employee_loans_list

List employee loans and salary advances. Filter by employee or status.

Scope: payroll:read
Calls: GET /v1/hr/payroll/loans
Example prompt: Show me all ACTIVE loans.

Arguments

Field	Type	Required
`employeeId`	`string`	No
`status`	`"REQUESTED" \| "APPROVED" \| "ACTIVE" \| "CLOSED" \| "REJECTED"`	No
`limit`	`integer`	No

Reject payroll employee loans

Changes data

atlas_payroll_employee_loans_reject

HR: reject a pending employee loan or advance request with a reason.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/reject
Example prompt: Reject loan loan_xyz: budget freeze.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Request payroll employee loans

Changes data

atlas_payroll_employee_loans_request

File a new employee loan or salary advance request (HR or self-service).

Scope: payroll:write
Calls: POST /v1/hr/payroll/loans
Example prompt: File a loan request for emp_xyz: 60000 over 12 months.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	No	Required for admin filing; omit for self-service.
`kind`	`"LOAN" \| "ADVANCE"`	No
`principal`	`number`	Yes
`currency`	`string`	Yes
`interestRatePct`	`number`	No
`tenureMonths`	`integer`	Yes
`startMonth`	`string`	Yes	YYYY-MM the EMI starts deducting.
`notes`	`string`	No

Assign payroll employee salaries

Changes data

atlas_payroll_employee_salaries_assign

Assign a salary structure and monthly basic pay to an employee with an effective-from date.

Scope: payroll:write
Calls: POST /v1/hr/payroll/employee-salaries
Example prompt: Set emp_abc on a 20 lakh CTC starting next month.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	Yes	Employee id, from atlas_hr_employees_list.
`structureId`	`string`	Yes	Salary structure id, from atlas_payroll_salary_structures_list.
`effectiveFrom`	`string`	Yes	Date the assignment takes effect (YYYY-MM-DD).
`effectiveTo`	`string`	No	Last date the assignment applies (YYYY-MM-DD).
`baseAmount`	`number`	Yes	Monthly basic pay. Payroll computes PERCENT_OF_BASIC components from it. This is not an annual cost to company.
`currency`	`string`	Yes	ISO-4217 currency code, for example INR.

List payroll employee salaries

Read only

atlas_payroll_employee_salaries_list

List per-employee salary assignments. Filter by employee.

Scope: payroll:read
Calls: GET /v1/hr/payroll/employee-salaries
Example prompt: What salary is emp_abc on?

Arguments

Field	Type	Required	Description
`employeeId`	`string`	No

Approve payroll full and final settlements

Changes data

atlas_payroll_full_and_final_settlements_approve

HR: approve a CALCULATED Full and Final settlement so it can be marked paid.

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/approve
Example prompt: Approve F+F ff_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Calculate payroll full and final settlements

Changes data

atlas_payroll_full_and_final_settlements_calculate

HR: compute pro-rated salary + leave encashment + gratuity + bonus minus loan + advance + notice shortfall for a F+F settlement.

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/calculate
Example prompt: Calculate F+F ff_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Cancel payroll full and final settlements

Destructive

atlas_payroll_full_and_final_settlements_cancel

HR: cancel a Full and Final settlement (cannot cancel a PAID record).

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/cancel
Example prompt: Cancel F+F ff_xyz: termination reversed.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Create payroll full and final settlements

Changes data

atlas_payroll_full_and_final_settlements_create

HR: initiate a Full and Final settlement for a terminated employee (creates a DRAFT record).

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final
Example prompt: Start a F+F for emp_xyz terminated 30 Jun.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	Yes
`terminationDate`	`string`	Yes	ISO date the employee was terminated.
`notes`	`string`	No

Get payroll full and final settlements

Read only

atlas_payroll_full_and_final_settlements_get

HR: fetch a single Full and Final settlement by id (all line items + status).

Scope: payroll:read
Calls: GET /v1/hr/payroll/full-and-final/{id}
Example prompt: Show me F+F ff_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Record payroll full and final settlements payment

Changes data

atlas_payroll_full_and_final_settlements_payment_record

HR: mark an APPROVED Full and Final settlement as paid out (optionally linked to a payslip).

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/mark-paid
Example prompt: Mark F+F ff_xyz as paid.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`payslipId`	`string`	No	Optional payslip id the settlement was paid through.

Approve payroll pay runs

Destructive

atlas_payroll_pay_runs_approve

Approve a calculated pay-run so it can be marked paid.

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs/{id}/approve
Example prompt: Approve the May pay-run.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Calculate payroll pay runs

Destructive

atlas_payroll_pay_runs_calculate

Calculate (or recalculate) lines for a DRAFT pay-run. Idempotent per call.

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs/{id}/calculate
Example prompt: Calculate the May pay-run.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create payroll pay runs

Destructive

atlas_payroll_pay_runs_create

Create a new pay-run with a name, period start and end, pay date and currency (default status DRAFT).

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs
Example prompt: Spin up a pay-run for May 2026.

Arguments

Field	Type	Required	Description
`name`	`string`	Yes	Pay-run name, for example "October 2026".
`periodStart`	`string`	Yes	First day of the pay period (YYYY-MM-DD).
`periodEnd`	`string`	Yes	Last day of the pay period (YYYY-MM-DD).
`payDate`	`string`	Yes	Date the run pays out on (YYYY-MM-DD).
`currency`	`string`	Yes	ISO-4217 currency code, for example INR.

Get payroll pay runs

Read only

atlas_payroll_pay_runs_get

Fetch a single pay-run by id, including its computed lines if calculated.

Scope: payroll:read
Calls: GET /v1/hr/payroll/pay-runs/{id}
Example prompt: Show me the May pay-run.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll pay runs

Read only

atlas_payroll_pay_runs_list

List pay-runs in the tenant. Filter by status or period.

Scope: payroll:read
Calls: GET /v1/hr/payroll/pay-runs
Example prompt: What pay-runs are still in DRAFT?

Arguments

Field	Type	Required	Description
`status`	`string`	No
`limit`	`integer`	No	Page size, 1 to 100.

Record payroll pay runs payment

Destructive

atlas_payroll_pay_runs_payment_record

Mark an approved pay-run as paid out.

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs/{id}/mark-paid
Example prompt: Mark the May pay-run as paid.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 1099-NEC URL

Read only

atlas_payroll_payslips_form1099nec_url_get

Return the URL for a US Form 1099-NEC (non-employee compensation) PDF.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/1099-nec
Example prompt: Get the 1099-NEC URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 16 URL

Read only

atlas_payroll_payslips_form16_url_get

Return the URL for an India Form 16 (annual TDS certificate) PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/form16
Example prompt: Get the Form 16 URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 16A URL

Read only

atlas_payroll_payslips_form16a_url_get

Return the URL for an India Form 16A (non-salary TDS) PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/form16a
Example prompt: Get the Form 16A URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 940 URL

Read only

atlas_payroll_payslips_form940_url_get

Return the URL for a US Form 940 (annual FUTA) PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/form940
Example prompt: Get the Form 940 URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips

Read only

atlas_payroll_payslips_get

Fetch a single payslip with earning, deduction, and net amount lines.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}
Example prompt: Show me payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll payslips

Read only

atlas_payroll_payslips_list

List payslips. Filter by employee, pay-run, or period.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips
Example prompt: List emp_abc's 2026 payslips.

Arguments

Field	Type	Required
`employeeId`	`string`	No
`payRunId`	`string`	No
`limit`	`integer`	No

Get payroll payslips W-2 URL

Read only

atlas_payroll_payslips_w2_url_get

Return the URL for a US Form W-2 PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/w2
Example prompt: Get the W-2 URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create payroll salary structures

Changes data

atlas_payroll_salary_structures_create

Create a salary structure template with an effective-from date, a currency and its pay components.

Scope: payroll:write
Calls: POST /v1/hr/payroll/salary-structures
Example prompt: Create a standard salary structure with HRA, basic, and TDS components.

Arguments

Field	Type	Required	Description
`name`	`string`	Yes
`description`	`string`	No
`effectiveFrom`	`string`	Yes	Date the structure takes effect (YYYY-MM-DD).
`effectiveTo`	`string`	No	Last date the structure applies (YYYY-MM-DD).
`currency`	`string`	Yes	ISO-4217 currency code, for example INR.
`appliesToEmploymentTypes`	`array of "FULL_TIME" \| "PART_TIME" \| "CONTRACT" \| "INTERN" \| "CONSULTANT"`	No	Employment types the structure applies to. Empty or omitted means all.
`components`	`array of object`	Yes

List payroll salary structures

Read only

atlas_payroll_salary_structures_list

List salary structures (component templates) configured for the tenant.

Scope: payroll:read
Calls: GET /v1/hr/payroll/salary-structures
Example prompt: What salary structures do we have?

Arguments

This tool takes no arguments.

Update payroll salary structures

Changes data

atlas_payroll_salary_structures_update

Patch top-level fields on a salary structure template. Components cannot be changed; create a new structure instead.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/salary-structures/{id}
Example prompt: Tweak the HRA formula on sal_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Salary structure id, from atlas_payroll_salary_structures_list.
`patch`	`object`	Yes	Top-level fields to update. Components cannot be changed.

Generate payroll statutory ESIC ECR

Read only

atlas_payroll_statutory_esic_ecr_generate

Generate the ESIC Electronic Challan-cum-Return (ECR) CSV for a YYYY-MM payroll month.

Scope: hr:read
Calls: GET /v1/hr/statutory/esic-ecr
Example prompt: Generate the ESIC ECR for June 2026.

Arguments

Field	Type	Required	Description
`month`	`string`	Yes	Period in YYYY-MM, e.g. 2026-06.

Create payroll statutory filings

Changes data

atlas_payroll_statutory_filings_create

Create a new statutory filing record for a period.

Scope: hr:write
Calls: POST /v1/hr/admin/statutory-filings
Example prompt: Open a Q1 PF filing.

Arguments

Field	Type	Required	Description
`country`	`string`	Yes
`regime`	`string`	No
`filingType`	`string`	Yes	e.g. PF, ESI, TDS_24Q, 941.
`periodStart`	`string`	Yes	ISO date.
`periodEnd`	`string`	Yes	ISO date.

Get payroll statutory filings

Read only

atlas_payroll_statutory_filings_get

Fetch a single statutory filing by id.

Scope: hr:read
Calls: GET /v1/hr/admin/statutory-filings/{id}
Example prompt: Show me filing fil_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll statutory filings

Read only

atlas_payroll_statutory_filings_list

List statutory filings (PF, ESI, TDS, 941, etc.). Filter by country or status.

Scope: hr:read
Calls: GET /v1/hr/admin/statutory-filings
Example prompt: What statutory filings are pending?

Arguments

Field	Type	Required
`country`	`string`	No
`status`	`string`	No
`limit`	`integer`	No

Generate payroll statutory Form 24Q

Read only

atlas_payroll_statutory_form24q_generate

Generate the Form 24Q TRACES quarterly salary TDS upload file (tab-separated TXT) for the requested quarter + financial year.

Scope: hr:read
Calls: GET /v1/hr/statutory/form24q
Example prompt: Generate Form 24Q for Q1 FY 2026-27.

Arguments

Field	Type	Required	Description
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	TRACES quarter (Apr-Mar FY).
`fy`	`string`	Yes	Financial year, e.g. 2026-27.

Get payroll statutory Form 24Q URL

Read only

atlas_payroll_statutory_form24q_url_get

Return the API path for the India Form 24Q quarterly salary TDS return, one CSV for the whole workspace, for one financial year and quarter. Compose it with the API base URL and an Authorization header to download. The employer name, TAN, PAN and BSR code must be set in the statutory settings first.

Scope: hr:read
Calls: GET /v1/hr/statutory/form24q
Example prompt: Get the Form 24Q return for the second quarter of 2026-27.

Arguments

Field	Type	Required	Description
`fy`	`string`	Yes	Indian financial year, written like 2026-27.
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	Quarter of the financial year: Q1 is April to June.

Generate payroll statutory Form 26Q

Read only

atlas_payroll_statutory_form26q_generate

Generate the Form 26Q TRACES quarterly non-salary TDS upload file (tab-separated TXT) covering s.194x deductions.

Scope: hr:read
Calls: GET /v1/hr/statutory/form26q
Example prompt: Generate Form 26Q for Q1 FY 2026-27.

Arguments

Field	Type	Required	Description
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	TRACES quarter (Apr-Mar FY).
`fy`	`string`	Yes	Financial year, e.g. 2026-27.

Get payroll statutory Form 941 URL

Read only

atlas_payroll_statutory_form941_url_get

Return the API path for the US Form 941 quarterly federal tax return, one PDF for the whole workspace, for one calendar year and quarter. It is built from every payslip paid in US dollars in the quarter: employees paid, wages, federal income tax withheld, and social security and Medicare wages and tax. Deposits are not recorded in Atlas, so the return leaves them for the person filing. Compose it with the API base URL and an Authorization header to download. A quarter with no US payslips is refused with a 422.

Scope: hr:read
Calls: GET /v1/hr/statutory/form941
Example prompt: Get the Form 941 return for the second quarter of 2026.

Arguments

Field	Type	Required	Description
`year`	`string`	Yes	Calendar year from 2000 to 2099, written like 2026.
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	Calendar quarter: Q1 is January to March.

Generate payroll statutory PF ECR

Read only

atlas_payroll_statutory_pf_ecr_generate

Generate the EPFO PF Electronic Challan-cum-Return (ECR) tilde-separated file for a YYYY-MM payroll month.

Scope: hr:read
Calls: GET /v1/hr/statutory/pf-ecr
Example prompt: Generate the PF ECR for June 2026.

Arguments

Field	Type	Required	Description
`month`	`string`	Yes	Period in YYYY-MM, e.g. 2026-06.

Approve payroll tax declarations

Changes data

atlas_payroll_tax_declarations_approve

HR-admin: approve an employee tax declaration.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/declarations/{id}/approve
Example prompt: Approve declaration dec_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll tax declarations

Read only

atlas_payroll_tax_declarations_list

HR-admin: list employee tax declarations. Filter by employee or status.

Scope: payroll:read
Calls: GET /v1/hr/payroll/declarations
Example prompt: Which declarations are pending HR approval?

Arguments

Field	Type	Required	Description
`fy`	`integer`	No	Financial year by its starting year, for example 2025 for 2025-26. The current year when omitted.
`status`	`"PENDING" \| "APPROVED" \| "REJECTED"`	No
`limit`	`integer`	No

Reject payroll tax declarations

Changes data

atlas_payroll_tax_declarations_reject

HR-admin: reject an employee tax declaration with a required reason.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/declarations/{id}/reject
Example prompt: Reject dec_xyz: missing rent receipt.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Tools reference

Payroll

Every Payroll tool, with the scope it needs, its arguments and the API operation it calls.

47 tools

Approve payroll compensation revisions HR

Changes data

atlas_payroll_compensation_revisions_hr_approve

HR-approve a MANAGER_APPROVED comp revision. Creates new EmployeeSalary atomically.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/compensation-revisions/{id}/hr-approve
Example prompt: HR-approve rev_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll compensation revisions

Read only

atlas_payroll_compensation_revisions_list

List compensation revision requests. Filter by employee or status.

Scope: payroll:read
Calls: GET /v1/hr/payroll/compensation-revisions
Example prompt: Show me PENDING comp revisions.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	No
`status`	`"PENDING" \| "MANAGER_APPROVED" \| "HR_APPROVED" \| "REJECTED" \| "APPLIED"`	No

Approve payroll compensation revisions manager

Changes data

atlas_payroll_compensation_revisions_manager_approve

Manager-approve a PENDING comp revision (requester cannot self-approve).

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/compensation-revisions/{id}/manager-approve
Example prompt: Manager-approve rev_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Reject payroll compensation revisions

Changes data

atlas_payroll_compensation_revisions_reject

HR: reject a compensation revision with a reason.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/compensation-revisions/{id}/reject
Example prompt: Reject rev_xyz: out of band.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Request payroll compensation revisions

Changes data

atlas_payroll_compensation_revisions_request

File a new compensation revision for an employee (lands in PENDING).

Scope: payroll:write
Calls: POST /v1/hr/payroll/compensation-revisions
Example prompt: Request a 12L revision for emp_xyz effective 1 Jul.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	Yes
`newSalaryStructureId`	`string`	No
`newBaseAmount`	`number`	Yes
`newCurrency`	`string`	Yes
`effectiveFrom`	`string`	Yes	ISO date the revision takes effect.
`reason`	`string`	No

Approve payroll employee loans

Changes data

atlas_payroll_employee_loans_approve

HR: approve a pending employee loan or advance request.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/approve
Example prompt: Approve loan loan_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Close payroll employee loans

Changes data

atlas_payroll_employee_loans_close

HR: close an employee loan or advance (early settlement).

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/close
Example prompt: Close loan loan_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Disburse payroll employee loans

Changes data

atlas_payroll_employee_loans_disburse

HR: disburse an approved loan (move to ACTIVE and seed the running balance).

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/disburse
Example prompt: Disburse loan loan_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`asPayslipId`	`string`	No

List payroll employee loans

Read only

atlas_payroll_employee_loans_list

List employee loans and salary advances. Filter by employee or status.

Scope: payroll:read
Calls: GET /v1/hr/payroll/loans
Example prompt: Show me all ACTIVE loans.

Arguments

Field	Type	Required
`employeeId`	`string`	No
`status`	`"REQUESTED" \| "APPROVED" \| "ACTIVE" \| "CLOSED" \| "REJECTED"`	No
`limit`	`integer`	No

Reject payroll employee loans

Changes data

atlas_payroll_employee_loans_reject

HR: reject a pending employee loan or advance request with a reason.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/loans/{id}/reject
Example prompt: Reject loan loan_xyz: budget freeze.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Request payroll employee loans

Changes data

atlas_payroll_employee_loans_request

File a new employee loan or salary advance request (HR or self-service).

Scope: payroll:write
Calls: POST /v1/hr/payroll/loans
Example prompt: File a loan request for emp_xyz: 60000 over 12 months.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	No	Required for admin filing; omit for self-service.
`kind`	`"LOAN" \| "ADVANCE"`	No
`principal`	`number`	Yes
`currency`	`string`	Yes
`interestRatePct`	`number`	No
`tenureMonths`	`integer`	Yes
`startMonth`	`string`	Yes	YYYY-MM the EMI starts deducting.
`notes`	`string`	No

Assign payroll employee salaries

Changes data

atlas_payroll_employee_salaries_assign

Assign a salary structure and monthly basic pay to an employee with an effective-from date.

Scope: payroll:write
Calls: POST /v1/hr/payroll/employee-salaries
Example prompt: Set emp_abc on a 20 lakh CTC starting next month.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	Yes	Employee id, from atlas_hr_employees_list.
`structureId`	`string`	Yes	Salary structure id, from atlas_payroll_salary_structures_list.
`effectiveFrom`	`string`	Yes	Date the assignment takes effect (YYYY-MM-DD).
`effectiveTo`	`string`	No	Last date the assignment applies (YYYY-MM-DD).
`baseAmount`	`number`	Yes	Monthly basic pay. Payroll computes PERCENT_OF_BASIC components from it. This is not an annual cost to company.
`currency`	`string`	Yes	ISO-4217 currency code, for example INR.

List payroll employee salaries

Read only

atlas_payroll_employee_salaries_list

List per-employee salary assignments. Filter by employee.

Scope: payroll:read
Calls: GET /v1/hr/payroll/employee-salaries
Example prompt: What salary is emp_abc on?

Arguments

Field	Type	Required	Description
`employeeId`	`string`	No

Approve payroll full and final settlements

Changes data

atlas_payroll_full_and_final_settlements_approve

HR: approve a CALCULATED Full and Final settlement so it can be marked paid.

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/approve
Example prompt: Approve F+F ff_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Calculate payroll full and final settlements

Changes data

atlas_payroll_full_and_final_settlements_calculate

HR: compute pro-rated salary + leave encashment + gratuity + bonus minus loan + advance + notice shortfall for a F+F settlement.

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/calculate
Example prompt: Calculate F+F ff_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Cancel payroll full and final settlements

Destructive

atlas_payroll_full_and_final_settlements_cancel

HR: cancel a Full and Final settlement (cannot cancel a PAID record).

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/cancel
Example prompt: Cancel F+F ff_xyz: termination reversed.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

Create payroll full and final settlements

Changes data

atlas_payroll_full_and_final_settlements_create

HR: initiate a Full and Final settlement for a terminated employee (creates a DRAFT record).

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final
Example prompt: Start a F+F for emp_xyz terminated 30 Jun.

Arguments

Field	Type	Required	Description
`employeeId`	`string`	Yes
`terminationDate`	`string`	Yes	ISO date the employee was terminated.
`notes`	`string`	No

Get payroll full and final settlements

Read only

atlas_payroll_full_and_final_settlements_get

HR: fetch a single Full and Final settlement by id (all line items + status).

Scope: payroll:read
Calls: GET /v1/hr/payroll/full-and-final/{id}
Example prompt: Show me F+F ff_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Record payroll full and final settlements payment

Changes data

atlas_payroll_full_and_final_settlements_payment_record

HR: mark an APPROVED Full and Final settlement as paid out (optionally linked to a payslip).

Scope: payroll:write
Calls: POST /v1/hr/payroll/full-and-final/{id}/mark-paid
Example prompt: Mark F+F ff_xyz as paid.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`payslipId`	`string`	No	Optional payslip id the settlement was paid through.

Approve payroll pay runs

Destructive

atlas_payroll_pay_runs_approve

Approve a calculated pay-run so it can be marked paid.

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs/{id}/approve
Example prompt: Approve the May pay-run.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Calculate payroll pay runs

Destructive

atlas_payroll_pay_runs_calculate

Calculate (or recalculate) lines for a DRAFT pay-run. Idempotent per call.

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs/{id}/calculate
Example prompt: Calculate the May pay-run.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create payroll pay runs

Destructive

atlas_payroll_pay_runs_create

Create a new pay-run with a name, period start and end, pay date and currency (default status DRAFT).

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs
Example prompt: Spin up a pay-run for May 2026.

Arguments

Field	Type	Required	Description
`name`	`string`	Yes	Pay-run name, for example "October 2026".
`periodStart`	`string`	Yes	First day of the pay period (YYYY-MM-DD).
`periodEnd`	`string`	Yes	Last day of the pay period (YYYY-MM-DD).
`payDate`	`string`	Yes	Date the run pays out on (YYYY-MM-DD).
`currency`	`string`	Yes	ISO-4217 currency code, for example INR.

Get payroll pay runs

Read only

atlas_payroll_pay_runs_get

Fetch a single pay-run by id, including its computed lines if calculated.

Scope: payroll:read
Calls: GET /v1/hr/payroll/pay-runs/{id}
Example prompt: Show me the May pay-run.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll pay runs

Read only

atlas_payroll_pay_runs_list

List pay-runs in the tenant. Filter by status or period.

Scope: payroll:read
Calls: GET /v1/hr/payroll/pay-runs
Example prompt: What pay-runs are still in DRAFT?

Arguments

Field	Type	Required	Description
`status`	`string`	No
`limit`	`integer`	No	Page size, 1 to 100.

Record payroll pay runs payment

Destructive

atlas_payroll_pay_runs_payment_record

Mark an approved pay-run as paid out.

Scope: payroll:write
Calls: POST /v1/hr/payroll/pay-runs/{id}/mark-paid
Example prompt: Mark the May pay-run as paid.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 1099-NEC URL

Read only

atlas_payroll_payslips_form1099nec_url_get

Return the URL for a US Form 1099-NEC (non-employee compensation) PDF.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/1099-nec
Example prompt: Get the 1099-NEC URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 16 URL

Read only

atlas_payroll_payslips_form16_url_get

Return the URL for an India Form 16 (annual TDS certificate) PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/form16
Example prompt: Get the Form 16 URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 16A URL

Read only

atlas_payroll_payslips_form16a_url_get

Return the URL for an India Form 16A (non-salary TDS) PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/form16a
Example prompt: Get the Form 16A URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips Form 940 URL

Read only

atlas_payroll_payslips_form940_url_get

Return the URL for a US Form 940 (annual FUTA) PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/form940
Example prompt: Get the Form 940 URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Get payroll payslips

Read only

atlas_payroll_payslips_get

Fetch a single payslip with earning, deduction, and net amount lines.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}
Example prompt: Show me payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll payslips

Read only

atlas_payroll_payslips_list

List payslips. Filter by employee, pay-run, or period.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips
Example prompt: List emp_abc's 2026 payslips.

Arguments

Field	Type	Required
`employeeId`	`string`	No
`payRunId`	`string`	No
`limit`	`integer`	No

Get payroll payslips W-2 URL

Read only

atlas_payroll_payslips_w2_url_get

Return the URL for a US Form W-2 PDF for one payslip.

Scope: payroll:read
Calls: GET /v1/hr/payroll/payslips/{id}/w2
Example prompt: Get the W-2 URL for payslip pys_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

Create payroll salary structures

Changes data

atlas_payroll_salary_structures_create

Create a salary structure template with an effective-from date, a currency and its pay components.

Scope: payroll:write
Calls: POST /v1/hr/payroll/salary-structures
Example prompt: Create a standard salary structure with HRA, basic, and TDS components.

Arguments

Field	Type	Required	Description
`name`	`string`	Yes
`description`	`string`	No
`effectiveFrom`	`string`	Yes	Date the structure takes effect (YYYY-MM-DD).
`effectiveTo`	`string`	No	Last date the structure applies (YYYY-MM-DD).
`currency`	`string`	Yes	ISO-4217 currency code, for example INR.
`appliesToEmploymentTypes`	`array of "FULL_TIME" \| "PART_TIME" \| "CONTRACT" \| "INTERN" \| "CONSULTANT"`	No	Employment types the structure applies to. Empty or omitted means all.
`components`	`array of object`	Yes

List payroll salary structures

Read only

atlas_payroll_salary_structures_list

List salary structures (component templates) configured for the tenant.

Scope: payroll:read
Calls: GET /v1/hr/payroll/salary-structures
Example prompt: What salary structures do we have?

Arguments

This tool takes no arguments.

Update payroll salary structures

Changes data

atlas_payroll_salary_structures_update

Patch top-level fields on a salary structure template. Components cannot be changed; create a new structure instead.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/salary-structures/{id}
Example prompt: Tweak the HRA formula on sal_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes	Salary structure id, from atlas_payroll_salary_structures_list.
`patch`	`object`	Yes	Top-level fields to update. Components cannot be changed.

Generate payroll statutory ESIC ECR

Read only

atlas_payroll_statutory_esic_ecr_generate

Generate the ESIC Electronic Challan-cum-Return (ECR) CSV for a YYYY-MM payroll month.

Scope: hr:read
Calls: GET /v1/hr/statutory/esic-ecr
Example prompt: Generate the ESIC ECR for June 2026.

Arguments

Field	Type	Required	Description
`month`	`string`	Yes	Period in YYYY-MM, e.g. 2026-06.

Create payroll statutory filings

Changes data

atlas_payroll_statutory_filings_create

Create a new statutory filing record for a period.

Scope: hr:write
Calls: POST /v1/hr/admin/statutory-filings
Example prompt: Open a Q1 PF filing.

Arguments

Field	Type	Required	Description
`country`	`string`	Yes
`regime`	`string`	No
`filingType`	`string`	Yes	e.g. PF, ESI, TDS_24Q, 941.
`periodStart`	`string`	Yes	ISO date.
`periodEnd`	`string`	Yes	ISO date.

Get payroll statutory filings

Read only

atlas_payroll_statutory_filings_get

Fetch a single statutory filing by id.

Scope: hr:read
Calls: GET /v1/hr/admin/statutory-filings/{id}
Example prompt: Show me filing fil_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll statutory filings

Read only

atlas_payroll_statutory_filings_list

List statutory filings (PF, ESI, TDS, 941, etc.). Filter by country or status.

Scope: hr:read
Calls: GET /v1/hr/admin/statutory-filings
Example prompt: What statutory filings are pending?

Arguments

Field	Type	Required
`country`	`string`	No
`status`	`string`	No
`limit`	`integer`	No

Generate payroll statutory Form 24Q

Read only

atlas_payroll_statutory_form24q_generate

Generate the Form 24Q TRACES quarterly salary TDS upload file (tab-separated TXT) for the requested quarter + financial year.

Scope: hr:read
Calls: GET /v1/hr/statutory/form24q
Example prompt: Generate Form 24Q for Q1 FY 2026-27.

Arguments

Field	Type	Required	Description
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	TRACES quarter (Apr-Mar FY).
`fy`	`string`	Yes	Financial year, e.g. 2026-27.

Get payroll statutory Form 24Q URL

Read only

atlas_payroll_statutory_form24q_url_get

Scope: hr:read
Calls: GET /v1/hr/statutory/form24q
Example prompt: Get the Form 24Q return for the second quarter of 2026-27.

Arguments

Field	Type	Required	Description
`fy`	`string`	Yes	Indian financial year, written like 2026-27.
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	Quarter of the financial year: Q1 is April to June.

Generate payroll statutory Form 26Q

Read only

atlas_payroll_statutory_form26q_generate

Generate the Form 26Q TRACES quarterly non-salary TDS upload file (tab-separated TXT) covering s.194x deductions.

Scope: hr:read
Calls: GET /v1/hr/statutory/form26q
Example prompt: Generate Form 26Q for Q1 FY 2026-27.

Arguments

Field	Type	Required	Description
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	TRACES quarter (Apr-Mar FY).
`fy`	`string`	Yes	Financial year, e.g. 2026-27.

Get payroll statutory Form 941 URL

Read only

atlas_payroll_statutory_form941_url_get

Scope: hr:read
Calls: GET /v1/hr/statutory/form941
Example prompt: Get the Form 941 return for the second quarter of 2026.

Arguments

Field	Type	Required	Description
`year`	`string`	Yes	Calendar year from 2000 to 2099, written like 2026.
`quarter`	`"Q1" \| "Q2" \| "Q3" \| "Q4"`	Yes	Calendar quarter: Q1 is January to March.

Generate payroll statutory PF ECR

Read only

atlas_payroll_statutory_pf_ecr_generate

Generate the EPFO PF Electronic Challan-cum-Return (ECR) tilde-separated file for a YYYY-MM payroll month.

Scope: hr:read
Calls: GET /v1/hr/statutory/pf-ecr
Example prompt: Generate the PF ECR for June 2026.

Arguments

Field	Type	Required	Description
`month`	`string`	Yes	Period in YYYY-MM, e.g. 2026-06.

Approve payroll tax declarations

Changes data

atlas_payroll_tax_declarations_approve

HR-admin: approve an employee tax declaration.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/declarations/{id}/approve
Example prompt: Approve declaration dec_xyz.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes

List payroll tax declarations

Read only

atlas_payroll_tax_declarations_list

HR-admin: list employee tax declarations. Filter by employee or status.

Scope: payroll:read
Calls: GET /v1/hr/payroll/declarations
Example prompt: Which declarations are pending HR approval?

Arguments

Field	Type	Required	Description
`fy`	`integer`	No	Financial year by its starting year, for example 2025 for 2025-26. The current year when omitted.
`status`	`"PENDING" \| "APPROVED" \| "REJECTED"`	No
`limit`	`integer`	No

Reject payroll tax declarations

Changes data

atlas_payroll_tax_declarations_reject

HR-admin: reject an employee tax declaration with a required reason.

Scope: payroll:write
Calls: PATCH /v1/hr/payroll/declarations/{id}/reject
Example prompt: Reject dec_xyz: missing rent receipt.

Arguments

Field	Type	Required	Description
`id`	`string`	Yes
`reason`	`string`	Yes

You are in control of your cookies

Payroll

Approve payroll compensation revisions HR

Arguments

List payroll compensation revisions

Arguments

Approve payroll compensation revisions manager

Arguments

Reject payroll compensation revisions

Arguments

Request payroll compensation revisions

Arguments

Approve payroll employee loans

Arguments

Close payroll employee loans

Arguments

Disburse payroll employee loans

Arguments

List payroll employee loans

Arguments

Reject payroll employee loans

Arguments

Request payroll employee loans

Arguments

Assign payroll employee salaries

Arguments

List payroll employee salaries

Arguments

Approve payroll full and final settlements

Arguments

Calculate payroll full and final settlements

Arguments

Cancel payroll full and final settlements

Arguments

Create payroll full and final settlements

Arguments

Get payroll full and final settlements

Arguments

Record payroll full and final settlements payment

Arguments

Approve payroll pay runs

Arguments

Calculate payroll pay runs

Arguments

Create payroll pay runs

Arguments

Get payroll pay runs

Arguments

List payroll pay runs

Arguments

Record payroll pay runs payment

Arguments

Get payroll payslips Form 1099-NEC URL

Arguments

Get payroll payslips Form 16 URL

Arguments

Get payroll payslips Form 16A URL

Arguments

Get payroll payslips Form 940 URL

Arguments

Get payroll payslips

Arguments

List payroll payslips

Arguments

Get payroll payslips W-2 URL

Arguments

Create payroll salary structures

Arguments

List payroll salary structures

Arguments

Update payroll salary structures

Arguments

Generate payroll statutory ESIC ECR

Arguments

Create payroll statutory filings

Arguments

Get payroll statutory filings

Arguments

List payroll statutory filings

Arguments