jd-intel-mcp 0.4.1 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # jd-intel-mcp
 
-MCP server for [jd-intel](https://github.com/prPMDev/jd-intel). Lets any AI assistant (Claude Desktop, Cursor, Windsurf) search open job listings across Greenhouse, Lever, and Ashby through natural conversation.
+MCP server for [jd-intel](https://github.com/prPMDev/jd-intel). Lets any AI assistant (Claude Desktop, Cursor, Windsurf) search open job listings across Greenhouse, Lever, Ashby, SmartRecruiters, Teamtailor, Recruitee, and Workday through natural conversation.
 
 > **Stop pasting job descriptions into AI assistants. Let your AI fetch them directly.**
 
@@ -9,7 +9,7 @@ MCP server for [jd-intel](https://github.com/prPMDev/jd-intel). Lets any AI assi
 ## What you can ask
 
 - "Is Stripe hiring PMs in the US?"
-- "Find remote engineering roles at fintech companies, posted in the last two weeks, then draft a cover letter for the best match."
+- "Find remote engineering roles at fintech companies, posted in the last two weeks, then rank them by fit for a senior backend profile."
 - "What companies in your index are in the developer tools space?"
 - "Does Figma use Greenhouse or Lever?"
 

package/descriptions.js

@@ -8,7 +8,7 @@
  * the AI's behavior changes immediately when descriptions change.
  */
 
-export const FETCH_JOBS = `Fetch open job postings from a specific company's ATS (Greenhouse, Lever, or Ashby).
+export const FETCH_JOBS = `Fetch open job postings from a specific company's ATS (Greenhouse, Lever, Ashby, SmartRecruiters, Teamtailor, Recruitee, Workday).
 
 USE WHEN: the user asks about roles at a known company ("Is Stripe hiring?", "What's open at Figma?").
 
@@ -32,12 +32,14 @@ location_excludes: array. Drop jobs whose location contains any keyword. Use as
 
 limit: default 100. Reduce for high-volume companies.
 
+workday: optional { tenant, env, site }. Use ONLY for a Workday company not in the registry when the user gives a careers URL. Derive from https://{tenant}.{env}.myworkdayjobs.com/{site}: tenant is the first label, env is the part like wd108, site is the path segment. Overrides the registry for that fetch. Never guess or fabricate these values; use only what the user supplied or what is literally in the careers URL. Omit this argument entirely if you do not have a real URL.
+
 RESPONSE: { status, data: [jobs], metadata: { attempted, succeeded, failed, notes } }. Check status first. "partial" means some adapters failed. Tell the user results may be incomplete.
 
 ERROR CODES:
 - company_not_found: slug not in registry, not detected
-- ats_unreachable: known ATS failed
-- invalid_args: missing/malformed args
+- ats_unreachable: known ATS failed, or a supplied workday {tenant,env,site} was rejected by Workday
+- invalid_args: missing/malformed args, including an incomplete workday triple
 - rate_limited: upstream 429`;
 
 export const SEARCH_REGISTRY = `Find companies in the indexed registry by name or sector.
@@ -60,7 +62,7 @@ RESPONSE: { status, data: [{ slug, name, sector, ats }], metadata }. Each result
 ERROR CODES:
 - invalid_args: both query and sector missing`;
 
-export const DETECT_ATS = `Detect which ATS platform (Greenhouse, Lever, or Ashby) a company uses.
+export const DETECT_ATS = `Detect which ATS platform (Greenhouse, Lever, Ashby, SmartRecruiters, Teamtailor, Recruitee) a company uses by probing. Workday is registry-only and never returned here; find Workday-hosted companies via search_registry or fetch_jobs (which auto-detects from the registry).
 
 USE WHEN: user asks about the ATS platform explicitly ("What ATS does Stripe use?") or for debugging.
 
@@ -70,7 +72,7 @@ ARGUMENT GUIDE:
 
 company: company name or slug. Hyphens and spaces stripped automatically ("Cockroach Labs" → "cockroachlabs").
 
-RESPONSE: { status, data: "greenhouse" | "lever" | "ashby" | null, metadata }. data === null means no supported ATS hosts this company. "partial" status means some probes failed. Result may be incomplete.
+RESPONSE: { status, data: "greenhouse" | "lever" | "ashby" | "smartrecruiters" | "teamtailor" | "recruitee" | null, metadata }. data === null means none of the probeable ATS host this company (Workday is registry-only and never detected here). "partial" status means some probes failed. Result may be incomplete.
 
 ERROR CODES:
 - invalid_args: company arg missing
@@ -80,4 +82,4 @@ export const REGISTRY_RESOURCE = `The full jd-intel company registry, grouped by
 
 Use for broad surveys ("what fintech companies are indexed?", "tell me about the catalog"). Fetched once per session, then cached. Cheaper than repeated search_registry calls for multi-query reasoning.
 
-Shape: { greenhouse: [{slug, name, sector}], lever: [...], ashby: [...] }.`;
+Shape: { greenhouse: [{slug, name, sector}], lever: [...], ashby: [...], smartrecruiters: [...], teamtailor: [...], recruitee: [...], workday: [...] }.`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jd-intel-mcp",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "MCP server for jd-intel. Your AI assistant fetches and reasons over full job descriptions, no copy-paste.",
   "type": "module",
   "main": "server.js",
@@ -22,11 +22,12 @@
     "start": "node server.js",
     "dev": "node --watch server.js",
     "install:local": "node cli.js install",
-    "uninstall:local": "node cli.js uninstall"
+    "uninstall:local": "node cli.js uninstall",
+    "test": "node --test test/*.test.js"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "jd-intel": "^0.1.0",
+    "jd-intel": "^0.6.0",
     "zod": "^3.23.0"
   },
   "keywords": [

package/tools.js

@@ -21,7 +21,10 @@ import {
   DETECT_ATS,
 } from './descriptions.js';
 
-export function registerTools(server) {
+export function registerTools(server, deps = {}) {
+  const _fetchJobs = deps.fetchJobs || fetchJobs;
+  const _findAtsBySlug = deps.findAtsBySlug || findAtsBySlug;
+
   server.registerTool(
     'fetch_jobs',
     {
@@ -35,12 +38,37 @@ export function registerTools(server) {
         location_includes: z.array(z.string()).optional().describe('Keep jobs whose location contains any keyword'),
         location_excludes: z.array(z.string()).optional().describe('Drop jobs whose location contains any keyword'),
         limit: z.number().int().positive().optional().describe('Cap results (default 100)'),
+        workday: z
+          .object({
+            tenant: z.string().trim().min(1).describe('Workday tenant, the first URL label, e.g. "expedia"'),
+            env: z.string().trim().min(1).describe('Workday env/datacenter, e.g. "wd108", "wd5"'),
+            site: z.string().trim().min(1).describe('Workday career-site path, e.g. "search", "Cisco_Careers"'),
+          })
+          .strict()
+          .optional()
+          .describe('Override the registry for a Workday board not indexed. Derive all three from the careers URL https://{tenant}.{env}.myworkdayjobs.com/{site}. Never guess these.'),
       },
     },
     async (args) => {
+      let ats;
+      let config;
+      if (args.workday) {
+        const { tenant, env, site } = args.workday;
+        if (!tenant?.trim() || !env?.trim() || !site?.trim()) {
+          return error(
+            ERROR_CODES.INVALID_ARGS,
+            'workday requires all three of {tenant, env, site}. Read them from the careers URL https://{tenant}.{env}.myworkdayjobs.com/{site}.'
+          );
+        }
+        ats = 'workday';
+        config = { tenant, env, site };
+      }
+
       try {
-        const jobs = await fetchJobs({
+        const jobs = await _fetchJobs({
           company: args.company,
+          ats,
+          config,
           titleFilter: args.title_filter,
           filter: args.filter,
           postedWithinDays: args.posted_within_days,
@@ -50,15 +78,23 @@ export function registerTools(server) {
         });
 
         const normalizedSlug = args.company.toLowerCase().replace(/[^a-z0-9]/g, '');
-        const registryAts = await findAtsBySlug(normalizedSlug);
+        const registryAts = await _findAtsBySlug(normalizedSlug);
 
         return success(jobs, {
           count: jobs.length,
           registry_hit: registryAts !== null,
-          ats: registryAts,
+          ats: config ? 'workday' : registryAts,
+          workday_override: Boolean(config),
         });
       } catch (err) {
-        return error(ERROR_CODES.INVALID_ARGS, err.message || 'Unknown error');
+        const msg = err.message || 'Unknown error';
+        if (config && /Workday API error/.test(msg)) {
+          return error(
+            ERROR_CODES.ATS_UNREACHABLE,
+            `Workday rejected ${config.tenant}/${config.env}/${config.site}: ${msg}. Verify the triple against the careers URL https://{tenant}.{env}.myworkdayjobs.com/{site}.`
+          );
+        }
+        return error(ERROR_CODES.INVALID_ARGS, msg);
       }
     }
   );