--- 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 --- [NewSearch millions of jobs from your AI agent with MCP→](/blog/jobspipe-mcp-server) 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](/signup). ## 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) --- Canonical URL: https://jobspipe.dev/developers --- AI agents: the full machine-readable index of this site is https://jobspipe.dev/llms.txt?src=md-twin - API quickstart, no-key sandbox (POST https://api.jobspipe.dev/v1/sandbox/jobs/search), MCP server, pricing. Free key: https://jobspipe.dev/signup