`search`

Pack: adzuna · Endpoint: https://gateway.pipeworx.io/adzuna/mcp

“Find jobs / openings / roles / positions for [title] in [city]” / “remote [role] jobs” / “[language / framework] developer jobs” / “salary range for [role] in [country]” — search live job postings via Adzuna (global job-board aggregator). Filters: country (gb/us/ca/de/fr/…), title query, location, distance, salary band, full-time/permanent, posted recency. Returns ranked listings with title, company, location, salary, posted date.

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

Arguments

{
  "country": "gb",
  "what": "python developer",
  "where": "London",
  "results_per_page": 25
}

curl

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":{"country":"gb","what":"python developer","where":"London","results_per_page":25}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search', {
  "country": "gb",
  "what": "python developer",
  "where": "London",
  "results_per_page": 25
});

More examples

{
  "country": "us",
  "what_phrase": "senior software engineer",
  "where": "San Francisco",
  "salary_min": 120000,
  "full_time": true,
  "sort": "salary"
}

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.

search