[NewSearch millions of jobs from your AI agent with MCP→](/blog/jobspipe-mcp-server)

[All posts](/blog)

Reference·Jul 18, 2026·6 min read

# 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.

![Dvir Atias](/authors/dvir-atias.jpg)

Dvir Atias

Founder, JobsPipe

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](/developers) links every resource by name, the API docs live at [docs.jobspipe.dev](https://docs.jobspipe.dev), the OpenAPI spec is at [/openapi](/openapi), and the hosted MCP server is documented at [/mcp-server](/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](/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](/openapi.json) and [YAML](/openapi.yaml), with an overview page at [/openapi](/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](/signup) with monthly credits included. The full auth reference - including the agent-auth discovery chain with protected-resource metadata, authorization-server metadata and JWKS - is at [/auth.md](/auth.md).

## JobsPipe MCP server

AI agents can skip the REST layer entirely: the hosted [JobsPipe MCP server](/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](/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](/llms.txt) lists every resource on this page in one file.

Every resource above works with the free tier - API key in 30 seconds.

## 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.

[

← Previous

Job scraper: the build-vs-buy guide for 2026

](/blog/job-scraper-build-vs-buy)[

Next →

Search millions of jobs from your AI agent with the JobsPipe MCP server

](/blog/jobspipe-mcp-server)

---
Canonical URL: https://jobspipe.dev/blog/jobspipe-developer-portal
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 the CLI.