@breaknorm_hu/mcp-server 0.1.6 → 0.2.0

package/dist/index.js

@@ -60,75 +60,51 @@ function str(val) {
 }
 var tools = [
   {
-    name: "search_contacts",
-    description: "Search contacts with filters. Use suggest_industry_codes FIRST to convert industry descriptions to NAICS codes, then pass them here. NEVER search by company name one by one \u2014 always use filters to get bulk results!",
+    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!",
     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"),
-      naicsCodes: z.array(z.string()).optional().describe("NAICS codes from suggest_industry_codes \u2014 THIS IS THE BEST WAY TO FILTER BY INDUSTRY"),
+      q: z.string().optional().describe("Free text search (name, title, company name)"),
+      naicsCodes: z.array(z.string()).optional().describe("NAICS codes from suggest_industry_codes \u2014 THE way to filter by industry"),
+      industry: z.array(z.string()).optional().describe("Industry name filter (use naicsCodes instead when possible)"),
       city: z.array(z.string()).optional().describe("Filter by city names"),
-      seniority: z.array(z.string()).optional().describe("c_level, vp, director, manager, head, senior, founder, partner"),
-      department: z.array(z.string()).optional().describe("sales, marketing, it, hr, finance, engineering, c_suite"),
+      county: z.array(z.string()).optional().describe("Filter by county (megye)"),
+      country: z.string().optional().describe("2-letter country code, default: HU"),
+      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, operations, legal, product"),
+      title: z.string().optional().describe("Job title keyword (e.g. '\xFCgyvezet\u0151', 'CEO', 'igazgat\xF3')"),
       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 in HUF"),
       revenue_max: z.number().optional().describe("Max annual revenue in HUF"),
       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)"),
+      has_phone: z.enum(["yes", "maybe", "no"]).optional().describe("Filter by phone availability"),
+      is_revealed: z.boolean().optional().describe("Only show already-revealed contacts"),
+      icp_score_min: z.number().min(0).max(100).optional().describe("Min ICP score (0-100)"),
+      limit: z.number().int().min(1).max(500).default(25).describe("Results to return (max 500, default 25). Use higher values to get more results at once!"),
+      page: z.number().int().default(1).describe("Page number (default 1)"),
       searchToken: z.string().optional().describe("Required for page 2+, from page 1 response")
     }),
     handler: async (client, args) => {
-      return client.get("/contacts/search", {
+      return client.get("/leads/search", {
         q: str(args.q),
-        industry: arrayParam(args.industry),
         naicsCodes: arrayParam(args.naicsCodes),
+        industry: arrayParam(args.industry),
         city: arrayParam(args.city),
+        county: arrayParam(args.county),
+        country: str(args.country),
         seniority: arrayParam(args.seniority),
         department: arrayParam(args.department),
+        title: str(args.title),
         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),
-        page: str(args.page),
+        has_phone: str(args.has_phone),
+        is_revealed: str(args.is_revealed),
+        icp_score_min: str(args.icp_score_min),
         limit: str(args.limit),
-        searchToken: str(args.searchToken)
-      });
-    }
-  },
-  {
-    name: "search_companies",
-    description: "Search companies with filters. Use suggest_industry_codes FIRST for industry filtering. NEVER search one by one \u2014 use filters!",
-    schema: z.object({
-      q: z.string().optional().describe("Company name search"),
-      industry: z.array(z.string()).optional(),
-      naicsCodes: z.array(z.string()).optional().describe("NAICS codes from suggest_industry_codes \u2014 BEST way to filter by industry"),
-      city: z.array(z.string()).optional(),
-      employee_min: z.number().int().optional(),
-      employee_max: z.number().int().optional(),
-      revenue_min: z.number().optional().describe("Min annual revenue in HUF"),
-      revenue_max: z.number().optional().describe("Max annual revenue in HUF"),
-      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),
-        naicsCodes: arrayParam(args.naicsCodes),
-        city: arrayParam(args.city),
-        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),
-        sort: str(args.sort),
         searchToken: str(args.searchToken)
       });
     }
@@ -312,34 +288,33 @@ 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 \u2014 READ CAREFULLY:
+CRITICAL RULES:
 
-1. NEVER search by company name one by one! ALWAYS use filters to get bulk results.
-   Wrong: search_contacts(q: "Company A"), search_contacts(q: "Company B"), ...
-   Right: suggest_industry_codes("marketing \xFCgyn\xF6ks\xE9gek") \u2192 search_contacts(naicsCodes: [...], seniority: ["c_level"])
+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. INDUSTRY SEARCH WORKFLOW \u2014 this is how it works:
-   a. suggest_industry_codes("rekl\xE1m \xE9s m\xE9dia \xFCgyn\xF6ks\xE9gek") \u2192 returns NAICS codes
-   b. search_companies(naicsCodes: [codes from step a], employee_min: 5) \u2192 returns ALL matching companies at once
-   c. search_contacts(naicsCodes: [same codes], seniority: ["c_level", "director"]) \u2192 returns ALL decision-makers at once
-   This gives you hundreds of results in 2-3 API calls instead of searching one by one!
+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)
 
-3. Before ANY paid operation (reveal, scoring), call estimate_cost first and get user approval.
+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!
 
-4. Recommended workflow for building a lead list:
+4. WORKFLOW for building a lead list:
    a. get_credits \u2014 check balance
-   b. suggest_industry_codes \u2014 convert industry description to NAICS codes
-   c. search_companies \u2014 find companies with naicsCodes + size + location filters
-   d. search_contacts \u2014 find decision-makers with naicsCodes + seniority + department filters
-   e. estimate_cost \u2014 calculate cost
-   f. [Wait for user approval]
-   g. bulk_reveal_contacts \u2014 get emails (up to 1000 at once!)
-   h. create_list + add_contacts_to_list \u2014 organize
-   i. export_list \u2014 CSV export
+   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
 
-5. Credit costs: email=1, phone=10, both=11, ICP scoring=1 per company
-6. Search is FREE and paginated (25/page). Use searchToken for page 2+.
-7. Bulk operations are async \u2014 poll with check_job_status.`;
+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.`;
 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.1.6",
+  "version": "0.2.0",
   "description": "Breaknorm MCP Server — AI agent interface for B2B contact database",
   "type": "module",
   "bin": {