Agent Careerats-sdk

Quickstart

Get started with ATS SDK in your TypeScript project in under 2 minutes.

Install the SDK via your package manager of choice:

npm install ats-sdk

Basic Query

Initialize the client with company names or URLs. ATS SDK automatically detects the underlying ATS provider:

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

const ats = createAtsClient({
  companies: ["stripe", "openai", "palantir"],
});

// Fetch normalized jobs across all sources
const { jobs, total } = await ats.getJobs({
  workplace: "remote",
  limit: 10,
});

console.log(`Fetched ${total} jobs:`);
for (const job of jobs) {
  console.log(`${job.title} — ${job.company} (${job.location})`);
}

Direct Adapter Usage

If you prefer targeted adapter instances with explicit board tokens, import provider adapters directly:

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

const adapter = greenhouse({ boardToken: "stripe" });
const { jobs, total, company } = await adapter.getJobs({
  workplace: "remote",
  limit: 10,
});

console.log(`Found ${total} remote roles at ${company}`);

Health Checks with doctor()

Run diagnostics on board connectivity and endpoint latency:

health.ts
const healthChecks = await ats.doctor();

for (const check of healthChecks) {
  console.log(
    `[${check.provider}] ${check.boardToken}: ${check.ok ? "✓ OK" : "✗ FAILED"} (${check.durationMs}ms)`
  );
}

AI Agent Integration

ATS SDK exposes its capabilities to AI agents via the Model Context Protocol (MCP). To allow Cursor, Claude Desktop, or your custom agents to fetch and search jobs, simply run the bundled MCP server:

bunx --cwd apps/mcp xmcp dev

The MCP server will automatically expose tools like fetch_company_jobs, search_companies_jobs, and discover_company_ats directly to your AI.

On this page