techprufer-mcp 0.1.0 → 0.1.5

package/README.md

@@ -1,8 +1,12 @@
 # techprufer-mcp
 
-Local Agent (MCP) for [TechPrufer](https://techprufer.com) — tailor resumes from your AI tool using your own subscription. No Gemini API key required.
+TechPrufer MCP — tailor resumes and build profiles from your AI tool.
 
-## Install (any MCP host)
+Uses the same TechPrufer cube mark as the site and Chrome extension (shown in MCP clients that support server icons).
+
+## Install
+
+Server key **must** be `techprufer` so slash commands are `/techprufer/…`:
 
 ```json
 {
@@ -15,26 +19,23 @@ Local Agent (MCP) for [TechPrufer](https://techprufer.com) — tailor resumes fr
 }
 ```
 
-## Login (once)
+## Login
 
 ```bash
 npx techprufer-mcp login
 ```
 
-Opens TechPrufer in your browser. Approve the device code. Credentials are stored at `~/.techprufer/credentials.json`.
-
-## Use
+## Slash commands
 
-1. On techprufer.com, start a tailor with **Local Agent (MCP)**.
-2. In your AI tool, run the `/tailor` prompt (or ask: "process my pending TechPrufer tailor jobs").
-3. The agent pulls jobs one at a time, generates the tailored JSON with its own model, and saves it back after server-side validation.
+Type `/techprufer` in your AI tool to list:
 
-## Tools
+| Command | Use |
+|---------|-----|
+| `/techprufer/tailor` | Process queued tailor jobs from the site |
+| `/techprufer/build-profile` | Process queued PDF→profile jobs, or build from a local resume |
 
-- `list_pending_tailor_jobs`
-- `get_tailor_job` — claim + exact prompt payload
-- `submit_tailor_result` — validate + store (retries with corrective feedback)
+> Cursor may show `/user-techprufer/…` for user-scoped installs; same commands.
 
 ## Env
 
-- `TECHPRUFER_API_URL` — override API base (default `https://techprufer.com`)
+- `TECHPRUFER_API_URL` — API base (default `https://techprufer.com`)

package/dist/brand.d.ts

@@ -0,0 +1,6 @@
+/** TechPrufer cube mark (same asset as the Chrome extension / site brand). */
+export declare function brandIcons(): {
+    src: string;
+    mimeType: string;
+    sizes: string[];
+}[];

package/dist/brand.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const PACKAGE_ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
+/** TechPrufer cube mark (same asset as the Chrome extension / site brand). */
+export function brandIcons() {
+    const png128 = readFileSync(join(PACKAGE_ROOT, 'assets/logo.png'));
+    const png48 = readFileSync(join(PACKAGE_ROOT, 'assets/logo-48.png'));
+    return [
+        {
+            src: `data:image/png;base64,${png128.toString('base64')}`,
+            mimeType: 'image/png',
+            sizes: ['128x128'],
+        },
+        {
+            src: `data:image/png;base64,${png48.toString('base64')}`,
+            mimeType: 'image/png',
+            sizes: ['48x48'],
+        },
+    ];
+}

package/dist/cli.js

@@ -23,7 +23,7 @@ async function main() {
         return;
     }
     if (cmd === 'help' || cmd === '--help' || cmd === '-h') {
-        console.error(`techprufer-mcp — TechPrufer Local Agent (MCP)
+        console.error(`techprufer-mcp — TechPrufer MCP
 
 Usage:
   npx techprufer-mcp              Start stdio MCP server (for AI tools)

package/dist/login.js

@@ -15,20 +15,34 @@ function openBrowser(url) {
 function sleep(ms) {
     return new Promise((r) => setTimeout(r, ms));
 }
+/** Keep verify URL on the same host as TECHPRUFER_API_URL (local vs prod). */
+function alignVerifyUrl(verifyUrl, apiUrl) {
+    try {
+        const verify = new URL(verifyUrl);
+        const api = new URL(apiUrl);
+        verify.protocol = api.protocol;
+        verify.host = api.host;
+        return verify.toString();
+    }
+    catch {
+        return verifyUrl;
+    }
+}
 export async function runLogin(deviceName) {
     const apiUrl = getApiUrl();
-    console.error(`TechPrufer Local Agent — logging in against ${apiUrl}`);
+    console.error(`TechPrufer MCP — logging in against ${apiUrl}`);
     const start = await apiFetch('/api/agent/device/start', {
         method: 'POST',
         token: null,
         body: JSON.stringify({ deviceName: deviceName || undefined }),
     });
+    const verifyUrl = alignVerifyUrl(start.verifyUrl, apiUrl);
     console.error('');
     console.error(`  Code:  ${start.userCode}`);
-    console.error(`  Open:  ${start.verifyUrl}`);
+    console.error(`  Open:  ${verifyUrl}`);
     console.error('');
     console.error('Waiting for approval in the browser…');
-    openBrowser(start.verifyUrl);
+    openBrowser(verifyUrl);
     const intervalMs = Math.max(3, start.interval || 5) * 1000;
     const deadline = Date.now() + start.expiresIn * 1000;
     while (Date.now() < deadline) {

package/dist/server.js

@@ -2,6 +2,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { apiFetch, ApiError } from './api.js';
+import { brandIcons } from './brand.js';
 import { loadCredentials, credentialsFilePath } from './config.js';
 import { runLogin } from './login.js';
 function textResult(text, isError = false) {
@@ -19,9 +20,13 @@ async function ensureToken() {
 export function createServer() {
     const server = new McpServer({
         name: 'techprufer',
-        version: '0.1.0',
+        title: 'TechPrufer',
+        version: '0.1.5',
+        description: 'Tailor resumes and build profiles with your AI tool — no Gemini API key.',
+        websiteUrl: 'https://techprufer.com',
+        icons: brandIcons(),
     });
-    server.tool('list_pending_tailor_jobs', 'List TechPrufer tailor jobs queued for Local Agent (MCP). Returns id, company, role, status.', {}, async () => {
+    server.tool('list_pending_tailor_jobs', 'List TechPrufer tailor jobs queued for MCP. Returns id, company, role, status.', {}, async () => {
         const token = await ensureToken();
         if (!token)
             return textResult(requireAuthMessage(), true);
@@ -93,7 +98,8 @@ export function createServer() {
             return textResult(`Submit failed: ${msg}`, true);
         }
     });
-    server.prompt('tailor', 'Process pending TechPrufer Local Agent tailor jobs one at a time.', {
+    // Slash path in Cursor: /techprufer/tailor (user installs may show /user-techprufer/tailor)
+    server.prompt('tailor', 'TechPrufer — tailor a queued resume job', {
         jobId: z
             .string()
             .optional()
@@ -105,7 +111,7 @@ export function createServer() {
                 content: {
                     type: 'text',
                     text: [
-                        'Process TechPrufer Local Agent (MCP) tailor jobs.',
+                        'Process TechPrufer MCP tailor jobs.',
                         jobId
                             ? `Focus on jobId=${jobId}.`
                             : 'Fetch pending jobs and process them ONE AT A TIME in order.',
@@ -124,6 +130,147 @@ export function createServer() {
             },
         ],
     }));
+    server.tool('list_pending_profile_jobs', 'List TechPrufer profile-build jobs queued for MCP (from PDF upload on the site).', {}, async () => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const data = await apiFetch('/api/agent/profile-jobs');
+            return textResult(JSON.stringify(data.jobs ?? [], null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to list profile jobs: ${msg}`, true);
+        }
+    });
+    server.tool('get_profile_job', 'Claim a pending profile-build job and return the EXACT CPM parse prompt messages (same as Gemini parse). ' +
+        'Execute verbatim, then call submit_profile_job_result.', {
+        jobId: z
+            .string()
+            .optional()
+            .describe('Job id from list_pending_profile_jobs. If omitted, oldest QUEUED job.'),
+    }, async ({ jobId }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            let id = jobId;
+            if (!id) {
+                const list = await apiFetch('/api/agent/profile-jobs');
+                const first = list.jobs.find((j) => j.status === 'QUEUED') ??
+                    list.jobs.find((j) => j.status === 'CLAIMED');
+                if (!first)
+                    return textResult('No pending profile jobs.');
+                id = first.id;
+            }
+            const payload = await apiFetch(`/api/agent/profile-jobs/${encodeURIComponent(id)}/payload`);
+            return textResult(JSON.stringify(payload, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to get profile job: ${msg}`, true);
+        }
+    });
+    server.tool('submit_profile_job_result', 'Submit CPM profile JSON for a queued profile job. On 422, fix via correctiveMessage and resubmit.', {
+        jobId: z.string(),
+        profileJson: z.union([z.string(), z.record(z.unknown())]),
+        model: z.string().optional(),
+    }, async ({ jobId, profileJson, model }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const parsed = typeof profileJson === 'string' ? JSON.parse(profileJson) : profileJson;
+            const result = await apiFetch(`/api/agent/profile-jobs/${encodeURIComponent(jobId)}/result`, {
+                method: 'POST',
+                body: JSON.stringify({ profileJson: parsed, model }),
+            });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            if (e instanceof ApiError && e.status === 422) {
+                return textResult(JSON.stringify(e.body, null, 2), true);
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Submit failed: ${msg}`, true);
+        }
+    });
+    server.tool('get_profile_build_messages', 'For a local resume file: pass extracted resume text; returns the EXACT CPM parse messages (no queue). ' +
+        'Execute verbatim, then call submit_built_profile.', {
+        resumeText: z.string().describe('Full text of the resume (read from the local file)'),
+    }, async ({ resumeText }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const payload = await apiFetch('/api/agent/profiles/messages', {
+                method: 'POST',
+                body: JSON.stringify({ resumeText }),
+            });
+            return textResult(JSON.stringify(payload, null, 2));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Failed to get messages: ${msg}`, true);
+        }
+    });
+    server.tool('submit_built_profile', 'Create a TechPrufer master profile from CPM JSON built from a local resume (no queued job).', {
+        profileJson: z.union([z.string(), z.record(z.unknown())]),
+        name: z.string().optional().describe('Profile display name'),
+        isDefault: z.boolean().optional(),
+        model: z.string().optional(),
+    }, async ({ profileJson, name, isDefault, model }) => {
+        const token = await ensureToken();
+        if (!token)
+            return textResult(requireAuthMessage(), true);
+        try {
+            const parsed = typeof profileJson === 'string' ? JSON.parse(profileJson) : profileJson;
+            const result = await apiFetch('/api/agent/profiles', {
+                method: 'POST',
+                body: JSON.stringify({ profileJson: parsed, name, isDefault, model }),
+            });
+            return textResult(JSON.stringify(result, null, 2));
+        }
+        catch (e) {
+            if (e instanceof ApiError && e.status === 422) {
+                return textResult(JSON.stringify(e.body, null, 2), true);
+            }
+            const msg = e instanceof Error ? e.message : String(e);
+            return textResult(`Submit failed: ${msg}`, true);
+        }
+    });
+    // Slash path in Cursor: /techprufer/build-profile
+    server.prompt('build-profile', 'TechPrufer — build a profile from PDF job or local resume', {
+        jobId: z.string().optional().describe('Optional queued profile job id'),
+    }, async ({ jobId }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        'Build TechPrufer master profile(s) via MCP.',
+                        '',
+                        'Path A — queued PDF jobs from the site:',
+                        jobId
+                            ? `1. Call get_profile_job with jobId=${jobId}.`
+                            : '1. Call list_pending_profile_jobs; for each QUEUED/CLAIMED job call get_profile_job.',
+                        '2. Execute returned messages verbatim; output ONLY CPM profile JSON.',
+                        '3. Call submit_profile_job_result. On correctiveMessage, fix once and resubmit.',
+                        '',
+                        'Path B — local resume file (user selected / open in this tool):',
+                        '1. Read the resume file and extract full text.',
+                        '2. Call get_profile_build_messages with that resumeText.',
+                        '3. Execute messages verbatim; output ONLY CPM profile JSON.',
+                        '4. Call submit_built_profile (optional name from file / identity.name).',
+                        '',
+                        'Prefer Path A if pending jobs exist; otherwise Path B when a local resume is available.',
+                        'Zero hallucination. Complete JSON only. Faithful extraction, not rewriting.',
+                    ].join('\n'),
+                },
+            },
+        ],
+    }));
     return server;
 }
 export async function startStdioServer() {

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "techprufer-mcp",
-  "version": "0.1.0",
-  "description": "TechPrufer Local Agent (MCP) — tailor resumes from your AI tool without a Gemini API key",
+  "version": "0.1.5",
+  "description": "TechPrufer MCP — tailor resumes and build profiles from your AI tool",
+  "homepage": "https://techprufer.com",
   "type": "module",
   "bin": {
     "techprufer-mcp": "dist/cli.js"
   },
   "files": [
     "dist",
+    "assets",
     "README.md"
   ],
   "engines": {