--- title: "JobsPipe Developer Resources: API Docs, OpenAPI, MCP Server" description: "Every JobsPipe developer resource in one place: API docs, OpenAPI spec, authentication, webhooks, MCP server, CLI, and machine-readable agent indexes." canonical: https://jobspipe.dev/developers --- # JobsPipe developer resources Every JobsPipe developer resource in one place, each at a predictable URL: the JobsPipe API documentation, OpenAPI specification, authentication and agent-auth guide, webhooks, MCP server, CLI, and the machine-readable indexes agents use to discover JobsPipe. Get a free API key at [https://jobspipe.dev/signup](https://jobspipe.dev/signup). ![The JobsPipe dashboard listing open data engineer postings in the United States, with company, posted date, job title, function, seniority and skills columns](https://jobspipe.dev/app/job-search-live.png) ## How it works ![The JobsPipe dashboard listing open data engineer postings in the United States, with company, posted date, job title, function, seniority and skills columns](https://jobspipe.dev/app/job-search-live.png) 1. 01Every open role from 30+ sources, in one search Search by title, skill, company, place, salary, seniority or remote. Postings from job boards and ATS platforms come back in one schema, deduplicated across sources. [Get free API key](https://jobspipe.dev/signup?ref=steps) 2. 02The same search is one API call POST /v1/jobs/search returns the postings as JSON. Try it in the sandbox without a key, then count credits per job returned. [Read the docs](https://docs.jobspipe.dev) 3. 03Turn a search into a signal Save it as a Signal and new matches arrive by email, Slack or webhook, each one once. Signals cost no credits. [Set up a signal](https://jobspipe.dev/signup?ref=steps-signal) 4. 04Ask from your AI agent Connect the hosted MCP server and Claude, Codex or any MCP client searches live postings and cites each one. [Connect your agent](https://jobspipe.dev/mcp-server) ## Why teams build on JobsPipe ![](https://jobspipe.dev/icon.png) > Every team I spoke to that wanted to build with job data ended up building scrapers instead. So I decided we would do that work once. [Read why we built it](https://jobspipe.dev/about) ![Dvir Atias, founder of JobsPipe](https://jobspipe.dev/authors/dvir-atias.jpg) Dvir AtiasFounder, JobsPipe Job boards and ATS platforms in one schema 30+ ![](https://jobspipe.dev/favicons/greenhouse.png)![](https://jobspipe.dev/favicons/lever.png)![](https://jobspipe.dev/favicons/workday.png)![](https://jobspipe.dev/favicons/linkedin.png)![](https://jobspipe.dev/favicons/indeed.png)![](https://jobspipe.dev/favicons/ashby.png) Of posting history 12 mo On every plan Free credits to start, no card 1,000 Credits charged for a signal 0 Ways in: API, MCP server and dashboard 3 ## JobsPipe API documentation The full JobsPipe API reference: quickstart, authentication, the job-search and tech-stack-scan endpoints, the normalized job schema, filters, pagination, rate limits and error codes. [Docs](https://docs.jobspipe.dev)[Quickstart](https://docs.jobspipe.dev/quickstart) ## JobsPipe OpenAPI specification The machine-readable OpenAPI 3.1 description of the JobsPipe API, for code generation and agent tool discovery. Available as JSON and YAML at predictable URLs. [OpenAPI spec overview](https://jobspipe.dev/openapi)[openapi.json](https://jobspipe.dev/openapi.json)[openapi.yaml](https://jobspipe.dev/openapi.yaml) ## JobsPipe authentication & agent auth How agents authenticate to the JobsPipe API with a Bearer API key (prefix jp\_live\_), plus the agent-auth discovery chain: protected-resource metadata (RFC 9728), authorization-server metadata (RFC 8414) and JWKS. [auth.md](https://jobspipe.dev/auth.md)[Protected-resource metadata](https://api.jobspipe.dev/.well-known/oauth-protected-resource)[Authorization-server metadata](https://api.jobspipe.dev/.well-known/oauth-authorization-server) ## JobsPipe API permissions & scopes JobsPipe API keys carry granular, read-only permissions expressed as OAuth-style scopes: jobs:read grants POST /v1/jobs/search (job-posting search), stack:read grants POST /v1/stack/scan (technology-stack scans). No scope grants write access to JobsPipe data. The same scopes are advertised in the OpenAPI securitySchemes and in the RFC 9728 protected-resource metadata. [OpenAPI securitySchemes](https://jobspipe.dev/openapi.json)[Scopes metadata (RFC 9728)](https://api.jobspipe.dev/.well-known/oauth-protected-resource) ## JobsPipe API versioning & deprecation policy The JobsPipe API is versioned in the URL path (/v1). Breaking changes only ship under a new version path. An endpoint is deprecated with at least 6 months notice: it starts returning Deprecation (RFC 9745) and Sunset (RFC 8594) response headers with the retirement date, and the deprecation is announced in the changelog. Until its Sunset date a deprecated endpoint keeps working unchanged. [Changelog](https://jobspipe.dev/changelog)[OpenAPI spec](https://jobspipe.dev/openapi.json) ## JobsPipe API sandbox / test environment A free public sandbox under /v1/sandbox: no API key, no quota. Canned sample data shaped exactly like the live endpoints, including batch search and an async 202-plus-poll export, so agents can exercise the JobsPipe API safely before signing up. [Sandbox guide](https://jobspipe.dev/sandbox) ## JobsPipe webhooks Subscribe to JobsPipe job events. Payloads are signed with an HMAC-SHA256 X-JobsPipe-Signature header so consumers can verify authenticity; the webhook contract is documented in the OpenAPI spec. [Webhooks docs](https://docs.jobspipe.dev/api-reference/webhooks)[OpenAPI spec](https://jobspipe.dev/openapi.json) ## JobsPipe MCP server The JobsPipe Model Context Protocol server lets AI agents call JobsPipe as native tools (search jobs, list sources and pricing, scan a tech stack) over Streamable HTTP. A docs MCP surface exposes the documentation over the same protocol. Published in the official MCP registry under the domain-verified name dev.jobspipe/mcp and listed on the Smithery marketplace as jobspipe/jobspipe-mcp. [MCP server overview](https://jobspipe.dev/mcp-server)[MCP server](https://jobspipe.dev/mcp)[MCP server card](https://jobspipe.dev/.well-known/mcp/server-card.json)[Docs MCP](https://docs.jobspipe.dev/mcp)[MCP registry entry (dev.jobspipe/mcp)](https://registry.modelcontextprotocol.io/v0/servers?search=dev.jobspipe/mcp)[Smithery listing (jobspipe/jobspipe-mcp)](https://smithery.ai/servers/jobspipe/jobspipe-mcp)[Server source](https://github.com/jobspipe/mcp) ## JobsPipe CLI & agent skills The open-source JobsPipe command-line interface and official agent skills. Install the skill collection for AI coding agents with npx skills add jobspipe/skills (job search, stack scan, MCP setup, webhooks, agent discovery), the single-skill CLI companion with npx skills add jobspipe/jobspipe-cli, or the standalone CLI from npm. [Skills on skills.sh](https://skills.sh/jobspipe/skills)[Skills source](https://github.com/jobspipe/skills)[CLI GitHub](https://github.com/jobspipe/jobspipe-cli)[npm](https://www.npmjs.com/package/jobspipe-cli)[Go SDK](https://pkg.go.dev/github.com/jobspipe/jobspipe-go)[Python SDK](https://pypi.org/project/jobspipe/) ## JobsPipe for AI agents The agent-focused guide to JobsPipe: skill and CLI setup, the MCP server, and the REST API, with copy-pasteable commands. [Agent guide](https://jobspipe.dev/agent) ## JobsPipe machine-readable indexes Indexes built for agents and crawlers: the site llms.txt, a scoped API/agent index, a scoped docs index, the RFC 9727 API catalog, the A2A agent card, and the agent-skills index - all at predictable URLs. [llms.txt](https://jobspipe.dev/llms.txt)[api/llms.txt](https://jobspipe.dev/api/llms.txt)[docs/llms.txt](https://docs.jobspipe.dev/llms.txt)[API catalog](https://jobspipe.dev/.well-known/api-catalog)[Agent card](https://jobspipe.dev/.well-known/agent-card.json) ## Further reading - [Where to find API key?](https://jobspipe.dev/answers/where-to-find-your-api-key) --- Try it with no key: `curl -d '{"limit":3}' https://api.jobspipe.dev/v1/sandbox/jobs/search`. AI agents: the full machine-readable index of this site is https://jobspipe.dev/llms.txt?src=md-twin - API quickstart, MCP server, pricing. Free key (1,000 jobs to start): https://jobspipe.dev/signup