Search jobs
search_jobsSearch for jobs in the STON job database. Returns structured JSON.
Call this tool ONCE per user request, then present the returned jobs list
to the user in whatever format fits (markdown list, table, plain text).
Always include the apply link from the url field for each job.
If has_more is true, mention total_found and ask whether to fetch more.
NEVER call this tool multiple times in a row to collect all pages automatically.
To count results without fetching full job data, prefer count_jobs. If a
filter you need isn't on count_jobs, call this tool with rows=1 and read
total_found (the count is server-side and independent of rows).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_jobs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Search keywords (German job market — examples: "Softwareentwickler Python", "Krankenpfleger") | |
| page | No | Page number starting at 1 | |
| rows | No | Results per page, 1-50 (default: 25) | |
| sort | No | "relevance" (default) or "date" (newest first) | |
| radius | No | Search radius in km around the location, e.g. 25, 50 (default: server setting) | |
| location | No | City, region or area, e.g. "München", "Ravensburg", "Bodensee", "Baden-Württemberg" | |
| has_salary | No | If True, return only jobs that advertise a salary at all (any amount); if False, only jobs without one. Leave unset to ignore. | |
| max_salary | No | Maximum annual gross salary in EUR (optional, same overlap semantics) | |
| min_salary | No | Minimum ANNUAL gross salary in EUR (optional), e.g. 60000. Filtered server-side. Jobs advertised per month/hour are normalised to a yearly figure first, so e.g. 5000/month matches min_salary=60000. Salary ranges match on OVERLAP, not containment: a job advertised as 30.000–45.000 € IS returned at min_salary=40000 (the ranges overlap), and is NOT returned at max_salary=25000. | |
| working_plan | No | One of: "Vollzeit", "Teilzeit", "Minijob", "Homeoffice" (comma-separated for multiple) | |
| job_offer_type | No | One of: "Arbeitsplatz", "Ausbildung", "Praktikum", "Freiberuflich", "Werkstudent", "Trainee", "Duales-Studium" (comma-separated for multiple) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||