@breaknorm_hu/mcp-server 0.1.0 → 0.1.2

package/dist/index.js

@@ -10,7 +10,7 @@ var BreakNormClient = class {
   apiKey;
   constructor(apiKey, baseUrl) {
     this.apiKey = apiKey;
-    this.baseUrl = (baseUrl || "https://breaknorm.com").replace(/\/$/, "");
+    this.baseUrl = (baseUrl || "https://breaknorm.hu").replace(/\/$/, "");
   }
   async request(method, path, options) {
     const url = new URL(`/api/v1${path}`, this.baseUrl);
@@ -49,6 +49,7 @@ var BreakNormClient = class {
 };
 
 // src/tools.ts
+import { z } from "zod";
 function arrayParam(val) {
   if (Array.isArray(val) && val.length > 0) return val.join(",");
   return void 0;
@@ -58,55 +59,32 @@ function str(val) {
   return String(val);
 }
 var tools = [
-  // ── Search ─────────────────────────────────
   {
     name: "search_contacts",
     description: "Search the Breaknorm contact database. Returns contacts matching filters. Use get_search_filters first to discover available filter values. Results paginated (max 25/page). For page 2+, pass searchToken from page 1.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        q: { type: "string", description: "Free text search (name, title, company)" },
-        industry: { type: "array", items: { type: "string" }, description: "Filter by industry names" },
-        city: { type: "array", items: { type: "string" }, description: "Filter by city names" },
-        county: { type: "array", items: { type: "string" }, description: "Filter by county (megye)" },
-        country: { type: "string", description: "2-letter country code (default: HU)" },
-        seniority: {
-          type: "array",
-          items: { type: "string", enum: ["c_level", "vp", "director", "manager", "head", "senior", "entry", "intern", "founder", "partner", "managing_director", "individual_contributor"] },
-          description: "Filter by seniority level"
-        },
-        department: {
-          type: "array",
-          items: { type: "string", enum: ["sales", "marketing", "it", "hr", "finance", "operations", "legal", "engineering", "product", "customer_success", "c_suite", "design", "other"] }
-        },
-        employee_min: { type: "integer", description: "Minimum company employee count" },
-        employee_max: { type: "integer", description: "Maximum company employee count" },
-        revenue_min: { type: "number", description: "Minimum annual revenue (HUF)" },
-        revenue_max: { type: "number", description: "Maximum annual revenue (HUF)" },
-        has_email: { type: "string", enum: ["yes", "maybe", "no"], description: "Filter by email availability" },
-        has_phone: { type: "string", enum: ["yes", "maybe", "no"] },
-        title: { type: "string", description: "Job title keyword search" },
-        page: { type: "integer", default: 1 },
-        limit: { type: "integer", default: 25, maximum: 25 },
-        searchToken: { type: "string", description: "Required for page 2+. From page 1 response." }
-      }
-    },
+    schema: z.object({
+      q: z.string().optional().describe("Free text search (name, title, company)"),
+      industry: z.array(z.string()).optional().describe("Filter by industry names"),
+      city: z.array(z.string()).optional().describe("Filter by city names"),
+      seniority: z.array(z.string()).optional().describe("Filter by seniority: c_level, vp, director, manager, head, senior, founder, partner"),
+      department: z.array(z.string()).optional().describe("Filter by department: sales, marketing, it, hr, finance, engineering, c_suite"),
+      employee_min: z.number().int().optional().describe("Min company employees"),
+      employee_max: z.number().int().optional().describe("Max company employees"),
+      has_email: z.enum(["yes", "maybe", "no"]).optional().describe("Filter by email availability"),
+      page: z.number().int().default(1).describe("Page number"),
+      limit: z.number().int().max(25).default(25).describe("Results per page (max 25)"),
+      searchToken: z.string().optional().describe("Required for page 2+, from page 1 response")
+    }),
     handler: async (client, args) => {
       return client.get("/contacts/search", {
         q: str(args.q),
         industry: arrayParam(args.industry),
         city: arrayParam(args.city),
-        county: arrayParam(args.county),
-        country: str(args.country),
         seniority: arrayParam(args.seniority),
         department: arrayParam(args.department),
         employee_min: str(args.employee_min),
         employee_max: str(args.employee_max),
-        revenue_min: str(args.revenue_min),
-        revenue_max: str(args.revenue_max),
         has_email: str(args.has_email),
-        has_phone: str(args.has_phone),
-        title: str(args.title),
         page: str(args.page),
         limit: str(args.limit),
         searchToken: str(args.searchToken)
@@ -115,37 +93,26 @@ var tools = [
   },
   {
     name: "search_companies",
-    description: "Search companies in the Breaknorm database. Returns companies matching filters.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        q: { type: "string", description: "Free text company name search" },
-        industry: { type: "array", items: { type: "string" } },
-        city: { type: "array", items: { type: "string" } },
-        county: { type: "array", items: { type: "string" } },
-        country: { type: "string" },
-        employee_min: { type: "integer" },
-        employee_max: { type: "integer" },
-        revenue_min: { type: "number" },
-        revenue_max: { type: "number" },
-        has_website: { type: "boolean" },
-        page: { type: "integer", default: 1 },
-        limit: { type: "integer", default: 25, maximum: 25 },
-        sort: { type: "string", enum: ["relevance", "name", "employee_count", "revenue", "icp_score"], default: "relevance" },
-        searchToken: { type: "string" }
-      }
-    },
+    description: "Search companies in the Breaknorm database.",
+    schema: z.object({
+      q: z.string().optional().describe("Company name search"),
+      industry: z.array(z.string()).optional(),
+      city: z.array(z.string()).optional(),
+      employee_min: z.number().int().optional(),
+      employee_max: z.number().int().optional(),
+      has_website: z.boolean().optional(),
+      page: z.number().int().default(1),
+      limit: z.number().int().max(25).default(25),
+      sort: z.enum(["relevance", "name", "employee_count", "revenue", "icp_score"]).default("relevance"),
+      searchToken: z.string().optional()
+    }),
     handler: async (client, args) => {
       return client.get("/companies/search", {
         q: str(args.q),
         industry: arrayParam(args.industry),
         city: arrayParam(args.city),
-        county: arrayParam(args.county),
-        country: str(args.country),
         employee_min: str(args.employee_min),
         employee_max: str(args.employee_max),
-        revenue_min: str(args.revenue_min),
-        revenue_max: str(args.revenue_max),
         has_website: str(args.has_website),
         page: str(args.page),
         limit: str(args.limit),
@@ -156,172 +123,119 @@ var tools = [
   },
   {
     name: "get_search_filters",
-    description: "Get all available filter values with counts (industries, cities, counties, seniorities, departments, etc.). Call this FIRST before searching to understand what filter values are available.",
-    inputSchema: { type: "object", properties: {} },
+    description: "Get all available filter values with counts (industries, cities, seniorities, departments). Call this FIRST before searching.",
+    schema: z.object({}),
     handler: async (client) => client.get("/search/filters")
   },
-  // ── Contacts ───────────────────────────────
   {
     name: "get_contact",
     description: "Get details of a single contact (public fields, no revealed data).",
-    inputSchema: {
-      type: "object",
-      properties: { contactId: { type: "string", description: "Contact UUID" } },
-      required: ["contactId"]
-    },
+    schema: z.object({
+      contactId: z.string().describe("Contact UUID")
+    }),
     handler: async (client, args) => client.get(`/contacts/${args.contactId}`)
   },
-  // ── Cost Estimation ────────────────────────
   {
     name: "estimate_cost",
-    description: "IMPORTANT: Call this BEFORE any paid operation (reveal, ICP scoring). Returns exact credit cost, current balance, and whether you can afford it. Present the cost to the user for approval before proceeding.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        operations: {
-          type: "array",
-          items: {
-            type: "object",
-            properties: {
-              type: { type: "string", enum: ["reveal", "icp_score"] },
-              contactIds: { type: "array", items: { type: "string" }, description: "For reveal operations" },
-              revealType: { type: "string", enum: ["email", "phone", "all"], description: "For reveal: what to reveal" },
-              companyIds: { type: "array", items: { type: "string" }, description: "For icp_score operations" },
-              icpProfileId: { type: "string", description: "For icp_score: specific profile ID (optional)" }
-            },
-            required: ["type"]
-          },
-          description: "List of operations to estimate"
-        }
-      },
-      required: ["operations"]
-    },
+    description: "IMPORTANT: Call BEFORE any paid operation (reveal, ICP scoring). Returns exact credit cost, balance, and whether you can afford it. Present cost to user for approval.",
+    schema: z.object({
+      operations: z.array(z.object({
+        type: z.enum(["reveal", "icp_score"]),
+        contactIds: z.array(z.string()).optional().describe("For reveal operations"),
+        revealType: z.enum(["email", "phone", "all"]).optional().describe("For reveal: what to reveal"),
+        companyIds: z.array(z.string()).optional().describe("For icp_score operations"),
+        icpProfileId: z.string().optional().describe("For icp_score: specific profile")
+      })).describe("List of operations to estimate")
+    }),
     handler: async (client, args) => client.post("/estimate", { operations: args.operations })
   },
-  // ── Reveal ─────────────────────────────────
   {
     name: "reveal_contact",
-    description: "Reveal email and/or phone for a single contact. Costs credits (email=1, phone=10, all=11). ALWAYS call estimate_cost first and get user approval.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        contactId: { type: "string", description: "Contact UUID" },
-        type: { type: "string", enum: ["email", "phone", "all"], description: "What to reveal" }
-      },
-      required: ["contactId", "type"]
-    },
+    description: "Reveal email/phone for a single contact. Costs credits (email=1, phone=10, all=11). ALWAYS call estimate_cost first.",
+    schema: z.object({
+      contactId: z.string().describe("Contact UUID"),
+      type: z.enum(["email", "phone", "all"]).describe("What to reveal")
+    }),
     handler: async (client, args) => client.post(`/contacts/${args.contactId}/reveal`, { type: args.type })
   },
   {
     name: "bulk_reveal_contacts",
-    description: "Reveal data for multiple contacts at once. Creates an async job. Returns jobId \u2014 use check_job_status to poll progress. ALWAYS call estimate_cost first.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        contactIds: { type: "array", items: { type: "string" }, description: "Contact UUIDs (max 1000)" },
-        type: { type: "string", enum: ["email", "phone", "all"] },
-        idempotencyKey: { type: "string", description: "UUID to prevent duplicate charges on retry" }
-      },
-      required: ["contactIds", "type"]
-    },
+    description: "Reveal data for multiple contacts at once (async job). Returns jobId. ALWAYS call estimate_cost first.",
+    schema: z.object({
+      contactIds: z.array(z.string()).describe("Contact UUIDs (max 1000)"),
+      type: z.enum(["email", "phone", "all"]),
+      idempotencyKey: z.string().optional().describe("UUID to prevent double charges on retry")
+    }),
     handler: async (client, args) => client.post("/contacts/bulk-reveal", {
       contactIds: args.contactIds,
       type: args.type,
       idempotencyKey: args.idempotencyKey
     })
   },
-  // ── Jobs ───────────────────────────────────
   {
     name: "check_job_status",
-    description: "Check the status of an async job (bulk reveal, export, ICP scoring). Returns progress (processedItems/totalItems) and status (pending/processing/completed/failed).",
-    inputSchema: {
-      type: "object",
-      properties: { jobId: { type: "string", description: "Job UUID" } },
-      required: ["jobId"]
-    },
+    description: "Check async job status (bulk reveal, export, ICP scoring). Returns progress and status.",
+    schema: z.object({
+      jobId: z.string().describe("Job UUID")
+    }),
     handler: async (client, args) => client.get(`/jobs/${args.jobId}`)
   },
-  // ── Credits ────────────────────────────────
   {
     name: "get_credits",
     description: "Check current credit balance and subscription tier.",
-    inputSchema: { type: "object", properties: {} },
+    schema: z.object({}),
     handler: async (client) => client.get("/credits")
   },
-  // ── Lists ──────────────────────────────────
   {
     name: "list_saved_lists",
     description: "List all saved contact lists.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        page: { type: "integer", default: 1 },
-        limit: { type: "integer", default: 20, maximum: 100 },
-        sort: { type: "string", enum: ["name", "created_at", "contact_count"], default: "created_at" }
-      }
-    },
+    schema: z.object({
+      page: z.number().int().default(1).optional(),
+      limit: z.number().int().max(100).default(20).optional(),
+      sort: z.enum(["name", "created_at", "contact_count"]).default("created_at").optional()
+    }),
     handler: async (client, args) => client.get("/lists", { page: str(args.page), limit: str(args.limit), sort: str(args.sort) })
   },
   {
     name: "create_list",
     description: "Create a new saved contact list.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        name: { type: "string", description: "List name (1-200 chars)" },
-        description: { type: "string", description: "Optional description (max 1000 chars)" }
-      },
-      required: ["name"]
-    },
+    schema: z.object({
+      name: z.string().describe("List name (1-200 chars)"),
+      description: z.string().optional().describe("Optional description")
+    }),
     handler: async (client, args) => client.post("/lists", { name: args.name, description: args.description })
   },
   {
     name: "add_contacts_to_list",
-    description: "Add contacts to an existing list. Duplicates are automatically skipped.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        listId: { type: "string", description: "List UUID" },
-        contactIds: { type: "array", items: { type: "string" }, description: "Contact UUIDs (max 500)" }
-      },
-      required: ["listId", "contactIds"]
-    },
+    description: "Add contacts to a list. Duplicates auto-skipped.",
+    schema: z.object({
+      listId: z.string().describe("List UUID"),
+      contactIds: z.array(z.string()).describe("Contact UUIDs (max 500)")
+    }),
     handler: async (client, args) => client.post(`/lists/${args.listId}/contacts`, { contactIds: args.contactIds })
   },
   {
     name: "export_list",
-    description: "Export a saved list as CSV. Creates async job \u2014 use check_job_status to poll.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        listId: { type: "string", description: "List UUID" }
-      },
-      required: ["listId"]
-    },
+    description: "Export a list as CSV (async job). Use check_job_status to poll.",
+    schema: z.object({
+      listId: z.string().describe("List UUID")
+    }),
     handler: async (client, args) => client.post(`/lists/${args.listId}/export`)
   },
-  // ── ICP ────────────────────────────────────
   {
     name: "list_icp_profiles",
-    description: "List user's ICP (Ideal Customer Profile) definitions.",
-    inputSchema: { type: "object", properties: {} },
+    description: "List ICP (Ideal Customer Profile) definitions.",
+    schema: z.object({}),
     handler: async (client) => client.get("/icp-profiles")
   },
   {
     name: "create_icp_profile",
-    description: "Create an ICP profile from a natural language description. This defines what your ideal customer looks like, used for AI scoring.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        name: { type: "string", description: "Profile name (e.g., 'SaaS c\xE9gek Budapest')" },
-        description: {
-          type: "string",
-          description: "Detailed ICP description in natural language (1-2000 chars). Example: 'IT \xE9s SaaS c\xE9gek, 10-200 alkalmazott, Budapest, \xE9ves bev\xE9tel 100M-1B HUF, akt\xEDv LinkedIn jelenl\xE9t'"
-        },
-        isDefault: { type: "boolean", description: "Set as default profile for scoring", default: false }
-      },
-      required: ["name", "description"]
-    },
+    description: "Create an ICP profile from natural language description for AI scoring.",
+    schema: z.object({
+      name: z.string().describe("Profile name"),
+      description: z.string().describe("Detailed ICP description (1-2000 chars)"),
+      isDefault: z.boolean().default(false).optional()
+    }),
     handler: async (client, args) => client.post("/icp-profiles", {
       name: args.name,
       description: args.description,
@@ -330,16 +244,12 @@ var tools = [
   },
   {
     name: "score_companies",
-    description: "Score companies against an ICP profile using AI. Creates async job. Costs 1 credit per company. ALWAYS call estimate_cost first.",
-    inputSchema: {
-      type: "object",
-      properties: {
-        companyIds: { type: "array", items: { type: "string" }, description: "Company UUIDs (max 500)" },
-        icpProfileId: { type: "string", description: "ICP profile UUID (uses default if omitted)" },
-        idempotencyKey: { type: "string", description: "UUID to prevent duplicate charges" }
-      },
-      required: ["companyIds"]
-    },
+    description: "Score companies against ICP profile using AI (async). 1 credit/company. ALWAYS call estimate_cost first.",
+    schema: z.object({
+      companyIds: z.array(z.string()).describe("Company UUIDs (max 500)"),
+      icpProfileId: z.string().optional().describe("ICP profile UUID (uses default if omitted)"),
+      idempotencyKey: z.string().optional()
+    }),
     handler: async (client, args) => client.post("/icp-scores/bulk", {
       companyIds: args.companyIds,
       icpProfileId: args.icpProfileId,
@@ -384,10 +294,10 @@ async function main() {
   const apiKey = process.env.BREAKNORM_API_KEY;
   if (!apiKey) {
     console.error("Error: BREAKNORM_API_KEY environment variable is required.");
-    console.error("Get your API key at https://breaknorm.com/app/settings/developers");
+    console.error("Get your API key at https://breaknorm.hu/app/settings/developers");
     process.exit(1);
   }
-  const baseUrl = process.env.BREAKNORM_BASE_URL || "https://breaknorm.com";
+  const baseUrl = process.env.BREAKNORM_BASE_URL || "https://breaknorm.hu";
   const client = new BreakNormClient(apiKey, baseUrl);
   const server = new McpServer({
     name: SERVER_NAME,
@@ -399,7 +309,7 @@ async function main() {
     server.tool(
       tool.name,
       tool.description,
-      tool.inputSchema,
+      tool.schema.shape,
       async (args) => {
         try {
           const result = await tool.handler(client, args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breaknorm_hu/mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Breaknorm MCP Server — AI agent interface for B2B contact database",
   "type": "module",
   "bin": {
@@ -13,7 +13,8 @@
     "start": "node dist/index.js"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "tsup": "^8.4.0",