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
import { personio } from "ats-sdk/personio";
const adapter = personio({ boardToken: "clark" });
const { jobs, total } = await adapter.getJobs({
workplace: "remote",
});Auto-Discovery via Unified Client
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 devYour AI can then automatically query: { boardToken: "your_token", provider: "personio" }.
Application Form Extraction
Extract standardized candidate fields and direct application URL:
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.