jobseek-mcp 0.2.0 → 0.4.0

package/README.md

@@ -51,6 +51,18 @@ After saving the config, restart Claude Code. Type `/mcp` to verify the server i
 
 ## Available Tools
 
+### `upload_resume`
+Upload a PDF resume to JobSeek.
+
+**Example prompts:**
+- "Upload my resume from ~/Documents/resume.pdf"
+- "Upload /Users/me/Downloads/Resume_2025.pdf to JobSeek"
+
+**What it does:**
+- Reads PDF from your local filesystem
+- Extracts text and parses with AI
+- Stores the parsed resume in JobSeek
+
 ### `optimize_resume`
 Optimize your resume for ATS (Applicant Tracking Systems).
 

package/dist/index.js

@@ -5,13 +5,15 @@ import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSche
 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";
 // 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.2.0",
+    version: "0.4.0",
 }, {
     capabilities: {
         tools: {},
@@ -25,6 +27,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             optimizeResumeTool,
             downloadResumePdfTool,
             uploadResumeTool,
+            launchPadTool,
         ],
     };
 });
@@ -38,6 +41,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             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}`);
     }
@@ -45,15 +50,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 // List available resources
 server.setRequestHandler(ListResourcesRequestSchema, async () => {
     return {
-        resources: [
-        // Resources will be added here (resume, applications, etc.)
-        ],
+        resources: allResources,
     };
 });
 // Handle resource reads
 server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const { uri } = request.params;
-    throw new Error(`Unknown resource: ${uri}`);
+    return handleReadResource(uri);
 });
 // Start the server
 async function main() {

package/dist/resources.d.ts

@@ -0,0 +1,25 @@
+export declare const resumeResource: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+};
+export declare const applicationsResource: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+};
+export declare const allResources: {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];
+export declare function handleReadResource(uri: string): Promise<{
+    contents: Array<{
+        uri: string;
+        mimeType: string;
+        text: string;
+    }>;
+}>;

package/dist/resources.js

@@ -0,0 +1,122 @@
+// Resource definitions and handlers for MCP
+// Configuration
+const getApiUrl = () => process.env.JOBSEEK_API_URL || "https://getjobseek.com";
+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",
+    mimeType: "application/json"
+};
+export const applicationsResource = {
+    uri: "jobseek://applications",
+    name: "Job Applications",
+    description: "Your tracked job applications with status, company, and match scores",
+    mimeType: "application/json"
+};
+// All resources
+export const allResources = [
+    resumeResource,
+    applicationsResource,
+];
+// Fetch resume data
+async function fetchResume() {
+    const apiKey = getApiKey();
+    const apiUrl = getApiUrl();
+    if (!apiKey) {
+        return JSON.stringify({
+            error: "No API key configured",
+            help: "Get your API key at " + apiUrl + "/dashboard/api-keys"
+        }, null, 2);
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/resumes/current`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return JSON.stringify({
+                    error: "Invalid API key",
+                    help: "Generate a new key at " + apiUrl + "/dashboard/api-keys"
+                }, null, 2);
+            }
+            if (response.status === 404) {
+                return JSON.stringify({
+                    error: "No resume found",
+                    help: "Upload a resume first using the upload_resume tool"
+                }, null, 2);
+            }
+            return JSON.stringify({
+                error: `Failed to fetch resume: ${response.status}`
+            }, null, 2);
+        }
+        const data = await response.json();
+        return JSON.stringify(data, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({
+            error: `Network error: ${error.message}`
+        }, null, 2);
+    }
+}
+// Fetch applications data
+async function fetchApplications() {
+    const apiKey = getApiKey();
+    const apiUrl = getApiUrl();
+    if (!apiKey) {
+        return JSON.stringify({
+            error: "No API key configured",
+            help: "Get your API key at " + apiUrl + "/dashboard/api-keys"
+        }, null, 2);
+    }
+    try {
+        const response = await fetch(`${apiUrl}/api/applications`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return JSON.stringify({
+                    error: "Invalid API key"
+                }, null, 2);
+            }
+            return JSON.stringify({
+                error: `Failed to fetch applications: ${response.status}`
+            }, null, 2);
+        }
+        const data = await response.json();
+        return JSON.stringify(data, null, 2);
+    }
+    catch (error) {
+        return JSON.stringify({
+            error: `Network error: ${error.message}`
+        }, null, 2);
+    }
+}
+// Handle resource reads
+export async function handleReadResource(uri) {
+    switch (uri) {
+        case "jobseek://resume":
+            return {
+                contents: [{
+                        uri,
+                        mimeType: "application/json",
+                        text: await fetchResume()
+                    }]
+            };
+        case "jobseek://applications":
+            return {
+                contents: [{
+                        uri,
+                        mimeType: "application/json",
+                        text: await fetchApplications()
+                    }]
+            };
+        default:
+            throw new Error(`Unknown resource: ${uri}`);
+    }
+}

package/dist/tools/launch-pad.d.ts

@@ -0,0 +1,20 @@
+export declare const launchPadTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            query: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handleLaunchPad(args: unknown, apiUrl: string, apiKey?: string): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;

package/dist/tools/launch-pad.js

@@ -0,0 +1,109 @@
+import { z } from "zod";
+import { exec } from "child_process";
+import { promisify } from "util";
+const execAsync = promisify(exec);
+// Tool definition
+export const launchPadTool = {
+    name: "launch_pad",
+    description: "Open job search tabs across major job boards (LinkedIn, Indeed, Glassdoor, ZipRecruiter, Wellfound, Dice). Uses your resume to determine the search query, or you can provide a custom query.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Optional custom search query. If not provided, uses your most recent job title from your resume."
+            }
+        },
+        required: []
+    }
+};
+// Input validation
+const LaunchPadInput = z.object({
+    query: z.string().optional()
+});
+// Tool handler
+export async function handleLaunchPad(args, apiUrl, apiKey) {
+    const input = LaunchPadInput.parse(args);
+    if (!apiKey) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **API Key Required**\n\nGet your API key at: ${apiUrl}/dashboard/api-keys`
+                }]
+        };
+    }
+    try {
+        // Fetch launchpad links from API
+        const queryParam = input.query ? `?query=${encodeURIComponent(input.query)}` : '';
+        const response = await fetch(`${apiUrl}/api/launchpad${queryParam}`, {
+            headers: {
+                "Authorization": `Bearer ${apiKey}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `❌ **Invalid API Key**\n\nGenerate a new key at: ${apiUrl}/dashboard/api-keys`
+                        }]
+                };
+            }
+            const error = await response.json().catch(() => ({}));
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Error**\n\n${error.error || 'Failed to get launchpad links'}`
+                    }]
+            };
+        }
+        const data = await response.json();
+        const { searchQuery, links } = data;
+        // Open each URL in the default browser
+        const opened = [];
+        for (const link of links) {
+            try {
+                // Works on macOS. For cross-platform: use 'start' on Windows, 'xdg-open' on Linux
+                await execAsync(`open "${link.url}"`);
+                opened.push(link.name);
+            }
+            catch (err) {
+                console.error(`Failed to open ${link.name}:`, err);
+            }
+        }
+        if (opened.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `❌ **Failed to open tabs**\n\nCould not open browser tabs. You may need to open them manually.`
+                    }]
+            };
+        }
+        return {
+            content: [{
+                    type: "text",
+                    text: `🚀 **Launch Pad Activated!**
+
+**Search Query:** ${searchQuery}
+
+**Opened ${opened.length} job boards:**
+${opened.map(name => `- ${name}`).join('\n')}
+
+---
+
+**Next steps:**
+1. Browse the job listings
+2. When you find interesting jobs, click the JobSeek extension to analyze them
+3. Return here to discuss your matches: "What are my top matches from today?"`
+                }]
+        };
+    }
+    catch (error) {
+        return {
+            content: [{
+                    type: "text",
+                    text: `❌ **Error**\n\nFailed to launch job boards: ${error.message}`
+                }]
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "jobseek-mcp",
-    "version": "0.2.0",
+    "version": "0.4.0",
     "description": "JobSeek MCP Server - AI-powered job search automation for Claude Code",
     "author": "Shawn Mitchell",
     "license": "MIT",