The Jobs API

Search employer career-site jobs in Canada and the US, retrieve full postings and inspect job counts. Remote MCP with your own API key.

Hosted MCP Server

npx add-mcp 'https://api.thejobsapi.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

MCP server for AI assistants

The Jobs API has an official remote Model Context Protocol server. It lets AI assistants and agents search jobs in the United States and Canada with your API key. Calls use your plan the same way as /v1 requests.

https://api.thejobsapi.com/mcp

Tools

  • search_jobs: search active jobs by keywords, title, province or state, city, remote, pay, employment type, hiring system and date. Returns up to 25 compact jobs and a cursor. Same filters as Search jobs.
  • get_job: the full posting for one job id. Same as Get a job.
  • job_stats: active job counts per hiring system and region. Same as Stats.

Claude Code

claude mcp add --transport http thejobsapi https://api.thejobsapi.com/mcp --header "Authorization: Bearer tja_live_..."

Claude Desktop, Cursor and other clients

Add a remote server with the URL above and an Authorization header. For clients that only start local servers, use the mcp-remote bridge:

{
  "mcpServers": {
    "thejobsapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thejobsapi.com/mcp",
        "--header",
        "Authorization:Bearer ${THEJOBSAPI_KEY}"
      ],
      "env": {
        "THEJOBSAPI_KEY": "tja_live_..."
      }
    }
  }
}

Test it with curl

curl -s https://api.thejobsapi.com/mcp -H "Authorization: Bearer tja_live_..." -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_jobs","arguments":{"country":"CA","title":"nurse","city":"Toronto","limit":3}}}'

Good to know

  • The server is stateless and answers with JSON (Streamable HTTP). It does not open a server event stream.
  • Keep your key private. Use a separate key for each assistant so you can revoke one on the API keys page.
  • No key yet? The free trial includes 100,000 jobs for 14 days, with no request limit and no card.