jobseek-mcp 0.5.1 → 0.7.0

package/README.md

@@ -1,24 +1,58 @@
 # JobSeek MCP Server
 
-AI-powered job search automation for Claude Code.
+AI-powered job search automation for Claude. Works with Claude for macOS + Claude for Chrome for fully automated job searching and application assistance.
+
+[![npm version](https://badge.fury.io/js/jobseek-mcp.svg)](https://www.npmjs.com/package/jobseek-mcp)
+
+## Features
+
+- **🚀 Automated Job Search** - Claude navigates job boards, finds matching roles, and helps you apply
+- **📋 Smart Form Filling** - Get your profile data ready for any application form
+- **🎯 Job Matching** - AI-powered scoring to find the best fit roles
+- **📄 Resume Optimization** - ATS-friendly resume enhancements
 
 ## Quick Start
 
-### 1. Build the MCP Server
+### Install from npm
+
 ```bash
-cd jobseek-mcp
-npm install
-npm run build
+npx jobseek-mcp
 ```
 
-### 2. Generate an API Key
+Or install globally:
+
+```bash
+npm install -g jobseek-mcp
+```
+
+### 1. Generate an API Key
 - Go to https://getjobseek.com/dashboard/api-keys
 - Click "Generate Key"
 - Copy the key (you won't be able to see it again!)
 
-### 3. Configure Claude Code
+### 2. Configure Claude
+
+#### For Claude for macOS / Claude Desktop
+
+Add to your Claude config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):
 
-Open `~/.claude.json` in your editor and find your project's `mcpServers` section. Add the `jobseek` entry:
+```json
+{
+  "mcpServers": {
+    "jobseek": {
+      "command": "npx",
+      "args": ["jobseek-mcp"],
+      "env": {
+        "JOBSEEK_API_KEY": "sk_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+#### For Claude Code
+
+Add to `~/.claude.json`:
 
 ```json
 {
@@ -27,10 +61,9 @@ Open `~/.claude.json` in your editor and find your project's `mcpServers` sectio
       "mcpServers": {
         "jobseek": {
           "type": "stdio",
-          "command": "node",
-          "args": ["/path/to/jobseek-mcp/dist/index.js"],
+          "command": "npx",
+          "args": ["jobseek-mcp"],
           "env": {
-            "JOBSEEK_API_URL": "https://getjobseek.com",
             "JOBSEEK_API_KEY": "sk_live_your_key_here"
           }
         }
@@ -40,81 +73,126 @@ Open `~/.claude.json` in your editor and find your project's `mcpServers` sectio
 }
 ```
 
-**Important:** Replace:
-- `/path/to/your/project` with your project directory
-- `/path/to/jobseek-mcp/dist/index.js` with the actual path to the built MCP server
-- `sk_live_your_key_here` with your generated API key
+### 3. Restart Claude
 
-### 4. Restart Claude Code
-
-After saving the config, restart Claude Code. Type `/mcp` to verify the server is connected.
+After saving the config, restart Claude. Type `/mcp` to verify the server is connected.
 
 ## Available Tools
 
-### `upload_resume`
-Upload a PDF resume to JobSeek.
+### `my_profile`
+Get your profile information including resume summary, skills, and experience.
+
+### `get_form_data`
+Get structured profile data optimized for filling job application forms. Returns:
+- Personal info (name, email, phone, location)
+- Professional summary and headline
+- Skills (as array and comma-separated text)
+- Work history formatted for forms
+- Education details
+- Default cover letter text
+
+**Example:** "Get my form data for applying to jobs"
 
-**Example prompts:**
-- "Upload my resume from ~/Documents/resume.pdf"
-- "Upload /Users/me/Downloads/Resume_2025.pdf to JobSeek"
+### `evaluate_job`
+Score a job against your profile. Provide the job title, company, and description to get:
+- Match score (0-100%)
+- Recommendation (strongly_recommend, recommend, consider, skip)
+- Strengths and gaps analysis
+- Application strategy
 
-**What it does:**
-- Reads PDF from your local filesystem
-- Extracts text and parses with AI
-- Stores the parsed resume in JobSeek
+**Example:** "Evaluate this job for me: [paste job description]"
+
+### `launch_pad`
+Open job search tabs across major job boards (LinkedIn, Indeed, Glassdoor, etc.) using your resume to determine search terms.
 
 ### `optimize_resume`
 Optimize your resume for ATS (Applicant Tracking Systems).
 
-**Example prompts:**
-- "Optimize my resume for ATS"
-- "Regenerate my resume with a more technical summary"
-- "Make my resume more concise"
+### `upload_resume`
+Upload a PDF resume to JobSeek.
 
-**What it does:**
-- Rewrites with stronger action verbs
-- Adds measurable impact statements
-- Optimizes keywords for ATS scanning
-- Returns the optimized content + rationale
+### `analyze_matches`
+Review your recent job matches from the Chrome extension.
 
-### `download_resume_pdf`
-Download your resume as a file.
+## Automated Job Search (with Claude for Chrome)
 
-**Example prompts:**
-- "Download my resume"
-- "Save my optimized resume to a file"
-- "Download my ATS-optimized resume to ~/Documents/resume.txt"
+The most powerful feature! Use the `/auto_job_search` prompt to have Claude:
 
-**Parameters:**
-- `filePath` (optional): Custom path for the file
-- `optimized` (optional): If true, downloads the ATS-optimized version
+1. **Prepare** - Fetch your profile and form data
+2. **Search** - Navigate to job sites and search for matching roles
+3. **Evaluate** - Score each job against your profile
+4. **Present** - Show you good matches (65%+ score) and ask for approval
+5. **Apply** - Fill out application forms with your data
+6. **Track** - Keep count of applied/skipped jobs
+
+### Usage
+
+In Claude for macOS with Claude for Chrome installed:
+
+```
+/auto_job_search site:linkedin query:"Senior Software Engineer" location:"Remote"
+```
+
+Or simply ask:
+> "Help me search for jobs on LinkedIn and apply to good matches"
+
+### Requirements
+- Claude for macOS
+- Claude for Chrome extension (for browser control)
+- JobSeek MCP configured with your API key
 
 ## Full Workflow Example
 
 ```
-You: "Optimize my resume for ATS"
-Claude: [calls optimize_resume] "Here's your optimized resume..."
+You: "Start an automated job search on LinkedIn for product manager roles"
+
+Claude: [fetches your profile]
+        "I found your profile. You're a Product Manager with 8 years of experience..."
+
+Claude: [navigates to LinkedIn, searches, finds a job]
+        "Found: Senior Product Manager at Stripe
+         Match Score: 87%
+         Strengths: Product strategy, data analysis, cross-functional leadership
+         Would you like me to apply to this role?"
+
+You: "Yes, apply"
 
-You: "That looks great! Download it as a file"
-Claude: [calls download_resume_pdf] "Saved to ~/Downloads/resume_optimized.txt"
+Claude: [fills out application form]
+        "I've filled out the application:
+         - Name: John Doe
+         - Email: john@example.com
+         - Resume: [attached]
+         - Why interested: [drafted response]
+         
+         Ready to submit?"
+
+You: "Looks good, submit it"
+
+Claude: [submits] "Application submitted! Moving to next job..."
 ```
 
 ## Troubleshooting
 
 ### "1 MCP server failed" error
 - Check `/mcp` in Claude Code for details
-- Verify the path to `dist/index.js` is correct
-- Make sure you ran `npm run build`
+- Make sure you have a valid API key
+- Try running `npx jobseek-mcp` directly to test
 
 ### "Authentication Required" error
-- Verify your API key is correct in `~/.claude.json`
+- Verify your API key is correct
 - Make sure you have a resume uploaded at https://getjobseek.com/dashboard/profile
-- Check that JOBSEEK_API_URL is set to `https://getjobseek.com`
 
 ## Development
 
 ```bash
+git clone https://github.com/shawnmitchell/jobseek.git
+cd jobseek/jobseek-mcp
+npm install
 npm run dev   # Run with tsx (hot reload)
 npm run build # Build for production
 npm start     # Run production build
 ```
+
+## License
+
+MIT © Shawn Mitchell

package/dist/index.js

@@ -1,78 +1,12 @@
 #!/usr/bin/env node
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { optimizeResumeTool, handleOptimizeResume } from "./tools/optimize-resume.js";
-import { downloadResumePdfTool, handleDownloadResumePdf } from "./tools/download-resume-pdf.js";
-import { uploadResumeTool, handleUploadResume } from "./tools/upload-resume.js";
-import { launchPadTool, handleLaunchPad } from "./tools/launch-pad.js";
-import { allResources, handleReadResource } from "./resources.js";
-import { allPrompts, getPromptMessages } from "./prompts.js";
-// Configuration
-const JOBSEEK_API_URL = process.env.JOBSEEK_API_URL || "https://jobseek-iota.vercel.app";
-const JOBSEEK_API_KEY = process.env.JOBSEEK_API_KEY;
-// Create the MCP server
-const server = new Server({
-    name: "jobseek-mcp",
-    version: "0.5.0",
-}, {
-    capabilities: {
-        tools: {},
-        resources: {},
-        prompts: {},
-    },
-});
-// List available tools
-server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return {
-        tools: [
-            optimizeResumeTool,
-            downloadResumePdfTool,
-            uploadResumeTool,
-            launchPadTool,
-        ],
-    };
-});
-// Handle tool calls
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    switch (name) {
-        case "optimize_resume":
-            return handleOptimizeResume(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
-        case "download_resume_pdf":
-            return handleDownloadResumePdf(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
-        case "upload_resume":
-            return handleUploadResume(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
-        case "launch_pad":
-            return handleLaunchPad(args, JOBSEEK_API_URL, JOBSEEK_API_KEY);
-        default:
-            throw new Error(`Unknown tool: ${name}`);
-    }
-});
-// List available resources
-server.setRequestHandler(ListResourcesRequestSchema, async () => {
-    return {
-        resources: allResources,
-    };
-});
-// Handle resource reads
-server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
-    const { uri } = request.params;
-    return handleReadResource(uri);
-});
-// List available prompts
-server.setRequestHandler(ListPromptsRequestSchema, async () => {
-    return {
-        prompts: allPrompts,
-    };
-});
-// Handle prompt requests
-server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-    const { name, arguments: args } = request.params;
-    return getPromptMessages(name, args || {});
-});
-// Start the server
+import { createServer } from "./server.js";
 async function main() {
+    const apiKey = process.env.JOBSEEK_API_KEY;
+    if (!apiKey) {
+        throw new Error("JOBSEEK_API_KEY environment variable is required");
+    }
+    const server = createServer(apiKey);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.error("JobSeek MCP Server running on stdio");

package/dist/prompts.d.ts

@@ -30,6 +30,15 @@ export declare const uploadResumePrompt: {
         required: boolean;
     }[];
 };
+export declare const autoJobSearchPrompt: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+};
 export declare const allPrompts: {
     name: string;
     description: string;

package/dist/prompts.js

@@ -38,12 +38,34 @@ export const uploadResumePrompt = {
         }
     ]
 };
+export const autoJobSearchPrompt = {
+    name: "auto_job_search",
+    description: "Automated job search: Navigate job sites, find matching jobs, and help apply. Requires Claude for Chrome browser control.",
+    arguments: [
+        {
+            name: "site",
+            description: "Which job site to search: linkedin, indeed, glassdoor, or all",
+            required: false
+        },
+        {
+            name: "query",
+            description: "Optional: specific job title or keywords to search for",
+            required: false
+        },
+        {
+            name: "location",
+            description: "Optional: location to search in (e.g., 'Remote', 'New York, NY')",
+            required: false
+        }
+    ]
+};
 // All prompts
 export const allPrompts = [
     launchPadPrompt,
     optimizeResumePrompt,
     reviewMatchesPrompt,
     uploadResumePrompt,
+    autoJobSearchPrompt,
 ];
 // Generate prompt messages
 export function getPromptMessages(name, args) {
@@ -94,6 +116,71 @@ export function getPromptMessages(name, args) {
                         }
                     }]
             };
+        case "auto_job_search":
+            const site = args.site || "linkedin";
+            const searchQuery = args.query || "";
+            const location = args.location || "Remote";
+            return {
+                messages: [{
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `# Automated Job Search Session
+
+You are my job search assistant. Using browser control (Claude for Chrome) and the JobSeek MCP tools, help me find and apply to jobs.
+
+## Your Workflow:
+
+### Phase 1: Preparation
+1. First, use the \`my_profile\` tool to understand my background, skills, and experience
+2. Use the \`get_form_data\` tool to have my application data ready for form filling
+
+### Phase 2: Search
+3. Navigate to ${site === 'all' ? 'LinkedIn first, then Indeed' : site} job search
+4. Search for: ${searchQuery ? `"${searchQuery}"` : 'roles matching my most recent job title from my profile'}
+5. Filter by location: ${location}
+6. Filter for jobs posted in the last week if possible
+
+### Phase 3: Evaluate & Present
+For each promising job listing:
+7. Click to view the full job description
+8. Read the job details (title, company, requirements, salary if shown)
+9. Use the \`evaluate_job\` tool to score the match against my profile
+10. If match score is 65% or higher, present it to me with:
+    - Job title and company
+    - Match score and key strengths
+    - Any concerns or gaps
+    - Ask: "Would you like me to apply to this role?"
+
+### Phase 4: Apply (if I approve)
+If I say yes to applying:
+11. Look for "Apply" or "Easy Apply" button
+12. Click to start the application
+13. Use \`get_form_data\` to fill in form fields:
+    - Name, email, phone → from my profile
+    - Work history → from my experience
+    - Education → from my education
+    - For text questions, draft thoughtful responses based on my profile
+14. Before final submission, show me a summary and ask for confirmation
+15. If I confirm, submit. If not, make any edits I request.
+
+### Phase 5: Track
+16. After each application (or skip), move to the next job listing
+17. Keep a running count: "Applied: X, Skipped: Y, Remaining to review: Z"
+
+## Important Rules:
+- ALWAYS ask before submitting an application
+- ALWAYS show me what you're about to submit
+- If you encounter a CAPTCHA or login wall, pause and ask for help
+- If an application requires a resume upload, let me know
+- Skip jobs requiring skills I clearly don't have (score < 50%)
+- Take your time - accuracy is more important than speed
+
+## Ready?
+Let's start! First, fetch my profile, then navigate to the job site.`
+                        }
+                    }]
+            };
         default:
             throw new Error(`Unknown prompt: ${name}`);
     }

package/dist/resources.d.ts

@@ -4,6 +4,12 @@ export declare const resumeResource: {
     description: string;
     mimeType: string;
 };
+export declare const resumeTextResource: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+};
 export declare const applicationsResource: {
     uri: string;
     name: string;

package/dist/resources.js

@@ -5,10 +5,16 @@ const getApiKey = () => process.env.JOBSEEK_API_KEY;
 // Resource definitions
 export const resumeResource = {
     uri: "jobseek://resume",
-    name: "Current Resume",
-    description: "Your resume data stored in JobSeek including skills, experience, education, and summary",
+    name: "Current Resume (JSON)",
+    description: "Your resume data stored in JobSeek as structured JSON including skills, experience, education, and summary",
     mimeType: "application/json"
 };
+export const resumeTextResource = {
+    uri: "jobseek://resume/text",
+    name: "Current Resume (Text)",
+    description: "Your resume formatted as readable plain text - use this to understand the user's background",
+    mimeType: "text/plain"
+};
 export const applicationsResource = {
     uri: "jobseek://applications",
     name: "Job Applications",
@@ -18,6 +24,7 @@ export const applicationsResource = {
 // All resources
 export const allResources = [
     resumeResource,
+    resumeTextResource,
     applicationsResource,
 ];
 // Fetch resume data
@@ -62,6 +69,91 @@ async function fetchResume() {
         }, null, 2);
     }
 }
+// Format resume data as readable text
+function formatResumeAsText(resume) {
+    let text = '';
+    // Header
+    text += `# ${resume.name || 'Resume'}\n`;
+    if (resume.email)
+        text += `Email: ${resume.email}\n`;
+    if (resume.linkedinUrl)
+        text += `LinkedIn: ${resume.linkedinUrl}\n`;
+    text += '\n';
+    // Summary
+    if (resume.summary) {
+        text += `## Professional Summary\n${resume.summary}\n\n`;
+    }
+    // Skills
+    if (resume.skills && resume.skills.length > 0) {
+        text += `## Skills\n`;
+        text += resume.skills.map((skill) => `• ${skill}`).join('\n');
+        text += '\n\n';
+    }
+    // Experience
+    if (resume.experience && resume.experience.length > 0) {
+        text += `## Work Experience\n`;
+        for (const exp of resume.experience) {
+            text += `### ${exp.title || 'Position'} at ${exp.company || 'Company'}\n`;
+            if (exp.location)
+                text += `Location: ${exp.location}\n`;
+            if (exp.startDate || exp.endDate || exp.duration) {
+                const duration = exp.duration || `${exp.startDate || ''} - ${exp.endDate || 'Present'}`;
+                text += `Duration: ${duration}\n`;
+            }
+            if (exp.description)
+                text += `\n${exp.description}\n`;
+            if (exp.bullets && exp.bullets.length > 0) {
+                text += exp.bullets.map((b) => `• ${b}`).join('\n') + '\n';
+            }
+            text += '\n';
+        }
+    }
+    // Education
+    if (resume.education && resume.education.length > 0) {
+        text += `## Education\n`;
+        for (const edu of resume.education) {
+            text += `### ${edu.degree || 'Degree'}`;
+            if (edu.field)
+                text += ` in ${edu.field}`;
+            text += '\n';
+            if (edu.institution || edu.school)
+                text += `Institution: ${edu.institution || edu.school}\n`;
+            if (edu.year || edu.graduationDate)
+                text += `Year: ${edu.year || edu.graduationDate}\n`;
+            text += '\n';
+        }
+    }
+    return text;
+}
+// Fetch resume as formatted text
+async function fetchResumeText() {
+    const apiKey = getApiKey();
+    const apiUrl = getApiUrl();
+    if (!apiKey) {
+        return "Error: No API key configured. Get your API key at " + apiUrl + "/dashboard/api-keys";
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/resumes/current`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return "Error: Invalid API key. Generate a new key at " + apiUrl + "/dashboard/api-keys";
+            }
+            if (response.status === 404) {
+                return "Error: No resume found. Upload a resume first using the upload_resume tool.";
+            }
+            return `Error: Failed to fetch resume (status ${response.status})`;
+        }
+        const data = await response.json();
+        return formatResumeAsText(data);
+    }
+    catch (error) {
+        return `Error: Network error - ${error.message}`;
+    }
+}
 // Fetch applications data
 async function fetchApplications() {
     const apiKey = getApiKey();
@@ -108,6 +200,14 @@ export async function handleReadResource(uri) {
                         text: await fetchResume()
                     }]
             };
+        case "jobseek://resume/text":
+            return {
+                contents: [{
+                        uri,
+                        mimeType: "text/plain",
+                        text: await fetchResumeText()
+                    }]
+            };
         case "jobseek://applications":
             return {
                 contents: [{

package/dist/server.d.ts

@@ -0,0 +1,20 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+export declare function createServer(apiKey: string): Server<{
+    method: string;
+    params?: import("zod").objectOutputType<{
+        _meta: import("zod").ZodOptional<import("zod").ZodObject<{
+            progressToken: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
+        }, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{
+            progressToken: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
+        }, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{
+            progressToken: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodString, import("zod").ZodNumber]>>;
+        }, import("zod").ZodTypeAny, "passthrough">>>;
+    }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+}, {
+    method: string;
+    params?: import("zod").objectOutputType<{
+        _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
+    }, import("zod").ZodTypeAny, "passthrough"> | undefined;
+}, import("zod").objectOutputType<{
+    _meta: import("zod").ZodOptional<import("zod").ZodObject<{}, "passthrough", import("zod").ZodTypeAny, import("zod").objectOutputType<{}, import("zod").ZodTypeAny, "passthrough">, import("zod").objectInputType<{}, import("zod").ZodTypeAny, "passthrough">>>;
+}, import("zod").ZodTypeAny, "passthrough">>;