jobmatch-mcp

jobmatch-mcp is a TypeScript Model Context Protocol server for job discovery backed by the TheirStack Jobs API.

• A runnable TypeScript MCP server over stdio
• MCP tools for search_jobs, get_job_details, rank_jobs_for_candidate, and list_sources
• Zod-backed input schemas
• Environment variable loading and validation
• A single TheirStack-backed job search integration
• ESLint, Prettier, Vitest, and TypeScript build scripts

Search normalized jobs from TheirStack.

Current behavior:

• Calls TheirStack POST /v1/jobs/search
• Uses query as a title search
• Treats location: "remote" as a remote-only search
• Uses JOBMATCH_THEIRSTACK_POSTED_AT_MAX_AGE_DAYS to satisfy TheirStack's required date filter

Example input:

{
  "query": "backend engineer",
  "location": "remote",
  "limit": 10
}

Fetch normalized details for a single job by jobId and sourceId.

Current behavior:

• Supports sourceId: "theirstack"
• Resolves the job by calling TheirStack search with job_id_or

Example input:

{
  "jobId": "123456789",
  "sourceId": "theirstack"
}

Rank a provided set of normalized jobs against a candidate profile.

Example input:

{
  "candidateProfile": {
    "headline": "Senior backend engineer",
    "targetRoles": ["Backend Engineer", "Platform Engineer"],
    "preferredLocations": ["Remote"],
    "skills": ["TypeScript", "Node.js", "PostgreSQL"]
  },
  "jobs": []
}

List sources known to the server and whether each one is planned or active.

pnpm install

Copy .env.example to .env and set your TheirStack API key.

cp .env.example .env

Current variables:

• JOBMATCH_MCP_SERVER_NAME
• JOBMATCH_MCP_SERVER_VERSION
• JOBMATCH_MCP_DEFAULT_TIMEOUT_MS
• JOBMATCH_THEIRSTACK_API_KEY
• JOBMATCH_THEIRSTACK_BASE_URL
• `