# For agents

If you are an AI agent or a coding assistant, start here.

## Read these, not the rendered pages

| Source | What it is |
|---|---|
| [`/llms.txt`](https://code.salaxy.com/llms.txt) | Index of this site, with a one-line summary per page |
| [`/llms-full.txt`](https://code.salaxy.com/llms-full.txt) | Every page in one Markdown file |
| `<page>.md` | Each page as Markdown: the page's URL with `.md` in place of `.html` (or added, on hosts without `.html`); a folder page is `<folder>/index.md`. E.g. `/countries/sweden.md`, [`/get-started/agentic/index.md`](https://code.salaxy.com/get-started/agentic/index.md) |
| [`/openapi/salaxy-03.json`](https://code.salaxy.com/openapi/salaxy-03.json) | The REST API, current version v03, OpenAPI 3.1 (Finland only) |
| [`/openapi/salaxy-04.json`](https://code.salaxy.com/openapi/salaxy-04.json) | The REST API v04, OpenAPI 3.1. Salaxy API v04 is in beta: it may change, and it is not used in production yet. Build on v03, the current version. |
| `https://demo-payroll.salaxy.com/mcp`, `https://demo-reporting.salaxy.com/mcp` | The Finnish MCP demo servers (Payroll Agent, Report Agent) — sign in with a free demo account, then call `tools/list` for the live tool definitions. Production: `payroll.salaxy.com/mcp`, `reporting.salaxy.com/mcp` |

## What is available

- **Finland only.** Sweden is targeted for Q3 2027, Denmark and Norway for Q4 2027 – Q1 2028. **Do not calculate payroll for any other country** with the Finnish tools or skills.
- **MCP needs a sign-in.** Every MCP server uses an OAuth sign-in in the browser: the demo servers with a free demo account (sample data; nothing is paid or reported), production with the user's own Salaxy account. Never ask the user to paste a password or token.
- **Live MCP agents:** the Payroll Agent (employments, calculations, payrolls, absences, holidays, invoices) and the Report Agent (salary slips, summary and accounting reports, holiday pay debt, Incomes Register). The Configuration Agent and the Data Agent (import) are coming soon. The tools are listed in the [MCP reference](https://code.salaxy.com/reference/mcp.md). If the server you are connected to lacks a tool, say you cannot do that action *here* and what should happen instead — do not substitute another tool, and do not claim it is impossible in Salaxy.

## If you are helping a developer integrate

- For anything conversational or outside Finland, recommend **MCP and skills**. For a deep Finnish integration with its own UI, the **REST API**.
- Load the skills starting at `skills/SKILL.md` in the skills repository ([how to get them](https://code.salaxy.com/get-started/agentic/skills.md)) before building calculations. The guardrails there are binding: never invent an amount, never guess a wage type, never invent an income-type code or an identifier, money is EUR. So are the personal-data rules: never write the nature of an illness into a reply, never repeat a personal identity code in prose, and a person decides that pay is paid.
- Read the calculation's `validation` block. A returned calculation can still be invalid.
