dreamwork_
Back to Agents overview

Start

Agent docs

Set up Dreamwork in Claude Code, Cursor or Claude and apply to jobs from your own agent.

Vision

Dreamwork is the job-search intelligence layer

Dreamwork is not just a job search endpoint. It gives connected agents the candidate-scoped context and workflow surface to find roles, rank opportunities, prepare applications, track outcomes, and improve future decisions over time.

System of record

Profile, listings, pipeline

Durable facts about the candidate, market, and application state.

System of intelligence

Recommendations and actions

Reasoning over context to decide what should happen next.

MCP package

@dreamworkhq/mcp

Gives agents the same candidate-scoped workflow contracts as the web app.

API keys are candidate-scoped. Reads, packs, and agent calls count against the person's plan limits.

Current surface

What agents can do

Agents can search live listings, read recommendations, update profile preferences, add jobs, generate tailored packs, submit applications, and route uncertain cases back to the candidate.

Discovery

Read platform listings, personalized recommendations, and hidden-listing state. Public listing detail is available without a candidate key; personalized routes use candidate context.

  • GET
    /listings

    Paginated live listings with company, function, seniority, and remote filters.

    Stable
  • GET
    /listings/:id

    Full detail for one listing: description, salary, company, source metadata, and apply URL.

    Stable
  • GET
    /listings/recommended

    Personalized matches ranked against the candidate's profile and preferences.

    Beta
  • POST
    /listings/:id/dismiss

    Hide a listing from future recommendations for the authenticated candidate.

    Stabilizing
  • DELETE
    /listings/:id/dismiss

    Restore a hidden listing so it can return to the candidate's recommendations.

    Stabilizing
  • GET
    /listings/dismissed

    Page through listings the candidate has hidden, newest first, with title, company and whether each is still active.

    Stabilizing

Profiles

Candidate context for every agent action: identity, resume status, preferences, assets, and analysis.

  • GET
    /profile

    Return profile, resume status, readiness flags, and plan information.

    Stable
  • PUT
    /profile

    Patch candidate profile fields from structured agent input.

    Stable
  • POST
    /profile/preferences/natural-language

    Turn plain-English preferences into structured search constraints.

    Beta
  • GET
    /profile/analysis

    Resume analysis output: skills, seniority, salary range, and fit signals.

    Beta
  • POST
    /profile/resume/reprocess

    Re-run resume parsing and profile analysis for the candidate.

    Stabilizing

Pipeline

The candidate's working set of roles across web, HTTP, and MCP clients. Updates are user-scoped and durable.

  • GET
    /pipeline

    Kanban-shaped response: added, in review, pack-ready, sent, and closed.

    Stable
  • PATCH
    /pipeline/:jobId/status

    Move one added job between pipeline stages.

    Stabilizing
  • GET
    /jobs

    List added jobs with optional status, listingId and limit filters.

    Stable
  • POST
    /listings/:id/add

    Add a platform listing to the candidate's pipeline.

    Stable
  • POST
    /jobs

    Manually add a job that did not come from the platform listing index.

    Stabilizing
  • GET
    /jobs/:id/details

    Fetch an added job with application and pack state.

    Stable
  • GET
    /jobs/:id

    Read full details for one added job.

    Stable
  • POST
    /jobs/import

    Import a job from a URL and extract structured details.

    Beta
  • POST
    /jobs/:id/skip

    Skip or dismiss an added job.

    Stabilizing

Applications

Generate application materials, trigger submission, and surface cases that require candidate review.

  • POST
    /jobs/:id/pack

    Queue application materials for an added job. `assets` names a subset (`resume`, `coverLetter`, `answers`); omitting it generates all three.

    Beta
  • GET
    /applications/:id/pack

    Read generated pack state and application materials for an application.

    Beta
  • POST
    /jobs/:id/apply

    Submit the prepared application or return a candidate-review state when more context is needed.

    Stabilizing
  • POST
    /applications/:id/resume

    Generate a tailored resume for an application.

    Beta
  • GET
    /applications/:id/resumes

    List tailored resumes generated for an application.

    Beta