AI Agent Tools (MCP)
Equip your LLM agents with function-calling tools to query live career data using the Model Context Protocol.
ATS SDK includes first-class support for AI agents through the Model Context Protocol (MCP). Instead of binding framework-specific tools into your app code, the workspace includes a dedicated apps/mcp server that exposes the SDK's capabilities to any AI agent (Claude, Cursor, Executor, Vercel AI SDK, LangChain, etc.).
Starting the MCP Server
The server is built using the xmcp framework. You can start it locally:
bunx --cwd apps/mcp xmcp devIf you are using an MCP configuration file (e.g. for Claude Desktop or Cursor), add the following entry:
{
"mcpServers": {
"ats": {
"command": "bunx",
"args": ["--cwd", "apps/mcp", "xmcp", "dev"]
}
}
}Available Tool Definitions
The MCP server automatically exposes four strongly-typed tools to the connected agent:
1. fetch_company_jobs
Fetch active job postings from any company (with automatic ATS detection):
- Parameters:
boardToken(string, required): The ATS board token, identifier, or company slug.provider(string, required): The ATS provider platform.limit(number, optional): Maximum jobs to return (default: 50, max: 100).workplace(string, optional): Filter by"remote","hybrid", or"onsite".query(string, optional): Keyword search in title, location, or department.
2. search_companies_jobs
Search across an array of companies simultaneously:
- Parameters:
companies(array of strings, required): List of company names, slugs, or URLs (e.g.['stripe', 'vercel']).query(string, optional): Keyword query.workplace(string, optional): Workplace filter.limit(number, optional): Maximum aggregated jobs.
3. discover_company_ats
Detect which ATS a company uses and its board identifier:
- Parameters:
query(string, required): Company name, slug, or career URL.
- Returns:
{ provider, boardToken, confidence, matchedVia }
4. test_ats_board
Run health checks and latency probes on a company's career board:
- Parameters:
boardToken(string, required): Target company board token.provider(string, required): The ATS provider platform.
- Returns: Status code, latency, and sample normalized posting.