@breaknorm_hu/mcp-server 0.2.0 → 1.0.0

package/dist/index.js

@@ -59,6 +59,56 @@ function str(val) {
   return String(val);
 }
 var tools = [
+  // ── PRIMARY TOOL — use this for everything ──
+  {
+    name: "find_leads",
+    description: "THE main tool. Finds leads (contacts + company data) in one call. Accepts natural language industry description \u2014 no need to call suggest_industry_codes first! Can also include cost estimate for reveals. Request up to 500 results at once.",
+    schema: z.object({
+      industryDescription: z.string().optional().describe("Natural language: e.g. 'marketing \xFCgyn\xF6ks\xE9gek', 'IT szolg\xE1ltat\xF3k'. Server converts to NAICS codes automatically."),
+      naicsCodes: z.array(z.string()).optional().describe("If you already have NAICS codes from a previous call, pass them here to skip AI generation"),
+      q: z.string().optional().describe("Free text search (name, title, company)"),
+      title: z.string().optional().describe("Job title keyword: '\xFCgyvezet\u0151', 'CEO', 'igazgat\xF3'"),
+      seniority: z.array(z.string()).optional().describe("c_level, vp, director, manager, head, senior, founder, partner, managing_director"),
+      department: z.array(z.string()).optional().describe("sales, marketing, it, hr, finance, engineering, c_suite"),
+      city: z.array(z.string()).optional().describe("City names"),
+      employee_min: z.number().int().optional().describe("Min company employees"),
+      employee_max: z.number().int().optional().describe("Max company employees"),
+      revenue_min: z.number().optional().describe("Min annual revenue HUF"),
+      revenue_max: z.number().optional().describe("Max annual revenue HUF"),
+      has_email: z.enum(["yes", "maybe", "no"]).optional().describe("Email availability filter"),
+      has_phone: z.enum(["yes", "maybe", "no"]).optional(),
+      includeEstimate: z.boolean().default(true).optional().describe("Include reveal cost estimate in response (default: true)"),
+      revealType: z.enum(["email", "phone", "all"]).default("email").optional().describe("For estimate: what to reveal"),
+      limit: z.number().int().min(1).max(500).default(100).optional().describe("Results to return (max 500, default 100)"),
+      page: z.number().int().default(1).optional(),
+      searchToken: z.string().optional().describe("For page 2+, from previous response")
+    }),
+    handler: async (client, args) => {
+      const result = await client.post("/leads/find", {
+        industryDescription: args.industryDescription,
+        naicsCodes: args.naicsCodes,
+        q: args.q,
+        title: args.title,
+        seniority: args.seniority,
+        department: args.department,
+        city: args.city,
+        employee_min: args.employee_min,
+        employee_max: args.employee_max,
+        revenue_min: args.revenue_min,
+        revenue_max: args.revenue_max,
+        has_email: args.has_email,
+        has_phone: args.has_phone,
+        includeEstimate: args.includeEstimate ?? true,
+        revealType: args.revealType || "email",
+        limit: args.limit || 100,
+        page: args.page || 1,
+        searchToken: args.searchToken
+      });
+      const d = result.data;
+      return d;
+    }
+  },
+  // ── ADVANCED: direct search (for pagination with existing NAICS codes) ──
   {
     name: "search_leads",
     description: "Search for leads (contacts + company data in one result). This is THE main search tool. Returns contacts with their company info. Use suggest_industry_codes FIRST to get NAICS codes, then pass them here. You can request up to 500 results at once (no need to paginate for small queries). NEVER search by company name one by one!",
@@ -85,7 +135,7 @@ var tools = [
       searchToken: z.string().optional().describe("Required for page 2+, from page 1 response")
     }),
     handler: async (client, args) => {
-      return client.get("/leads/search", {
+      const result = await client.get("/leads/search", {
         q: str(args.q),
         naicsCodes: arrayParam(args.naicsCodes),
         industry: arrayParam(args.industry),
@@ -107,6 +157,28 @@ var tools = [
         page: str(args.page),
         searchToken: str(args.searchToken)
       });
+      const r = result;
+      const leads = (r.data || []).map((lead) => ({
+        id: lead.id,
+        name: `${lead.firstName} ${lead.lastName}`,
+        title: lead.title,
+        seniority: lead.seniority,
+        email: lead.revealedEmail || (lead.hasEmail ? "available" : null),
+        phone: lead.revealedPhone || (lead.hasPhone ? "available" : null),
+        company: lead.companyName,
+        companyId: lead.companyId,
+        industry: lead.industry,
+        city: lead.city,
+        employees: lead.employeeCount,
+        revenue: lead.annualRevenue
+      }));
+      return {
+        leads,
+        total: r.pagination?.total,
+        page: r.pagination?.page,
+        hasMore: r.pagination?.hasMore,
+        searchToken: r.pagination?.searchToken
+      };
     }
   },
   {
@@ -288,33 +360,27 @@ var SERVER_NAME = "breaknorm";
 var SERVER_VERSION = "0.1.0";
 var INSTRUCTIONS = `Breaknorm MCP Server \u2014 B2B contact database for the Hungarian market.
 
-CRITICAL RULES:
-
-1. USE search_leads FOR EVERYTHING \u2014 it returns contacts WITH company data in one call.
-   You can request up to 500 results at once (limit: 500). No need to paginate for most queries!
-
-2. NEVER search by company name one by one! Use filters:
-   Wrong: search_leads(q: "Company A"), search_leads(q: "Company B"), ...
-   Right: suggest_industry_codes("marketing") \u2192 search_leads(naicsCodes: [...], seniority: ["c_level"], limit: 200)
+USE find_leads FOR EVERYTHING. It does everything in ONE call:
+- Converts industry description to NAICS codes automatically (no need for separate calls)
+- Searches contacts WITH company data
+- Includes cost estimate for reveals
+- Returns up to 500 results at once
 
-3. INDUSTRY SEARCH \u2014 always use NAICS codes:
-   a. suggest_industry_codes("rekl\xE1m \xE9s m\xE9dia \xFCgyn\xF6ks\xE9gek") \u2192 get NAICS codes ONCE
-   b. search_leads(naicsCodes: [codes], employee_min: 5, seniority: ["c_level"], limit: 200)
-   c. If you need more pages, reuse the SAME naicsCodes \u2014 NEVER call suggest_industry_codes again!
+WORKFLOW (only 2 steps!):
+1. find_leads(industryDescription: "marketing \xFCgyn\xF6ks\xE9gek", seniority: ["c_level"], has_email: "yes", limit: 100, includeEstimate: true)
+   \u2192 Returns leads + cost estimate in ONE call
+2. User approves \u2192 bulk_reveal_contacts(contactIds: [...], type: "email")
+   \u2192 Done!
 
-4. WORKFLOW for building a lead list:
-   a. get_credits \u2014 check balance
-   b. suggest_industry_codes \u2014 get NAICS codes (ONCE!)
-   c. search_leads \u2014 find leads with all filters, up to 500 at once
-   d. estimate_cost \u2014 calculate reveal cost
-   e. [Wait for user approval of the cost]
-   f. bulk_reveal_contacts \u2014 get emails (up to 1000 at once)
-   g. create_list + add_contacts_to_list \u2014 organize
-   h. export_list \u2014 CSV export
+For page 2+: use the naicsCodesUsed + searchToken from the first response.
+Pass naicsCodes instead of industryDescription to skip AI generation on subsequent pages.
 
-5. Before ANY paid operation (reveal, scoring), call estimate_cost and get user approval.
-6. Credit costs: email=1, phone=10, both=11, ICP scoring=1 per company.
-7. Search is FREE. Bulk operations are async \u2014 poll with check_job_status.`;
+RULES:
+- NEVER search by company name one by one
+- find_leads handles NAICS generation internally \u2014 don't call suggest_industry_codes separately
+- Always includeEstimate: true so you can show the cost to the user
+- Before reveal, ALWAYS show the cost and ask for user approval
+- Credit costs: email=1, phone=10, both=11 per contact`;
 async function main() {
   const apiKey = process.env.BREAKNORM_API_KEY;
   if (!apiKey) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breaknorm_hu/mcp-server",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "description": "Breaknorm MCP Server — AI agent interface for B2B contact database",
   "type": "module",
   "bin": {