get_scored_leads
Retrieve AI-scored sales leads by filtering companies with recent business events based on buyer intent, buying stage, and industry criteria to identify high-potential prospects.
Instructions
Get AI-scored sales leads based on your ICP (Ideal Customer Profile). Returns companies with recent business events scored by AI for buyer intent, buying stage, and recommended outreach strategy.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| min_score | No | Minimum buyer intent score (0-100). Default: 0 | |
| max_results | No | Max leads to return (1-50). Default: 25 | |
| buying_stages | No | Filter by buying stage: 'Active Evaluation', 'Decision', 'Research', 'Awareness' | |
| industries | No | Filter by industry (e.g., ['SaaS', 'HealthTech', 'FinTech']) |
Implementation Reference
- src/index.ts:177-208 (handler)The handler for `get_scored_leads` which performs an API request to `/signals` and formats the results.
case "get_scored_leads": { const data = await apiRequest("POST", "/signals", { min_score: (args as any).min_score ?? 0, max_results: (args as any).max_results ?? 25, buying_stages: (args as any).buying_stages, industries: (args as any).industries, }); const leads = data.signals || []; if (leads.length === 0) { return textResult("No scored leads found for your current ICP. Leads are generated daily by the AI scoring engine."); } const summary = leads .map( (lead: any, i: number) => `${i + 1}. **${lead.company_name}** (Score: ${lead.score}/100)\n` + ` Stage: ${lead.buying_stage} | Priority: ${lead.priority}\n` + ` Pain Point: ${lead.pain_point}\n` + ` Outreach: ${lead.outreach_angle}\n` + ` Action: ${lead.recommended_action}\n` + (lead.domain ? ` Domain: ${lead.domain}\n` : "") + (lead.industries?.length ? ` Industries: ${lead.industries.join(", ")}\n` : "") ) .join("\n"); return textResult(`Found ${data.signals_found} scored leads (showing ${leads.length}):\n\n${summary}`); } case "get_events": { const data = await apiRequest("GET", "/events", { types: (args as any).types, days: (args as any).days, limit: (args as any).limit, industries: (args as any).industries, - src/index.ts:73-96 (registration)Definition and registration of the `get_scored_leads` tool.
{ name: "get_scored_leads", description: "Get AI-scored sales leads based on your ICP (Ideal Customer Profile). " + "Returns companies with recent business events scored by AI for buyer intent, " + "buying stage, and recommended outreach strategy.", inputSchema: { type: "object" as const, properties: { min_score: { type: "number", description: "Minimum buyer intent score (0-100). Default: 0" }, max_results: { type: "number", description: "Max leads to return (1-50). Default: 25" }, buying_stages: { type: "array", items: { type: "string" }, description: "Filter by buying stage: 'Active Evaluation', 'Decision', 'Research', 'Awareness'", }, industries: { type: "array", items: { type: "string" }, description: "Filter by industry (e.g., ['SaaS', 'HealthTech', 'FinTech'])", }, }, }, },