llmconveyors-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LLM Conveyors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,232 @@
+# llmconveyors-mcp
+
+[![npm version](https://img.shields.io/npm/v/llmconveyors-mcp.svg)](https://www.npmjs.com/package/llmconveyors-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+
+MCP server that connects AI agents to the [LLM Conveyors](https://llmconveyors.com) platform — run Job Hunter, B2B Sales, and other AI agents directly from Claude, Cursor, or any MCP-compatible client.
+
+<p align="center">
+  <img src="https://llmconveyors.com/assets/logo.png" alt="LLM Conveyors" width="200" />
+</p>
+
+## What is LLM Conveyors?
+
+A community-driven AI agent platform with pay-per-action pricing ($1–5 per completed action). Instead of $100/mo SaaS subscriptions, you pay only for real outputs — a resume scored, a company researched, a cold email generated.
+
+**Live Agents:**
+- **Job Hunter** — Tailored CVs, cover letters, and cold emails for job applications
+- **B2B Sales** — Deep company research and personalized sales outreach
+
+## Quick Start
+
+### 1. Get an API key
+
+Sign up at [llmconveyors.com](https://llmconveyors.com) and create an API key from Settings → API Keys.
+
+### 2. Add to your MCP client
+
+<details>
+<summary><strong>Claude Desktop</strong></summary>
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "llmconveyors": {
+      "command": "npx",
+      "args": ["-y", "llmconveyors-mcp"],
+      "env": {
+        "LLMC_API_KEY": "llmc_your_key_here"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Claude Code</strong></summary>
+
+```bash
+claude mcp add llmconveyors -- npx -y llmconveyors-mcp
+```
+
+Set the env var in your shell or `.env`:
+```bash
+export LLMC_API_KEY=llmc_your_key_here
+```
+</details>
+
+<details>
+<summary><strong>Cursor</strong></summary>
+
+Add to `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "llmconveyors": {
+      "command": "npx",
+      "args": ["-y", "llmconveyors-mcp"],
+      "env": {
+        "LLMC_API_KEY": "llmc_your_key_here"
+      }
+    }
+  }
+}
+```
+</details>
+
+<details>
+<summary><strong>Windsurf</strong></summary>
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "llmconveyors": {
+      "command": "npx",
+      "args": ["-y", "llmconveyors-mcp"],
+      "env": {
+        "LLMC_API_KEY": "llmc_your_key_here"
+      }
+    }
+  }
+}
+```
+</details>
+
+### 3. Start using it
+
+Ask your AI agent:
+
+> "Run the Job Hunter agent for the Senior Engineer role at Anthropic. Here's the job description: ..."
+
+> "Score my resume against this job posting for ATS compatibility."
+
+> "Research Stripe and draft a B2B cold email for our developer tools product."
+
+## Available Tools (39)
+
+### Agents
+| Tool | Description |
+|------|-------------|
+| `job-hunter-run` | Run the Job Hunter agent — generates tailored CV, cover letter, and cold email |
+| `b2b-sales-run` | Run the B2B Sales agent — researches a company and generates sales outreach |
+| `agent-status` | Check the status of a running agent job |
+| `agent-manifest` | Get input fields, capabilities, and billing info for an agent |
+
+### Resume
+| Tool | Description |
+|------|-------------|
+| `resume-validate` | Validate a resume in JSON Resume format |
+| `resume-render` | Render a resume to PDF |
+| `resume-preview` | Preview a resume as HTML |
+| `resume-themes` | List available resume themes |
+| `resume-import-rx` | Import from Reactive Resume format |
+| `resume-export-rx` | Export to Reactive Resume format |
+
+### Master Resumes
+| Tool | Description |
+|------|-------------|
+| `master-resume-create` | Create a new master resume |
+| `master-resume-list` | List all master resumes |
+| `master-resume-get` | Get a master resume by ID |
+| `master-resume-update` | Update a master resume |
+| `master-resume-delete` | Delete a master resume |
+
+### Upload & Parse
+| Tool | Description |
+|------|-------------|
+| `upload-resume` | Upload and parse a resume file (base64) |
+| `upload-job-file` | Upload and parse a job description file (base64) |
+| `upload-job-text` | Parse a job description from plain text |
+
+### ATS Scoring
+| Tool | Description |
+|------|-------------|
+| `ats-score` | Score a resume against a job description for ATS compatibility |
+
+### Sessions
+| Tool | Description |
+|------|-------------|
+| `session-create` | Create a new session |
+| `session-list` | List sessions with optional filtering |
+| `session-get` | Get a session by ID |
+| `session-hydrate` | Get full session with artifacts and logs |
+| `session-delete` | Delete a session |
+
+### Settings & API Keys
+| Tool | Description |
+|------|-------------|
+| `settings-profile` | Get user profile (credits, plan) |
+| `settings-preferences-get` | Get user preferences |
+| `settings-preferences-update` | Update user preferences |
+| `settings-usage-summary` | Get usage summary |
+| `settings-usage-logs` | Get paginated usage logs |
+| `api-key-create` | Create a new API key |
+| `api-key-list` | List all API keys |
+| `api-key-revoke` | Revoke an API key |
+| `api-key-rotate` | Rotate an API key |
+
+### Content & Sharing
+| Tool | Description |
+|------|-------------|
+| `content-save` | Save a source document for AI generation context |
+| `content-delete-generation` | Delete a generation and its artifacts |
+| `share-create` | Create a public share link for generated content |
+| `share-stats` | Get share link statistics |
+| `share-get-public` | Get a public share by slug |
+
+### Documents
+| Tool | Description |
+|------|-------------|
+| `document-download` | Download an artifact by storage path |
+
+## API Key Scopes
+
+Your API key needs the right scopes for the tools you want to use:
+
+| Scope | Tools |
+|-------|-------|
+| `jobs:read` | `agent-status`, `agent-manifest` |
+| `jobs:write` | `job-hunter-run` |
+| `sales:write` | `b2b-sales-run` |
+| `sessions:read` | `session-list`, `session-get`, `session-hydrate` |
+| `sessions:write` | `session-create`, `session-delete` |
+| `resume:read` | `resume-themes`, `master-resume-list`, `master-resume-get` |
+| `resume:write` | `resume-validate`, `resume-render`, `resume-preview`, `resume-import-rx`, `resume-export-rx`, `master-resume-create`, `master-resume-update`, `master-resume-delete` |
+| `upload:write` | `upload-resume`, `upload-job-file`, `upload-job-text` |
+| `ats:write` | `ats-score` |
+| `settings:read` | `settings-profile`, `settings-preferences-get`, `settings-usage-summary`, `settings-usage-logs`, `api-key-list` |
+| `settings:write` | `settings-preferences-update`, `api-key-create`, `api-key-revoke`, `api-key-rotate` |
+
+## Development
+
+```bash
+git clone https://github.com/llmconveyors/llmconveyors-mcp.git
+cd llmconveyors-mcp
+npm install
+npm run build
+
+# Test locally
+LLMC_API_KEY=llmc_your_key node dist/index.js
+```
+
+## Requirements
+
+- Node.js >= 18
+- An LLM Conveyors API key ([get one here](https://llmconveyors.com))
+
+## Links
+
+- [LLM Conveyors Platform](https://llmconveyors.com)
+- [API Documentation](https://llmconveyors.com/docs/api)
+- [TypeScript SDK](https://www.npmjs.com/package/llmconveyors)
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,808 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LLMConveyors } from "llmconveyors";
+
+// src/tools/agents.ts
+import { z } from "zod";
+function registerAgentTools(server2, client2) {
+  server2.tool(
+    "job-hunter-run",
+    "Run the Job Hunter agent \u2014 generates a tailored CV, cover letter, and cold email for a job application. Returns artifacts when complete.",
+    {
+      companyName: z.string().describe("Target company name"),
+      jobTitle: z.string().describe("Job title to apply for"),
+      jobDescription: z.string().describe("Full job description text"),
+      masterResumeId: z.string().optional().describe("ID of a stored master resume to use"),
+      theme: z.string().optional().describe("Resume theme (Even, StackOverflow, Class, Professional)"),
+      contactName: z.string().optional().describe("Hiring manager or recruiter name"),
+      contactEmail: z.string().optional().describe("Contact email for cold outreach"),
+      mode: z.enum(["standard", "cold_outreach"]).optional().describe("Generation mode")
+    },
+    async (params) => {
+      try {
+        const result = await client2.agents.run("job-hunter", {
+          companyName: params.companyName,
+          jobTitle: params.jobTitle,
+          jobDescription: params.jobDescription,
+          masterResumeId: params.masterResumeId,
+          theme: params.theme,
+          contactName: params.contactName,
+          contactEmail: params.contactEmail,
+          mode: params.mode
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "b2b-sales-run",
+    "Run the B2B Sales agent \u2014 researches a company and generates personalized sales outreach.",
+    {
+      companyName: z.string().describe("Target company name"),
+      companyWebsite: z.string().describe("Target company website URL"),
+      strategy: z.string().optional().describe("Sales strategy or approach")
+    },
+    async (params) => {
+      try {
+        const result = await client2.agents.run("b2b-sales", {
+          companyName: params.companyName,
+          companyWebsite: params.companyWebsite,
+          strategy: params.strategy
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "agent-status",
+    "Check the status of a running agent job.",
+    {
+      agentType: z.enum(["job-hunter", "b2b-sales"]).describe("Agent type"),
+      jobId: z.string().describe("Job ID returned from a generate call")
+    },
+    async (params) => {
+      try {
+        const result = await client2.agents.getStatus(params.agentType, params.jobId, {
+          include: ["logs", "artifacts"]
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "agent-manifest",
+    "Get the manifest (input fields, capabilities, billing) for an agent type.",
+    {
+      agentType: z.enum(["job-hunter", "b2b-sales"]).describe("Agent type")
+    },
+    async (params) => {
+      try {
+        const result = await client2.agents.getManifest(params.agentType);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/ats.ts
+import { z as z2 } from "zod";
+function registerAtsTools(server2, client2) {
+  server2.tool(
+    "ats-score",
+    "Score a resume against a job description for ATS compatibility. Returns overall score, grade, keyword matches, and improvement suggestions.",
+    {
+      resumeText: z2.string().describe("Resume as plain text"),
+      jobDescription: z2.string().describe("Job description as plain text")
+    },
+    async (params) => {
+      try {
+        const result = await client2.ats.score({
+          resumeText: params.resumeText,
+          jobDescription: params.jobDescription
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/resume.ts
+import { z as z3 } from "zod";
+function registerResumeTools(server2, client2) {
+  server2.tool(
+    "resume-validate",
+    "Validate a resume in JSON Resume format. Returns validation errors and warnings.",
+    {
+      resume: z3.record(z3.unknown()).describe("Resume object in JSON Resume format")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.validate({ resume: params.resume });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "resume-render",
+    "Render a resume to PDF. Returns a URL to download the generated PDF.",
+    {
+      resume: z3.record(z3.unknown()).describe("Resume object in JSON Resume format"),
+      theme: z3.string().optional().describe("Theme name (e.g. Even, StackOverflow, Class, Professional)"),
+      format: z3.string().optional().describe("Output format")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.render({
+          resume: params.resume,
+          theme: params.theme,
+          format: params.format
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "resume-preview",
+    "Preview a resume as HTML. Returns rendered HTML string.",
+    {
+      resume: z3.record(z3.unknown()).describe("Resume object in JSON Resume format"),
+      theme: z3.string().optional().describe("Theme name")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.preview({
+          resume: params.resume,
+          theme: params.theme
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "resume-themes",
+    "List all available resume themes. Returns theme IDs, names, and descriptions.",
+    {},
+    async () => {
+      try {
+        const result = await client2.resume.themes();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "resume-import-rx",
+    "Import a resume from Reactive Resume (RxResume) format into JSON Resume format.",
+    {
+      data: z3.record(z3.unknown()).describe("RxResume data object to import")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.importRxResume({ data: params.data });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "resume-export-rx",
+    "Export a JSON Resume to Reactive Resume (RxResume) format.",
+    {
+      resume: z3.record(z3.unknown()).describe("Resume object in JSON Resume format")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.exportRxResume({ resume: params.resume });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "master-resume-create",
+    "Create a new master resume. Returns the saved master resume with its ID.",
+    {
+      label: z3.string().describe("Label/name for this master resume"),
+      rawText: z3.string().describe("Raw resume text content"),
+      isDefault: z3.boolean().optional().describe("Set as default master resume")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.createMaster({
+          label: params.label,
+          rawText: params.rawText,
+          isDefault: params.isDefault
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "master-resume-list",
+    "List all master resumes. Returns an array of master resume objects.",
+    {},
+    async () => {
+      try {
+        const result = await client2.resume.listMasters();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "master-resume-get",
+    "Get a master resume by ID. Returns the full master resume object.",
+    {
+      id: z3.string().describe("Master resume ID")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.getMaster(params.id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "master-resume-update",
+    "Update a master resume by ID. Returns the updated master resume.",
+    {
+      id: z3.string().describe("Master resume ID"),
+      label: z3.string().optional().describe("Updated label/name"),
+      rawText: z3.string().optional().describe("Updated raw resume text"),
+      isDefault: z3.boolean().optional().describe("Set as default master resume")
+    },
+    async (params) => {
+      try {
+        const result = await client2.resume.updateMaster(params.id, {
+          label: params.label,
+          rawText: params.rawText,
+          isDefault: params.isDefault
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "master-resume-delete",
+    "Delete a master resume by ID.",
+    {
+      id: z3.string().describe("Master resume ID")
+    },
+    async (params) => {
+      try {
+        await client2.resume.deleteMaster(params.id);
+        return { content: [{ type: "text", text: JSON.stringify({ deleted: true, id: params.id }) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/upload.ts
+import { z as z4 } from "zod";
+function registerUploadTools(server2, client2) {
+  server2.tool(
+    "upload-resume",
+    "Upload and parse a resume file. Accepts base64-encoded file content. Returns parsed resume data.",
+    {
+      fileBase64: z4.string().describe("Base64-encoded file content (PDF, DOCX, etc.)"),
+      filename: z4.string().describe("Original filename with extension (e.g. resume.pdf)"),
+      contentType: z4.string().optional().describe("MIME type (e.g. application/pdf)")
+    },
+    async (params) => {
+      try {
+        const buffer = Buffer.from(params.fileBase64, "base64");
+        const result = await client2.upload.resume(buffer, {
+          filename: params.filename,
+          contentType: params.contentType
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "upload-job-file",
+    "Upload and parse a job description file. Accepts base64-encoded file content. Returns parsed job data.",
+    {
+      fileBase64: z4.string().describe("Base64-encoded file content (PDF, DOCX, etc.)"),
+      filename: z4.string().describe("Original filename with extension"),
+      contentType: z4.string().optional().describe("MIME type")
+    },
+    async (params) => {
+      try {
+        const buffer = Buffer.from(params.fileBase64, "base64");
+        const result = await client2.upload.jobFile(buffer, {
+          filename: params.filename,
+          contentType: params.contentType
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "upload-job-text",
+    "Upload a job description as plain text. Returns parsed job data.",
+    {
+      text: z4.string().describe("Job description text"),
+      source: z4.string().optional().describe("Source URL or identifier for the job posting")
+    },
+    async (params) => {
+      try {
+        const result = await client2.upload.jobText({
+          text: params.text,
+          source: params.source
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/sessions.ts
+import { z as z5 } from "zod";
+function registerSessionTools(server2, client2) {
+  server2.tool(
+    "session-create",
+    "Create a new session. Returns the created session object with its ID.",
+    {
+      metadata: z5.record(z5.unknown()).optional().describe("Optional session metadata (e.g. agentType, source)")
+    },
+    async (params) => {
+      try {
+        const result = await client2.sessions.create({
+          metadata: params.metadata
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "session-list",
+    "List sessions with optional filtering and pagination. Returns an array of session objects.",
+    {
+      page: z5.number().optional().describe("Page number for pagination"),
+      limit: z5.number().optional().describe("Number of sessions per page"),
+      agentType: z5.string().optional().describe("Filter by agent type")
+    },
+    async (params) => {
+      try {
+        const result = await client2.sessions.list({
+          page: params.page,
+          limit: params.limit,
+          agentType: params.agentType
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "session-get",
+    "Get a session by ID. Returns the session object with generation history.",
+    {
+      id: z5.string().describe("Session ID")
+    },
+    async (params) => {
+      try {
+        const result = await client2.sessions.get(params.id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "session-hydrate",
+    "Hydrate a session \u2014 returns the full session with all artifacts and logs.",
+    {
+      id: z5.string().describe("Session ID")
+    },
+    async (params) => {
+      try {
+        const result = await client2.sessions.hydrate(params.id);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "session-delete",
+    "Delete a session by ID.",
+    {
+      id: z5.string().describe("Session ID")
+    },
+    async (params) => {
+      try {
+        await client2.sessions.delete(params.id);
+        return { content: [{ type: "text", text: JSON.stringify({ deleted: true, id: params.id }) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/settings.ts
+import { z as z6 } from "zod";
+function registerSettingsTools(server2, client2) {
+  server2.tool(
+    "settings-profile",
+    "Get the current user's profile. Returns email, name, plan, and credit balance.",
+    {},
+    async () => {
+      try {
+        const result = await client2.settings.getProfile();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "settings-preferences-get",
+    "Get the current user's preferences.",
+    {},
+    async () => {
+      try {
+        const result = await client2.settings.getPreferences();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "settings-preferences-update",
+    "Update the current user's preferences. Returns the updated preferences.",
+    {
+      preferences: z6.record(z6.unknown()).describe("Preferences object to update")
+    },
+    async (params) => {
+      try {
+        const result = await client2.settings.updatePreferences({
+          preferences: params.preferences
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "settings-usage-summary",
+    "Get a summary of the user's API usage and credit consumption.",
+    {},
+    async () => {
+      try {
+        const result = await client2.settings.getUsageSummary();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "settings-usage-logs",
+    "Get paginated usage logs. Returns individual usage entries with action, credits, and timestamps.",
+    {
+      offset: z6.number().optional().describe("Offset for pagination"),
+      limit: z6.number().optional().describe("Number of entries to return")
+    },
+    async (params) => {
+      try {
+        const result = await client2.settings.getUsageLogs({
+          offset: params.offset,
+          limit: params.limit
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "api-key-create",
+    "Create a new platform API key. The key value is shown ONLY in this response \u2014 save it immediately.",
+    {
+      label: z6.string().describe("Human-readable label for the API key"),
+      scopes: z6.array(z6.enum([
+        "jobs:write",
+        "jobs:read",
+        "sales:write",
+        "sales:read",
+        "sessions:read",
+        "sessions:write",
+        "settings:read",
+        "settings:write",
+        "upload:write",
+        "resume:read",
+        "resume:write",
+        "ats:write",
+        "webhook:read",
+        "webhook:write"
+      ])).describe("Permission scopes for the key")
+    },
+    async (params) => {
+      try {
+        const result = await client2.settings.createApiKey({
+          label: params.label,
+          scopes: params.scopes
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "api-key-list",
+    "List all platform API keys. Returns key metadata (hash, name, scopes) \u2014 NOT the key values.",
+    {},
+    async () => {
+      try {
+        const result = await client2.settings.listApiKeys();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "api-key-revoke",
+    "Revoke (delete) a platform API key by its hash.",
+    {
+      hash: z6.string().describe("API key hash to revoke")
+    },
+    async (params) => {
+      try {
+        await client2.settings.revokeApiKey(params.hash);
+        return { content: [{ type: "text", text: JSON.stringify({ revoked: true, hash: params.hash }) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "api-key-rotate",
+    "Rotate a platform API key \u2014 revokes the old key and returns a new one. Save the new key immediately.",
+    {
+      hash: z6.string().describe("API key hash to rotate")
+    },
+    async (params) => {
+      try {
+        const result = await client2.settings.rotateApiKey(params.hash);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/content.ts
+import { z as z7 } from "zod";
+function registerContentTools(server2, client2) {
+  server2.tool(
+    "content-save",
+    "Save a source document for use as context in AI generation. Returns success status.",
+    {
+      docType: z7.enum([
+        "original_cv",
+        "extensive_cv",
+        "cover_letter",
+        "cv_strategy",
+        "cover_letter_strategy",
+        "cold_email_strategy",
+        "recon_strategy",
+        "company_context"
+      ]).describe("Type of source document"),
+      content: z7.string().describe("Document content text")
+    },
+    async (params) => {
+      try {
+        const result = await client2.content.save({
+          docType: params.docType,
+          content: params.content
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "content-delete-generation",
+    "Delete a generation and all its artifacts from a session.",
+    {
+      id: z7.string().describe("Generation ID to delete"),
+      sessionId: z7.string().describe("Session ID that owns the generation")
+    },
+    async (params) => {
+      try {
+        const httpClient = client2.content.httpClient;
+        const result = await httpClient.request(
+          `/content/generations/${encodeURIComponent(params.id)}`,
+          { method: "DELETE", query: { sessionId: params.sessionId } }
+        );
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/shares.ts
+import { z as z8 } from "zod";
+function registerSharesTools(server2, client2) {
+  server2.tool(
+    "share-create",
+    "Create a shareable public link for a generation's artifacts. Returns a slug and public URL.",
+    {
+      sessionId: z8.string().describe("Session ID containing the generation"),
+      generationId: z8.string().describe("Generation ID to share")
+    },
+    async (params) => {
+      try {
+        const result = await client2.shares.create({
+          sessionId: params.sessionId,
+          generationId: params.generationId
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "share-stats",
+    "Get statistics about your shared links (view counts, etc.).",
+    {},
+    async () => {
+      try {
+        const result = await client2.shares.getStats();
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+  server2.tool(
+    "share-get-public",
+    "Get a publicly shared resource by its slug.",
+    {
+      slug: z8.string().describe("Public share slug")
+    },
+    async (params) => {
+      try {
+        const result = await client2.shares.getPublic(params.slug);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/tools/documents.ts
+import { z as z9 } from "zod";
+function registerDocumentTools(server2, client2) {
+  server2.tool(
+    "document-download",
+    "Download a document by its storage path. Returns the file content or a download URL.",
+    {
+      path: z9.string().describe("Document storage path")
+    },
+    async (params) => {
+      try {
+        const response = await client2.documents.download(params.path);
+        const text = await response.text();
+        return { content: [{ type: "text", text }] };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { content: [{ type: "text", text: `Error: ${message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/index.ts
+var apiKey = process.env.LLMC_API_KEY;
+if (!apiKey) {
+  console.error("LLMC_API_KEY environment variable is required");
+  process.exit(1);
+}
+var client = new LLMConveyors({ apiKey });
+var server = new McpServer({
+  name: "llmconveyors",
+  version: "0.1.0"
+});
+registerAgentTools(server, client);
+registerAtsTools(server, client);
+registerResumeTools(server, client);
+registerUploadTools(server, client);
+registerSessionTools(server, client);
+registerSettingsTools(server, client);
+registerContentTools(server, client);
+registerSharesTools(server, client);
+registerDocumentTools(server, client);
+var transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "llmconveyors-mcp",
+  "version": "0.1.0",
+  "description": "MCP server that connects AI agents to LLM Conveyors — run Job Hunter, B2B Sales, and other AI agents from Claude, Cursor, or any MCP client",
+  "type": "module",
+  "bin": {
+    "llmconveyors-mcp": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "typecheck": "tsc --noEmit",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "llm-conveyors",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "job-hunting",
+    "resume",
+    "ats",
+    "b2b-sales",
+    "cold-email",
+    "ai-tools"
+  ],
+  "author": "LLM Conveyors <hello@llmconveyors.com> (https://llmconveyors.com)",
+  "license": "MIT",
+  "homepage": "https://github.com/llmconveyors/llmconveyors-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/llmconveyors/llmconveyors-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/llmconveyors/llmconveyors-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "llmconveyors": "^0.1.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  }
+}