List jobs
Jobs of your workspace with client company, visibility and candidate count.
MCP tool recruiterflow_read → list_jobs
read
Lists the jobs your user can see, newest first, one page at a time; pass next_cursor back as cursor. status open is the default, closed returns closed jobs. visibility is one of external, internal, unlisted, confidential, draft, closed or closed confidential. query matches part of the job title or the client company. Use job_id in the other tools.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open (default) or closed. |
| visibility enum | enum | external, internal, unlisted, confidential, draft, closed or closed confidential. |
| query string | string | Part of the job title or the client company name. |
| limit integer | integer | 1 to 50. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "recruiterflow_read",
"arguments": {
"operation": "list_jobs",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"jobs": [
{
"job_id": "48213",
"title": "Senior Backend Engineer",
"company": "Northwind Labs",
"status": "open",
"visibility": "external",
"location": "Berlin",
"candidates": 14,
"url": "https://recruiterflow.com/jobs/48213"
},
{
"job_id": "48307",
"title": "Product Designer",
"company": "Brightline",
"status": "open",
"visibility": "internal",
"location": "Remote",
"candidates": 9,
"url": "https://recruiterflow.com/jobs/48307"
}
],
"next_cursor": null
},
"isError": false
}