Dynamite Jobs — Company API v1.2.8

Programmatic access for Dynamite Jobs customer companies. Manage jobs, applications, candidates, billing, and analytics from scripts, SDKs, or AI agents.

Connect to Claude & other AI apps (hosted MCP)

This API is also a hosted MCP server — add it as a connector in Claude, ChatGPT, Cursor, or any MCP-compatible app and your assistant can read and act on your Dynamite Jobs company data directly: jobs, applications, candidates, analytics, and billing. No install. When prompted, sign in with your DJ account (one-click OAuth) — or paste a dj_ API key. Every endpoint below is exposed as a tool.

Connector URL (Streamable HTTP):

https://api.dynamitejobs.com/mcp

Claude Code

claude mcp add --transport http dj https://api.dynamitejobs.com/mcp

Cursor, ChatGPT & other MCP apps

Add a custom / remote MCP connector pointing at the URL above (Streamable HTTP). The app runs the same OAuth sign-in. Machine-readable discovery is published at /.well-known/mcp.json.

Prefer a local process? Run the official client as an MCP server: pipx run dj --mcp (pip install dynamitejobs).

Authentication

Every endpoint takes Authorization: Bearer dj_<apikey>. Issue keys from your DJ dashboard under Settings → API Access (owner/admin role required).

Quick start

pip install dynamitejobs
python3 -m dynamitejobs setup --api-key dj_<apikey>
python3 -m dynamitejobs self-test

Rate limits

Tier-based. Every response carries X-RateLimit-* headers. Hit GET /limits for your effective caps + current usage.

Analytics

• GET /analytics/funnelCompany-wide funnel — views → clicks → applies → reviewed → goodFit/interested/declined
• GET /analytics/jobsPer-job metrics — views, clicks, applies, per-status application counts

Applications

• GET /applications/{applicationID}Read a single application + answers
• PATCH /applications/{applicationID}Update status or internal candidate notes
• GET /jobs/{jobID}/applicationsList applications for one job
• POST /jobs/{jobID}/applications/exportEmail a CSV export of job applications

Billing

• GET /billing/statusCard-on-file status, plan tier, recent API charges

Candidates

• GET /candidate/{uid}Read candidate profile (only if they applied to one of your jobs)

Company

• GET /companyRead own company profile
• PATCH /companyUpdate permitted company fields

Jobs

• GET /jobsList your company's jobs
• POST /jobsCreate an unpublished job
• POST /jobs/trialCreate + submit a trial post (free, 1 per company)
• GET /jobs/{jobID}Read a single job
• PATCH /jobs/{jobID}Edit a draft or restricted published-job fields
• DELETE /jobs/{jobID}Delete a draft job

Limits

• GET /limitsEffective rate limits + current usage