Add candidates to hotlist

Put candidates into a hotlist.

MCP tool jobdiva_write → add_candidates_to_hotlist

write

Adds the candidates in one call and returns how many are in the hotlist now. Reaches no one and is undone with remove_candidates_from_hotlist, so it does not wait for your OK.

Parameters

Parameters: add_candidates_to_hotlist
NameTypeDescription
hotlist_id integer required integer Hotlist ID from list_hotlists or create_hotlist.
candidate_ids integer[] required integer[] Candidate IDs to add.

tools/call

JSON-RPC

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "jobdiva_write",
    "arguments": {
      "operation": "add_candidates_to_hotlist",
      "arguments": {
        "hotlist_id": 88314,
        "candidate_ids": [
          5821904,
          5830117,
          5834402
        ]
      }
    }
  }
}

Example response

JSON

{
  "content": [
    {
      "type": "text",
      "text": "{ ... same JSON as structuredContent ... }"
    }
  ],
  "structuredContent": {
    "hotlist_id": 88314,
    "added": 3,
    "hotlist_size": 3
  },
  "isError": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.