Hiring

List jobs

hiring_list_jobs · Reads only · Markdown

The business's jobs with their status, page and applicants per stage.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

Which jobs are open, and how many people have applied to each?

Your agent callshiring_list_jobsFree*

The example business is Halverson Cycle & Repair, a bike shop with a repair workshop in Portland, Oregon. The reply is the one the tool really gives.

With these arguments
{
  "status": "open"
}
What comes back
{
  "careers": {
    "name": "Halverson Cycle & Repair",
    "page_url": "https://cncto.co/j/halverson-cycle-repair",
    "intro": "We sell, build and fix bikes in our workshop on SE Ash St in Portland: seven of us, and more in summer.",
    "website": "https://halversoncycle.example",
    "reply_to": "jobs@halverson-cycle-repair.useconecto.com",
    "notify_email": "luis@halversoncycle.example",
    "ai_review": true,
    "ai_notice": "Halverson Cycle & Repair uses AI to help review applications against what the role asks for. A person reads every application and makes every decision. To have a person look at yours again, or to ask what was weighed, reply to the confirmation email.",
    "application_limit": null,
    "open_jobs": 1
  },
  "jobs": [
    {
      "job": "bike-mechanic",
      "title": "Bike mechanic",
      "department": "Workshop",
      "location": "Portland, OR",
      "workplace": "on_site",
      "employment_type": "full_time",
      "salary": {
        "min": 24,
        "max": 30,
        "currency": "USD",
        "period": "hour"
      },
      "salary_text": "$24 to $30 an hour",
      "description": "We build, tune and repair city, gravel and cargo bikes in our Portland workshop. You work the stand with two other mechanics: tune-ups, brake bleeds, wheel builds and e-bike checks.\n\n**You have** two years or more in a bike shop, and your own basic tools.\n\n**We offer** paid time off, health insurance and a staff discount on bikes and parts.",
      "questions": [
        {
          "id": "q1",
          "label": "How many years have you worked as a bike mechanic?",
          "type": "number",
          "required": true
        },
        {
          "id": "q2",
          "label": "Can you lift 50 lb?",
          "type": "yes_no",
          "required": false,
          "required_answer": true
        }
      ],
      "criteria": [
        {
          "id": "c1",
          "text": "Two years as a mechanic in a bike shop",
          "required": true,
          "weight": 3
        },
        {
          "id": "c2",
          "text": "Has built wheels",
          "required": false,
          "weight": 3
        }
      ],
      "filter": null,
      "job_id": 4101,
      "status": "open",
      "stages": [
        "Applied",
        "Screen"
      ],
      "page_url": "https://cncto.co/j/halverson-cycle-repair/bike-mechanic",
      "applicants": {
        "Applied": 2,
        "Screen": 0,
        "Interview": 0,
        "Offer": 0,
        "Hired": 0,
        "Rejected": 0
      },
      "opened_at": "2026-10-14T08:00:00+00:00",
      "closed_at": null
    }
  ]
}

Use it when

To find a job's slug, or see how many people applied.

What it does

This account's jobs with their status, page and applicants per stage.

What comes back

careers: the careers page; jobs: each with its slug, title, status, page URL and applicants per stage. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
statusstringOne of: draft,open,closed.

The call

Over MCP, call hiring_list_jobs on https://api.conecto.chat/mcp/hiring. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/hiring_list_jobs \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status":"open"}'

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md