Search jobs
Jobs by title, company, city and state, open jobs only if you ask.
MCP tool jobdiva_read → search_jobs
read
Returns one row per job with its id, JobDiva reference, title, company, location and status. Use job_id in get_job, list_submittals and create_submittal. Jobs you cannot open in JobDiva are not returned.
Parameters
| Name | Type | Description |
|---|---|---|
| title string | string | Words from the job title. |
| company_name string | string | Company the job is for. |
| city string | string | City of the job. |
| state string | string | State of the job. |
| open_only boolean | boolean | true returns open jobs only. |
| limit integer | integer | Maximum number of jobs returned. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "jobdiva_read",
"arguments": {
"operation": "search_jobs",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"jobs": [
{
"job_id": 24071835,
"reference": "26-04817",
"title": "Senior Data Analyst",
"company": "Northwind Logistics",
"location": "Chicago, IL",
"status": "Open"
},
{
"job_id": 24072210,
"reference": "26-04902",
"title": "Data Engineer",
"company": "Harbor Freight Tech",
"location": "Austin, TX",
"status": "Open"
}
]
},
"isError": false
}