--- title: "The JobsPipe developer portal: API docs, OpenAPI spec, MCP server and SDKs" description: "Every JobsPipe developer resource in one guided tour - the API docs, the OpenAPI 3.1 spec, authentication, webhooks, the hosted MCP server, the no-key sandbox, and official SDKs for Go, Python and" canonical: https://jobspipe.dev/blog/jobspipe-developer-portal date_published: 2026-07-18 date_modified: 2026-09-26 author: Dvir Atias --- # The JobsPipe developer portal: API docs, OpenAPI spec, MCP server and SDKs Every JobsPipe developer resource in one guided tour - the API docs, the OpenAPI 3.1 spec, authentication, webhooks, the hosted MCP server, the no-key sandbox, and official SDKs for Go, Python and the CLI. Everything a developer or an AI agent needs to build on JobsPipe lives at a predictable URL, and this post is the guided tour. The short version: the [JobsPipe developer portal](https://jobspipe.dev/developers) links every resource by name, the API docs live at [docs.jobspipe.dev](https://docs.jobspipe.dev), the OpenAPI spec is at [/openapi](https://jobspipe.dev/openapi), and the hosted MCP server is documented at [/mcp-server](https://jobspipe.dev/mcp-server). The rest of this post walks each one, with the fastest path from zero to a live request. ## The JobsPipe developer portal [jobspipe.dev/developers](https://jobspipe.dev/developers) is the hub: one page linking every developer resource by name - API docs, OpenAPI spec, authentication, webhooks, MCP server, CLI, SDKs, sandbox, and the machine-readable indexes agents use to discover JobsPipe. If you only bookmark one URL, make it this one. ## JobsPipe API docs The full API documentation lives at [docs.jobspipe.dev](https://docs.jobspipe.dev): quickstart, authentication, the job-search and stack-scan endpoints, filter reference, job schema, pagination, errors, and webhooks. The fastest first request is the quickstart - a free key and one curl: ``` curl -X POST https://api.jobspipe.dev/v1/jobs/search \ -H "Authorization: Bearer jp_live_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"job_title_or":["software engineer"],"remote":true,"limit":5}' ``` ## JobsPipe OpenAPI specification The machine-readable OpenAPI 3.1 description of the whole API ships as [JSON](https://jobspipe.dev/openapi.json) and [YAML](https://jobspipe.dev/openapi.yaml), with an overview page at [/openapi](https://jobspipe.dev/openapi) covering what the spec includes: both public endpoints, the sandbox routes, the webhook contract, and the auth schemes. Point a code generator or an agent tool loader at `jobspipe.dev/openapi.json` and you get typed clients for free. ## Authentication and agent auth Every request authenticates with a Bearer API key (prefix `jp_live_`), free at [/signup](https://jobspipe.dev/signup) with 1,000 free credits to start. The full auth reference - including the agent-auth discovery chain with protected-resource metadata, authorization-server metadata and JWKS - is at [/auth.md](https://jobspipe.dev/auth.md). ## JobsPipe MCP server AI agents can skip the REST layer entirely: the hosted [JobsPipe MCP server](https://jobspipe.dev/mcp-server) exposes job search, source and pricing lookups as native tools over streamable HTTP at `jobspipe.dev/mcp`. One command connects Claude Code: ``` claude mcp add --transport http jobspipe https://jobspipe.dev/mcp ``` It is published in the official MCP registry as `dev.jobspipe/mcp` and listed on Smithery as `jobspipe/jobspipe-mcp`. Agent skills install with `npx skills add jobspipe/skills`. ## Webhooks Paid plans can subscribe to job events instead of polling. Payloads are signed with an HMAC-SHA256 `X-JobsPipe-Signature` header so consumers can verify authenticity; the contract is documented in the OpenAPI spec and the [docs](https://docs.jobspipe.dev). ## SDKs and the sandbox Official SDKs cover Go (`go get github.com/jobspipe/jobspipe-go`), Python (`pip install jobspipe`) and the CLI (`npm i -g jobspipe-cli`). Before you sign up for anything, the [sandbox](https://jobspipe.dev/sandbox) serves sample responses in the exact live schema under `/v1/sandbox` - no key, no quota. And for agents that read machine-readable indexes first, [llms.txt](https://jobspipe.dev/llms.txt) lists every resource on this page in one file. ## Frequently Asked Questions ### What is the JobsPipe developer portal? The JobsPipe developer portal at jobspipe.dev/developers is the hub that links every developer resource by name. That covers the API docs, the OpenAPI spec, authentication, webhooks, the MCP server, the CLI, the SDKs, the sandbox, and the machine-readable indexes agents use to discover JobsPipe. If you only bookmark one JobsPipe URL, make it this one. ### Where is the JobsPipe OpenAPI spec? The machine-readable OpenAPI 3.1 spec ships as JSON at jobspipe.dev/openapi.json and as YAML at jobspipe.dev/openapi.yaml, with an overview page at /openapi. It describes both public endpoints, the sandbox routes, the webhook contract, and the auth schemes. Point a code generator or an agent tool loader at jobspipe.dev/openapi.json and you get typed clients for free. ### Does JobsPipe have official SDKs? Yes. Official SDKs cover Go with go get github.com/jobspipe/jobspipe-go, Python with pip install jobspipe, and a CLI with npm i -g jobspipe-cli. Agents can skip REST entirely via the hosted MCP server, published in the official MCP registry as dev.jobspipe/mcp and listed on Smithery as jobspipe/jobspipe-mcp. Before signing up for anything, the sandbox serves sample responses in the exact live schema under /v1/sandbox with no key and no quota. Related ## Keep reading - [Comparison · Aug 6, 2026LoopCV's developer API vs JobsPipe: same pitch, different product](https://jobspipe.dev/blog/loopcv-jobs-api) - [Guide · Jul 22, 2026How to build an MCP server: a step-by-step guide with a real API](https://jobspipe.dev/blog/how-to-build-an-mcp-server) - [Product · Jun 24, 2026Search millions of jobs from your AI agent with the JobsPipe MCP server](https://jobspipe.dev/blog/jobspipe-mcp-server) - [Reference · Sep 9, 2026What is an MCP server? How MCP works, with a real example](https://jobspipe.dev/blog/what-is-an-mcp-server) - [Comparison · Aug 6, 2026JobDataLake vs JobsPipe: two MCP-era jobs APIs compared](https://jobspipe.dev/blog/jobdatalake-alternative) ## Further reading - [Why Do You Need an MCP Server?](https://jobspipe.dev/blog/why-do-you-need-an-mcp-server) - [Jobs API in Python: pip install to live postings in 5 minutes](https://jobspipe.dev/blog/python-jobs-api) - [Job search API: how to add job search to your product](https://jobspipe.dev/blog/job-search-api-guide) - [What is an MCP server? How MCP works, with a real example](https://jobspipe.dev/blog/what-is-an-mcp-server) --- 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