ats_new_postings
Pack: ats-boards · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/ats_new_postings for the schema, then POST the same URL with its arguments for the data.
Diff a board’s current postings against the last time this tool was called for the same ats+board_token (snapshot kept in KV, dated). The FIRST call for a board has no prior snapshot, so it returns every current job as new (snapshot_bootstrap:true) rather than a misleading empty diff. Pass “since” (ISO date) to also require posted_at >= since where the ATS reports a date.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
ats | string | yes | Which ATS the board is on. |
board_token | string | yes | Same board_token shape as ats_jobs. |
since | string | no | Optional ISO-8601 date/time; only postings with posted_at on or after this (where the ATS reports a date) count as new. |
Example call
Arguments
{
"ats": "lever",
"board_token": "spotify"
}
curl
curl -X POST https://gateway.pipeworx.io/ats-boards/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ats_new_postings","arguments":{"ats":"lever","board_token":"spotify"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('ats_new_postings', {
"ats": "lever",
"board_token": "spotify"
});
Connect
Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:
{
"mcpServers": {
"pipeworx": {
"url": "https://pipeworx.io/mcp"
}
}
}
Connect to just the ats-boards pack
{
"mcpServers": {
"ats-boards": {
"url": "https://gateway.pipeworx.io/ats-boards/mcp"
}
}
}
See Getting Started for client-specific install steps.