vox/jobs

AI Integration

Voxjobs for AI assistants

Integrate the Voxjobs jobs catalogue directly into Claude, Cursor and other MCP-compatible clients.

No authenticationReal-time dataMCP Streamable HTTP

What is MCP

Model Context Protocol

The Model Context Protocol (MCP) is an open standard that lets AI assistants query external data sources in real time — without leaving the conversation.

With Voxjobs MCP, an assistant can search jobs, get details on a listing, explore companies that are hiring and read career articles — all with up-to-date data from the database.

Tools

4 tools available

search_jobs

Search jobs by semantic text (role/skills) with filters: location, work mode, seniority, schedule, contract, minimum salary and company.

search_jobs({ query: "react developer", remoteMode: "REMOTE", salaryMinYearly: 40000 })
get_job_detail

Get full details of a job: description, terms, salary (gross/net/estimated made explicit), company and apply link at the source.

get_job_detail({ slug: "engenheiro-de-dados-lisboa-abc123" })
search_companies

Search companies with active jobs in this market: sector, headquarters, size and number of open roles.

search_companies({ name: "Feedzai" })
search_articles

Search job-hunting guides, labour-market analysis, salary insights and career tips.

search_articles({ limit: 5 })

Attention

Don't paste the configuration JSON into a chat conversation. Pasting the config into a chat does nothing — the assistant just reads it as text. The configuration must go into the client's config file (see below) or be added via the settings interface.

How to integrate

Per-client instructions

Claude CodeFastest

A single command in the terminal — no manual file editing:

claude mcp add voxjobs --transport http https://www.voxjobs.uk/api/mcp

Then restart your Claude Code session. The tools are available immediately.

Claude DesktopRecommended

Claude Desktop doesn't connect to remote HTTP servers directly — it uses the open-source mcp-remote bridge. Edit the config file (not the chat!) and add this block inside mcpServers:

{
  "mcpServers": {
    "voxjobs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://www.voxjobs.uk/api/mcp"]
    }
  }
}

Requires Node.js (npx downloads mcp-remote on first run). Restart Claude Desktop after saving.

File location

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Connectors (Claude.ai web and Desktop)

Claude's Connectors UI requires OAuth and can't yet connect public, no-auth servers like this one — it would fail with a sign-in error. Use Claude Code or the config file above.

Cursor

In Settings → MCP → Add server, choose type http and enter the URL:

https://www.voxjobs.uk/api/mcp

ChatGPTNo MCP support

ChatGPT doesn't support MCP natively. You can use Voxjobs by pasting this text into a custom GPT or a conversation:

“Check the Voxjobs jobs catalogue at https://www.voxjobs.uk/jobs to find work in United Kingdom.”

Perplexity

Perplexity indexes Voxjobs directly via llms.txt and the public catalogue. No configuration needed — just ask:

“Find jobs in United Kingdom on Voxjobs”

Examples

What you can ask

01“Find me remote data-engineering jobs in United Kingdom paying over £50k/year”
02“Which tech companies are hiring right now?”
03“Show junior digital-marketing jobs, full-time”
04“Read a Voxjobs guide on negotiating salary in United Kingdom”

For developers

Technical endpoint

MCP Streamable HTTP server, no authentication. Each POST is a complete JSON-RPC 2.0 exchange. Real-time data, scoped to this domain's market.

Endpointhttps://www.voxjobs.uk/api/mcp
DiscoveryGET https://www.voxjobs.uk/api/mcp
ProtocolMCP 2024-11-05 · JSON-RPC 2.0 · HTTP POST