Dynamite Jobs Official Client

The official Python client for the Dynamite Jobs Company API — post remote jobs, manage applications end-to-end, score and triage candidates, pull funnel and source analytics, check billing, and run trial posts.

A single self-contained file. Zero runtime dependencies (stdlib only). Works as a CLI, a Python library, and a Model Context Protocol server. Compatible with Claude Code, Claude Desktop, Codex CLI, Gemini CLI, Cursor, GitHub Copilot, and every other Agent Skills / MCP-compatible tool.

py/dj.py    ← one file, four integration modes

About Dynamite Jobs

Dynamite Jobs is the remote-first job board for companies that hire from anywhere — running since 2017 and grown out of the Dynamite Circle founder community. Every employer on the board has been vetted as offering true work-from-anywhere roles: flexible hours, async-friendly cultures, results-based management. "Work from home" is not the same as "work from anywhere."

• For employers — post a remote job on the board, manage applicants in the built-in ATS, repromote stalled listings, and pull analytics on where your best candidates are coming from. Need the hiring done for you? Our sister agency Remote First Recruiting runs the full search.
• For job seekers — browse vetted remote jobs, set up job alerts, and apply with a free candidate profile.
• For developers and AI agents — this client. Read your company's data, post jobs, score and respond to applicants programmatically, and wire DJ into Claude / Codex / Cursor as a first-class MCP server.

Install

pip install dynamitejobs

3-command quickstart

pip install dynamitejobs
python3 -m dynamitejobs setup --api-key dj_<companyID>_<random>
python3 -m dynamitejobs self-test

Get your API key from the DJ dashboard: Settings → API Access → Create new key.

CLI

# Reads
dj company                            # your company profile
dj jobs --status=published            # list your published jobs
dj applications <jobID>               # applications to one job
dj analytics-funnel --from=2026-04-01 --to=2026-05-01
dj billing                            # card on file, plan tier, recent charges
dj limits                             # rate limit caps + usage

# Writes
dj post-job '{"title": "Senior Backend Engineer", "description": "..."}'
dj publish-job <jobID>                # charges card on file
dj update-application <appID> --job-id=<jid> --status=goodFit --rating=4
dj trial-post '{"title": "..."}'      # 1 per company, awaits admin approval

Python library

from dynamitejobs import DJ

dj = DJ()  # reads ~/.env.dj
print(dj.company())

for j in dj.jobs(status="published")["jobs"]:
    print(j["id"], j.get("title"))

# Walk applications for one job and mark good fits
apps = dj.applications("job_abc123")
for a in apps["applications"]:
    if a.get("score", 0) > 0.8:
        dj.update_application(a["id"], job_id="job_abc123", status="goodFit", rating=4)

MCP server (Claude / Codex / Cursor / Gemini)

pip install "dynamitejobs[mcp]"
python3 -m dynamitejobs --mcp

Claude Code

Add to your project's .mcp.json:

{
  "mcpServers": {
    "dj": {
      "command": "python3",
      "args": ["-m", "dynamitejobs", "--mcp"],
      "env": { "DJ_API_KEY": "dj_..." }
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json — same shape as above.

Codex CLI

Symlink py/SKILL.md into ~/.codex/skills/dj/SKILL.md — Codex auto-discovers it.

Cursor

Settings → MCP → Add server. Command: python3, args: -m dynamitejobs --mcp.

GitHub Copilot

Add a paragraph to your repo's .github/copilot-instructions.md:

When asked about Dynamite Jobs data, call the dj CLI via shell. Setup once with python3 -m dynamitejobs setup --api-key ....

Gemini CLI

Add to ~/.gemini/settings.json under mcpServers.

Rate limits

Every response carries X-RateLimit-* headers. Use dj limits to inspect.

Output formats

CLI output is JSON by default (pipe to jq):

dj jobs --status=published | jq '.jobs[].title'

Add --format=raw if you want the body printed without JSON encoding (only useful for endpoints that return non-JSON, like /openapi.json proxy).

Errors

Every error response has error (slug) and message (human). Library raises DJError with status, body, and url.

from dynamitejobs import DJ, DJError
try:
    DJ().publish_job("job_xyz")
except DJError as e:
    if e.status == 402 and e.body.get("error") == "no_stripe_customer":
        print("Add a card on file in the dashboard first.")

Versioning

The client prints a stderr warning when the server is on a newer major/minor version. Upgrade with pip install --upgrade dynamitejobs.

License

MIT.