search
Pack: adzuna · Endpoint: https://gateway.pipeworx.io/adzuna/mcp
Search jobs in a country. country is required (ISO-style: gb, us, ca, de, fr, …).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
country | string | yes | gb, us, ca, de, fr, … |
what | string | no | Free-text query (title + description) |
what_phrase | string | no | Exact-phrase variant of what |
where | string | no | Location (city, region) |
distance | number | no | Search radius from where, in km |
results_per_page | number | no | 1-50 (default 20) |
page | number | no | 1-based page (default 1) |
salary_min | number | no | Lower bound, in local currency |
salary_max | number | no | Upper bound |
full_time | boolean | no | |
permanent | boolean | no | |
sort | string | no | default | hybrid | date | salary | relevance |
max_days_old | number | no | Restrict to jobs posted in the last N days |
Example call
curl -X POST https://gateway.pipeworx.io/adzuna/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{}}}'Response shape
| Field | Type | Description |
|---|---|---|
results | array | List of job postings |
count | number | Total matching jobs |
mean_salary | number | Mean salary for results |
Full JSON Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"description": "List of job postings",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Job ID"
},
"title": {
"type": "string",
"description": "Job title"
},
"company": {
"type": "object",
"properties": {
"display_name": {
"type": "string",
"description": "Company name"
}
}
},
"description": {
"type": "string",
"description": "Job description"
},
"location": {
"type": "object",
"properties": {
"display_name": {
"type": "string",
"description": "Location"
}
}
},
"salary_min": {
"type": "number",
"description": "Minimum salary"
},
"salary_max": {
"type": "number",
"description": "Maximum salary"
},
"salary_currency": {
"type": "string",
"description": "Currency code"
},
"created": {
"type": "string",
"description": "Creation timestamp"
},
"redirect_url": {
"type": "string",
"description": "Job posting URL"
}
}
}
},
"count": {
"type": "number",
"description": "Total matching jobs"
},
"mean_salary": {
"type": "number",
"description": "Mean salary for results"
}
}
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"adzuna": {
"url": "https://gateway.pipeworx.io/adzuna/mcp"
}
}
}See Getting Started for client-specific install steps.