# MCP reference

Generated on 2026-11-16. Where the build could read a server, the descriptions below are **the exact text the model receives** — nothing is rewritten for this page. Every public server needs an OAuth sign-in; a server the build could not sign in to is listed with its tools and their summaries.

Salaxy runs **one MCP server per Salaxy AI agent and country**, each in two environments: **demo** (a free demo account and sample data) and **production** (your own Salaxy account). Only Finland is live today; see [Availability](https://code.salaxy.com/about/availability.md) and [MCP authentication](https://code.salaxy.com/security/mcp-authentication.md).

## Finland — Payroll Agent, demo

| | |
|---|---|
| Endpoint | `https://demo-payroll.salaxy.com/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth sign-in with a free demo account |
| Status | [Live] |

Try the Payroll Agent on sample data: employments, calculations, payrolls, absences, holidays and invoices. Nothing real is paid or reported.

| Tool | Summary |
|---|---|
| `employer_list` | List the employers the user may act for: their own account and the accounts that have authorised them — e.g. an accounting firm's customers. |
| `employer_select` | Select the employer the other tools work in when no employer id is given — only after the user has chosen; never chosen for the user. |
| `calculation_preview` | Preview a salary calculation. |
| `calculation_create` | Create a salary calculation. |
| `calculation_set_rows` | Set salary rows of a calculation. |
| `calculation_update` | Update a salary calculation. |
| `calculation_get_summary` | Get a calculation summary. |
| `calculation_show_slip` | Show the salary slip of a calculation. |
| `calculation_copy` | Copy a salary calculation. |
| `calculation_search` | Search salary calculations. |
| `row_type_list` | List custom wage types. |
| `employment_search` | Search employments. |
| `employment_get_summary` | Get an employment summary. |
| `employment_create` | Create an employment. |
| `employment_update` | Update an employment. |
| `employment_set_rows` | Set the default rows of an employment. |
| `invoice_search` | Search invoices. |
| `invoice_get_summary` | Get an invoice summary. |
| `invoice_preview` | Preview the payment of a payroll or a calculation. |
| `invoice_confirm` | Confirm the payment of a payroll or a calculation. |
| `payroll_create` | Create a payroll. |
| `payroll_copy` | Copy a payroll. |
| `payroll_set_employments` | Set the employees of a payroll. |
| `payroll_set_rows` | Set salary rows of employees in a payroll. |
| `payroll_update` | Update a payroll. |
| `payroll_remove_calculation` | Remove a calculation from a payroll. |
| `payroll_get_summary` | Get a payroll summary. |
| `payroll_show_slips` | Show the salary slips of a payroll. |
| `payroll_search` | Search payrolls. |
| `absence_search` | Search the absence periods of all employees, e.g. who is absent in a given month. |
| `absence_get_summary` | Get the absence calendar of one employee: periods with cause, paid or unpaid, and holiday accrual. |
| `absence_set_periods` | Add, change or remove absence periods of an employee: sick leave, annual leave, unpaid leave, lay-off. |
| `holiday_spec_get_summary` | Get the holiday specification of an employee: how holidays accrue and how holiday pay and bonus are calculated. |
| `holiday_spec_update` | Change the holiday specification of an employee, and by default the accruing holiday year with it. |
| `holiday_year_create` | Create the missing holiday years of an employee from the holiday specification. |
| `holiday_year_search` | Search the remaining holiday days and bonus days of the employees over all holiday years. |
| `holiday_year_get_summary` | Get one holiday year: accrual by month, planned leaves, paid holiday salaries, balance and holiday pay. |
| `holiday_year_set_accruals` | Set the holiday days accrued in given months, and the days carried over from the previous year. |
| `holiday_year_set_leaves` | Add, change or remove planned annual leaves and holiday payments made outside Salaxy. |
| `holiday_year_update` | Set manual holiday pay values that override the calculated ones. |
| `holiday_year_recalculate` | Recalculate the holiday pay of a holiday year from the paid salary calculations. |

## Finland — Report Agent, demo

| | |
|---|---|
| Endpoint | `https://demo-reporting.salaxy.com/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth sign-in with a free demo account |
| Status | [Live] |

Try the Report Agent on sample data: salary slips, summary and accounting reports, holiday pay debt and Incomes Register reports.

| Tool | Summary |
|---|---|
| `employer_list` | List the employers the user may act for: their own account and the accounts that have authorised them — e.g. an accounting firm's customers. |
| `employer_select` | Select the employer the other tools work in when no employer id is given — only after the user has chosen; never chosen for the user. |
| `calculation_search` | Search salary calculations. |
| `employment_search` | Search employments. |
| `salary_slip` | Show the salary slips of calculations as rendered documents (widget). |
| `salary_slip_pdf` | Get salary slips as PDF files for saving, archiving or attaching to an email. |
| `summary_report` | Show the summary report of a period or of given calculations as a table (widget). |
| `salary_summary` | Get the salary summary of a period: gross and net salaries, withholding, side costs and total cost. |
| `accounting_report` | Get the accounting report of a period: totals per ledger account with a balance check. |
| `holiday_pay_debt` | Get the holiday pay debt on a date as accounting data. |
| `ir_reports` | List Incomes Register reports by period, status or text, e.g. the rejected reports of a month. |
| `ir_report` | Get an Incomes Register report: status, delivery times, errors and the reported amounts. |

## Finland — Payroll Agent, production

| | |
|---|---|
| Endpoint | `https://payroll.salaxy.com/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth sign-in with your Salaxy account |
| Status | [Live] |

Your own companies' payroll: employments, calculations, payrolls, absences, holidays and invoices. A person always approves a payment.

| Tool | Summary |
|---|---|
| `employer_list` | List the employers the user may act for: their own account and the accounts that have authorised them — e.g. an accounting firm's customers. |
| `employer_select` | Select the employer the other tools work in when no employer id is given — only after the user has chosen; never chosen for the user. |
| `calculation_preview` | Preview a salary calculation. |
| `calculation_create` | Create a salary calculation. |
| `calculation_set_rows` | Set salary rows of a calculation. |
| `calculation_update` | Update a salary calculation. |
| `calculation_get_summary` | Get a calculation summary. |
| `calculation_show_slip` | Show the salary slip of a calculation. |
| `calculation_copy` | Copy a salary calculation. |
| `calculation_search` | Search salary calculations. |
| `row_type_list` | List custom wage types. |
| `employment_search` | Search employments. |
| `employment_get_summary` | Get an employment summary. |
| `employment_create` | Create an employment. |
| `employment_update` | Update an employment. |
| `employment_set_rows` | Set the default rows of an employment. |
| `invoice_search` | Search invoices. |
| `invoice_get_summary` | Get an invoice summary. |
| `invoice_preview` | Preview the payment of a payroll or a calculation. |
| `invoice_confirm` | Confirm the payment of a payroll or a calculation. |
| `payroll_create` | Create a payroll. |
| `payroll_copy` | Copy a payroll. |
| `payroll_set_employments` | Set the employees of a payroll. |
| `payroll_set_rows` | Set salary rows of employees in a payroll. |
| `payroll_update` | Update a payroll. |
| `payroll_remove_calculation` | Remove a calculation from a payroll. |
| `payroll_get_summary` | Get a payroll summary. |
| `payroll_show_slips` | Show the salary slips of a payroll. |
| `payroll_search` | Search payrolls. |
| `absence_search` | Search the absence periods of all employees, e.g. who is absent in a given month. |
| `absence_get_summary` | Get the absence calendar of one employee: periods with cause, paid or unpaid, and holiday accrual. |
| `absence_set_periods` | Add, change or remove absence periods of an employee: sick leave, annual leave, unpaid leave, lay-off. |
| `holiday_spec_get_summary` | Get the holiday specification of an employee: how holidays accrue and how holiday pay and bonus are calculated. |
| `holiday_spec_update` | Change the holiday specification of an employee, and by default the accruing holiday year with it. |
| `holiday_year_create` | Create the missing holiday years of an employee from the holiday specification. |
| `holiday_year_search` | Search the remaining holiday days and bonus days of the employees over all holiday years. |
| `holiday_year_get_summary` | Get one holiday year: accrual by month, planned leaves, paid holiday salaries, balance and holiday pay. |
| `holiday_year_set_accruals` | Set the holiday days accrued in given months, and the days carried over from the previous year. |
| `holiday_year_set_leaves` | Add, change or remove planned annual leaves and holiday payments made outside Salaxy. |
| `holiday_year_update` | Set manual holiday pay values that override the calculated ones. |
| `holiday_year_recalculate` | Recalculate the holiday pay of a holiday year from the paid salary calculations. |

## Finland — Report Agent, production

| | |
|---|---|
| Endpoint | `https://reporting.salaxy.com/mcp` |
| Transport | Streamable HTTP |
| Authentication | OAuth sign-in with your Salaxy account |
| Status | [Live] |

Reports on your own companies' payroll: salary slips, summary and accounting reports, holiday pay debt and Incomes Register reports.

| Tool | Summary |
|---|---|
| `employer_list` | List the employers the user may act for: their own account and the accounts that have authorised them — e.g. an accounting firm's customers. |
| `employer_select` | Select the employer the other tools work in when no employer id is given — only after the user has chosen; never chosen for the user. |
| `calculation_search` | Search salary calculations. |
| `employment_search` | Search employments. |
| `salary_slip` | Show the salary slips of calculations as rendered documents (widget). |
| `salary_slip_pdf` | Get salary slips as PDF files for saving, archiving or attaching to an email. |
| `summary_report` | Show the summary report of a period or of given calculations as a table (widget). |
| `salary_summary` | Get the salary summary of a period: gross and net salaries, withholding, side costs and total cost. |
| `accounting_report` | Get the accounting report of a period: totals per ledger account with a balance check. |
| `holiday_pay_debt` | Get the holiday pay debt on a date as accounting data. |
| `ir_reports` | List Incomes Register reports by period, status or text, e.g. the rejected reports of a month. |
| `ir_report` | Get an Incomes Register report: status, delivery times, errors and the reported amounts. |

## Finland — Configuration Agent

| | |
|---|---|
| Endpoint | _published when the endpoint opens_ |
| Transport | Streamable HTTP |
| Authentication | _published when it opens_ |
| Status | [Coming soon] |

Payroll settings: wage types, templates, holiday and pay rules, cost-centre dimensions and reporting settings. Demo and production endpoints are published when it opens.

## Finland — Data Agent (import)

| | |
|---|---|
| Endpoint | _published when the endpoint opens_ |
| Transport | Streamable HTTP |
| Authentication | _published when it opens_ |
| Status | [Coming soon] |

Bring payroll data in from other systems: import plans, source datasets, transformations and import runs. Demo and production endpoints are published when it opens.

## Sweden

| | |
|---|---|
| Endpoint | _published when the endpoint opens_ |
| Transport | Streamable HTTP |
| Authentication | _published when it opens_ |
| Status | [Coming soon] |

Separate endpoints for Swedish payroll. Published at launch.

## Areas without a tool yet

These skill areas are written, and their tools are being built. On a server without the tool an agent using the skills **says it cannot do that here**, names what should happen instead, and does not substitute another tool. It does not claim the action is impossible: the limit may be the environment's, not Salaxy's.

- [Company settings](https://code.salaxy.com/reference/skills.md#settings) — The tools come with the Configuration Agent server.
