jobs-winterchill-mcp

An MCP server over the winterchill UK tech-jobs catalog (jobs.winterchill.xyz). It's a thin, read-only client over the public catalog API — no secrets, nothing stored — that lets an MCP client (Claude Desktop, the Claude CLI, etc.) search jobs, inspect companies, and match/tailor a CV.

Tools

match_cv / tailor_cv are stateless and anonymous (nothing is stored); they're rate-limited per IP. tailor_cv returns up to 5 edits on the free/anonymous tier.

Related MCP server: job-search-mcp

Install / configure

Requires Python ≥ 3.10. The server speaks MCP over stdio.

Add it to your MCP client config (Claude Desktop claude_desktop_config.json, or the Claude CLI):

{
  "mcpServers": {
    "winterchill": {
      "command": "uvx",
      "args": ["jobs-winterchill-mcp"]
    }
  }
}

Or run from a local checkout:

uv run jobs-winterchill-mcp
# or
pip install -e . && jobs-winterchill-mcp

Configuration

How it works

Every tool maps to a public endpoint:

• search_jobs → GET /api/v1/jobs

• get_job → GET /api/v1/jobs/{source}/{id}

• get_company → GET /api/v1/companies/{key}

• match_cv → POST /api/cv/match

• tailor_cv → POST /api/cv/job-match (mode: tailor)

No API key is needed. The catalog data is the same already-public board; this server just makes it available to LLM agents over MCP.

License

MIT © Valerii Iatsko