jobseek-mcp 0.3.0 → 0.5.0

package/dist/index.js

@@ -1,22 +1,25 @@
 #!/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, } from "@modelcontextprotocol/sdk/types.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.3.0",
+    version: "0.5.0",
 }, {
     capabilities: {
         tools: {},
         resources: {},
+        prompts: {},
     },
 });
 // List available tools
@@ -26,6 +29,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             optimizeResumeTool,
             downloadResumePdfTool,
             uploadResumeTool,
+            launchPadTool,
         ],
     };
 });
@@ -39,6 +43,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}`);
     }
@@ -54,6 +60,17 @@ 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
 async function main() {
     const transport = new StdioServerTransport();

package/dist/prompts.d.ts

@@ -0,0 +1,50 @@
+export declare const launchPadPrompt: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+};
+export declare const optimizeResumePrompt: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+};
+export declare const reviewMatchesPrompt: {
+    name: string;
+    description: string;
+    arguments: never[];
+};
+export declare const uploadResumePrompt: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+};
+export declare const allPrompts: {
+    name: string;
+    description: string;
+    arguments: {
+        name: string;
+        description: string;
+        required: boolean;
+    }[];
+}[];
+export declare function getPromptMessages(name: string, args: Record<string, string>): {
+    messages: Array<{
+        role: string;
+        content: {
+            type: string;
+            text: string;
+        };
+    }>;
+};

package/dist/prompts.js

@@ -0,0 +1,100 @@
+// MCP Prompts - Slash commands for common workflows
+// Prompt definitions
+export const launchPadPrompt = {
+    name: "launch_pad",
+    description: "Open job boards for your job search. Uses your resume to determine search terms.",
+    arguments: [
+        {
+            name: "query",
+            description: "Optional: custom search query to override resume-based search",
+            required: false
+        }
+    ]
+};
+export const optimizeResumePrompt = {
+    name: "optimize_resume",
+    description: "Optimize your resume for ATS (Applicant Tracking Systems).",
+    arguments: [
+        {
+            name: "feedback",
+            description: "Optional: specific feedback or areas to focus on",
+            required: false
+        }
+    ]
+};
+export const reviewMatchesPrompt = {
+    name: "review_matches",
+    description: "Review and discuss your recent job matches from the Chrome extension.",
+    arguments: []
+};
+export const uploadResumePrompt = {
+    name: "upload_resume",
+    description: "Upload a PDF resume to JobSeek.",
+    arguments: [
+        {
+            name: "path",
+            description: "Path to the PDF file (e.g., ~/Downloads/resume.pdf)",
+            required: true
+        }
+    ]
+};
+// All prompts
+export const allPrompts = [
+    launchPadPrompt,
+    optimizeResumePrompt,
+    reviewMatchesPrompt,
+    uploadResumePrompt,
+];
+// Generate prompt messages
+export function getPromptMessages(name, args) {
+    switch (name) {
+        case "launch_pad":
+            const query = args.query ? ` for "${args.query}"` : "";
+            return {
+                messages: [{
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Open the job search launch pad${query}. Use the launch_pad tool to open job boards (LinkedIn, Indeed, Glassdoor, etc.) in my browser.`
+                        }
+                    }]
+            };
+        case "optimize_resume":
+            const feedback = args.feedback ? `\n\nFocus on: ${args.feedback}` : "";
+            return {
+                messages: [{
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Optimize my resume for ATS. Use the optimize_resume tool to enhance my resume for applicant tracking systems.${feedback}`
+                        }
+                    }]
+            };
+        case "review_matches":
+            return {
+                messages: [{
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Review my recent job matches. Read my applications from JobSeek (jobseek://applications resource) and help me understand:
+1. Which jobs are the best matches?
+2. What are my key strengths for these roles?
+3. What gaps should I address?
+4. Which should I prioritize applying to?`
+                        }
+                    }]
+            };
+        case "upload_resume":
+            return {
+                messages: [{
+                        role: "user",
+                        content: {
+                            type: "text",
+                            text: `Upload my resume from ${args.path} to JobSeek using the upload_resume tool.`
+                        }
+                    }]
+            };
+        default:
+            throw new Error(`Unknown prompt: ${name}`);
+    }
+}

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.3.0",
+    "version": "0.5.0",
     "description": "JobSeek MCP Server - AI-powered job search automation for Claude Code",
     "author": "Shawn Mitchell",
     "license": "MIT",