JobGPT MCP Server

Instructions

Implementation Reference

• src/tools/job-hunts.ts:132-149 (handler)

  The handler implementation for update_job_hunt which parses input arguments, builds the update payload, calls the client, and returns the updated status.

  async (args) => {
    const updateData: Record<string, unknown> = {};
    if (args.name !== undefined) { updateData.name = args.name; }
    if (args.autoMode !== undefined) { updateData.autoMode = args.autoMode; }
    if (args.dailyLimit !== undefined) { updateData.dailyLimit = args.dailyLimit; }
    if (args.minMatchScore !== undefined) { updateData.minMatchScore = args.minMatchScore; }
    if (args.customizeResume !== undefined) { updateData.customizeResume = args.customizeResume; }
    if (args.status !== undefined) { updateData.status = args.status; }
    if (args.config !== undefined) { updateData.config = args.config; }
  
    if (Object.keys(updateData).length === 0) {
      return { content: [{ type: 'text' as const, text: JSON.stringify({ message: 'No fields provided to update' }, null, 2) }] };
    }
  
    await client.updateJobHunt(args.id, updateData);
    const updated = await client.getJobHunt(args.id);
    return { content: [{ type: 'text' as const, text: JSON.stringify({ message: 'Job hunt updated successfully', jobHunt: formatJobHunt(updated) }, null, 2) }] };
  }

• src/tools/job-hunts.ts:103-130 (schema)

  The input validation schema for update_job_hunt defined using Zod.

  {
    id: z.string().describe('The job hunt ID'),
    name: z.string().optional().describe('New name for the job hunt'),
    autoMode: z.boolean().optional().describe('Enable/disable full autopilot mode. When enabled, jobs are automatically matched, scored against your resume using AI, and applied to if they meet your minMatchScore threshold. Resume customization (if enabled) is applied before each application. Each auto-apply consumes a credit.'),
    dailyLimit: z.number().optional().describe('Maximum jobs to auto-apply per day (max: 100)'),
    minMatchScore: z.number().optional().describe('Minimum match score for auto-apply (0-1). Default is 0.70 (70%) when not explicitly set.'),
    customizeResume: z.boolean().optional().describe('Enable/disable AI resume customization for applications'),
    status: z.enum(['ACTIVE', 'ARCHIVED', 'DELETED']).optional().describe('Job hunt status'),
    config: z.object({
      titles: z.array(z.string()).optional().describe('Job titles to match'),
      locations: z.array(z.string()).optional().describe('Locations to match. Use plain city names without state abbreviations (e.g., "San Francisco" not "San Francisco, CA"). For states, use the full state name (e.g., "Texas"). Use "Remote" to match remote jobs worldwide without country restrictions.'),
      countries: z.array(z.string()).optional().describe('Country codes'),
      companies: z.array(z.string()).optional().describe('Companies to include'),
      excludedCompanies: z.array(z.string()).optional().describe('Companies to exclude'),
      skills: z.array(z.string()).optional().describe('Required skills'),
      remote: z.boolean().optional().describe('When true, only return remote jobs. When false or omitted, return all jobs (both remote and non-remote).'),
      baseSalaryMin: z.number().optional().describe('Minimum salary'),
      baseSalaryMax: z.number().optional().describe('Maximum salary'),
      expLevels: z.array(z.string()).optional().describe('Experience levels (e.g., ["SE" for Senior, "MI" for Mid-level, "EN" for Entry])'),
      industries: z.array(z.string()).optional().describe('Industries (use get_industries to see valid values)'),
      companySize: z.array(z.string()).optional().describe('Company sizes (e.g., ["xs" for 1-50, "s" for 50-200, "m" for 200-1K, "l" for 1K-5K, "xl" for 5K+])'),
      h1bSponsorship: z.boolean().optional().describe('H1B sponsorship required'),
      relevancy: z.enum(['HIGH', 'MEDIUM']).nullable().optional().describe('Search relevancy mode - HIGH for strict title/skills matching, MEDIUM for broader keyword-based results. Default is null (MEDIUM behavior).'),
      dateOffset: z.enum(['24H', '1D', '2D', '7D', '14D', '1M', '3M', '6M', '9M', '1Y']).nullable().optional().describe('Only match jobs posted within this time window (e.g., "7D" for last 7 days). Default is "7D".'),
      workArrangement: z.array(z.string()).optional().describe('Work arrangement filter (e.g., ["Full Time", "Part Time", "Contract", "Internship", "Freelance", "Temporary"]). Defaults to ["Full Time"] if not set.'),
      excludedKeywords: z.array(z.string()).optional().describe('Keywords to exclude from job results'),
      excludedTitles: z.array(z.string()).optional().describe('Job titles to exclude from results'),
    }).optional().describe('Search filters configuration. REPLACES entire config - include all fields you want to keep.'),

• src/tools/job-hunts.ts:100-102 (registration)

  The tool registration for update_job_hunt in the McpServer.

  server.tool(
    'update_job_hunt',
    'Update job hunt settings and search filters. Use this to change what jobs are matched. IMPORTANT: When updating config, you must pass the ENTIRE config object as it replaces the existing config (not a partial merge). Use get_job_hunt first to see current config, then include all fields you want to keep.',