@jobtarget/profiles-api-mcp 1.0.0

package/dist/tools/SearchProfiles.js

@@ -0,0 +1,109 @@
+import { MCPTool } from "mcp-framework";
+import { z } from "zod";
+import { apiClient, ProfilesApiError } from "../client/ProfilesApiClient.js";
+const WeightsSchema = z
+    .object({
+    w_text: z.number().optional().describe("Text relevance weight (default 0.60)"),
+    w_recency: z.number().optional().describe("Recency weight (default 0.03)"),
+    w_signal_data: z.number().optional().describe("Signal data weight (default 0.08)"),
+    w_contact: z.number().optional().describe("Contact info weight (default 0.05)"),
+    w_job_title: z.number().optional().describe("Job title weight (default 0.16)"),
+    w_distance: z.number().optional().describe("Distance weight (default 0.03)"),
+    w_phone: z.number().optional().describe("Phone availability weight (default 0.05)"),
+})
+    .optional()
+    .describe("Scoring weights for result ranking");
+export class SearchProfiles extends MCPTool {
+    name = "search_profiles";
+    description = "Search for candidate profiles using keyword and location criteria. " +
+        "Supports full-text search, geographic radius filtering, company/title filters, " +
+        "and custom relevance weights. Returns a ranked list of SourcerProfile objects.";
+    schema = z.object({
+        source: z
+            .enum(["PeopleDataLabs", "JobTarget", "ResumeLibrary"])
+            .describe("Data source to search: PeopleDataLabs, JobTarget, or ResumeLibrary"),
+        what: z
+            .string()
+            .min(1)
+            .describe("Search keywords (e.g. 'software engineer react', 'nurse practitioner')"),
+        where: z
+            .string()
+            .optional()
+            .describe("Location string (e.g. 'New York, NY'). Required when radius is specified."),
+        latitude: z
+            .number()
+            .optional()
+            .describe("Latitude for geo search. Must be paired with longitude."),
+        longitude: z
+            .number()
+            .optional()
+            .describe("Longitude for geo search. Must be paired with latitude."),
+        radius: z
+            .number()
+            .int()
+            .min(10)
+            .max(200)
+            .optional()
+            .describe("Search radius in miles (10–200). Requires where + latitude + longitude."),
+        page: z
+            .number()
+            .int()
+            .min(1)
+            .default(1)
+            .describe("Page number (1-based, default 1)"),
+        count: z
+            .number()
+            .int()
+            .min(1)
+            .max(100)
+            .default(10)
+            .describe("Results per page (1–100, default 10)"),
+        companies: z
+            .array(z.string())
+            .optional()
+            .describe("Filter by company names (e.g. ['Google', 'Meta'])"),
+        jobTitles: z
+            .array(z.string())
+            .optional()
+            .describe("Filter by job titles (e.g. ['Software Engineer', 'SRE'])"),
+        recentlyActive: z
+            .boolean()
+            .optional()
+            .describe("When true, only return recently active profiles"),
+        companyId: z
+            .number()
+            .int()
+            .optional()
+            .describe("Required when source is ResumeLibrary. Your company ID for RLI access."),
+        fuzziness: z
+            .enum(["Auto", "0", "1", "2"])
+            .optional()
+            .describe("Typo tolerance: Auto (auto-detect), 0 (exact), 1 (one edit), 2 (two edits). " +
+            "Cannot be used with type=cross_fields."),
+        type: z
+            .enum(["best_fields", "most_fields", "cross_fields"])
+            .optional()
+            .describe("Multi-match query type. best_fields (default), most_fields, or cross_fields. " +
+            "cross_fields cannot be combined with fuzziness."),
+        weights: WeightsSchema,
+    });
+    async execute(input) {
+        try {
+            const results = await apiClient.post("/api/v1/profiles/search", input);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(results, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            if (error instanceof ProfilesApiError) {
+                throw new Error(`Profiles API error (${error.status}): ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@jobtarget/profiles-api-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for the Profiles API — exposes profile search, retrieval, profile links, and invite endpoints as MCP tools.",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "profiles-api-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "npx ts-node --esm src/index.ts"
+  },
+  "dependencies": {
+    "mcp-framework": "latest",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}