Agent Careerats-sdk
Adapters

Personio

Fetch public career listings from Personio ATS.

Personio is one of Europe's leading HR and applicant tracking systems, powering hiring for tens of thousands of companies across the EU, UK, and worldwide.

Usage

Direct Adapter Import

personio.ts
import { personio } from "ats-sdk/personio";

const adapter = personio({ boardToken: "clark" });
const { jobs, total } = await adapter.getJobs({
  workplace: "remote",
});

Auto-Discovery via Unified Client

client.ts
import { createAtsClient } from "ats-sdk";

const ats = createAtsClient({
  companies: ["https://clark.jobs.personio.de/"],
});

const { jobs, total } = await ats.getJobs();

Agent Usage

If you're using the ats-sdk with an AI agent framework (like Cursor, Claude, or Vercel AI SDK), Personio is natively supported in the fetch_company_jobs tool via our bundled MCP server:

bunx --cwd apps/mcp xmcp dev

Your AI can then automatically query: { boardToken: "your_token", provider: "personio" }.

Application Form Extraction

Extract standardized candidate fields and direct application URL:

form.ts
import { personio } from "ats-sdk/personio";

const adapter = personio({ boardToken: "clark" });
const form = await adapter.getForm("12345");

console.log(form.submitPath);
console.log(`Fields: ${form.fields.map((f) => f.label).join(", ")}`);

How to find the Board Token

Personio career boards are hosted at https://<company-slug>.jobs.personio.de/ (or .com). The subdomain prefix <company-slug> is the board token.

On this page