@sellable/mcp 0.1.254 → 0.1.255

package/dist/server.js

@@ -18,7 +18,7 @@ import { copySenderConfigTool, getEngageMemoryTool, migrateFlatConfigsTool, reco
 import { getEngageStateTool, setEngageStateTool, } from "./tools/engage-state.js";
 import { bulkEnrichWithProspeo, enrichWithProspeo, getProspeoCredits, } from "./tools/enrichment.js";
 import { getCampaignFramework } from "./tools/framework.js";
-import { cancelLeadImport, confirmProspeoCompanyAccounts, confirmLeadList, getProviderPrompt, importLeads, loadCsvDncEntriesTool, loadCsvDomains, loadCsvLinkedinLeads, lookupSalesNavFilter, saveDomainFilters, searchApollo, searchProspeoCompanies, searchProspeo, searchSalesNav, searchSignals, selectPromisingPosts, setHeadlineICPCriteria, } from "./tools/leads.js";
+import { cancelLeadImport, confirmProspeoCompanyAccounts, confirmLeadList, getProviderPrompt, importLeads, listDncEntriesTool, loadCsvDncEntriesTool, loadCsvDomains, loadCsvLinkedinLeads, lookupSalesNavFilter, saveDomainFilters, searchApollo, searchProspeoCompanies, searchProspeo, searchSalesNav, searchSignals, selectPromisingPosts, setHeadlineICPCriteria, } from "./tools/leads.js";
 import { fetchCompany, fetchCompanyPosts, fetchLinkedInPosts, fetchLinkedInProfile, fetchPostEngagers, getLinkedInProfile, getUserPosts, } from "./tools/linkedin.js";
 import { getCampaignNavigationState } from "./tools/navigation.js";
 import { addOnDemandLeads, createOnDemandCampaign, createOnDemandTable, initOnDemandSequence, pauseOnDemandCampaign, startOnDemandCampaign, } from "./tools/one-off.js";
@@ -366,6 +366,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             case "load_csv_dnc_entries":
                 result = await loadCsvDncEntriesTool(args);
                 break;
+            case "list_dnc_entries":
+                result = await listDncEntriesTool(args);
+                break;
             case "save_domain_filters":
                 result = await saveDomainFilters(args);
                 break;

package/dist/tools/csv-dnc.d.ts

@@ -1,3 +1,4 @@
+type DncSourceType = "all" | "manual" | "hubspot";
 type InvalidDncRow = {
     row: number;
     column: string | null;
@@ -14,6 +15,41 @@ export type LoadCsvDncEntriesInput = {
     confirmationToken?: string;
     confirmed?: boolean;
 };
+export type ListDncEntriesInput = {
+    page?: number;
+    limit?: number;
+    search?: string;
+    listName?: string;
+    sourceType?: DncSourceType;
+    includeDeleted?: boolean;
+};
+export declare function listDncEntries(input?: ListDncEntriesInput): Promise<{
+    ok: boolean;
+    workspaceId: string;
+    workspaceName: string;
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+    listNames: string[];
+    entries: {
+        id: string | null;
+        type: string;
+        domain: string | null;
+        linkedin: string | null;
+        linkedinUsername: string | null;
+        name: string | null;
+        source: {
+            type: string;
+            label: string;
+            listName: string | null;
+        };
+        createdAt: string | null;
+    }[];
+    guidance: string;
+}>;
 export declare function loadCsvDncEntries(input: LoadCsvDncEntriesInput): Promise<{
     guidance: string;
     createdCount: number;

package/dist/tools/csv-dnc.js

@@ -14,6 +14,7 @@ const CONFIRMATION_TOKEN_VERSION = "csv-dnc-preview-v1";
 const confirmationSecret = randomBytes(32).toString("hex");
 const MAX_DNC_UPLOAD_BYTES = 5 * 1024 * 1024;
 const MAX_DNC_CANDIDATES = 7500;
+const MAX_DNC_LIST_LIMIT = 100;
 const STRONG_DOMAIN_HEADER_KEYS = new Set([
     "domain",
     "website",
@@ -325,16 +326,84 @@ async function getVerifiedActiveWorkspace() {
     const config = getConfig();
     const activeWorkspaceId = config.activeWorkspaceId || config.workspaceId;
     if (!activeWorkspaceId) {
-        throw new Error("No active workspace selected. Run list_workspaces then set_active_workspace before importing DNC entries.");
+        throw new Error("No active workspace selected. Run list_workspaces then set_active_workspace for the exact workspace whose Sellable DNC list should be read or updated.");
     }
     const api = getApi();
     const { workspaces } = await api.get("/api/v3/workspaces");
     const match = workspaces.find((workspace) => workspace.id === activeWorkspaceId);
     if (!match) {
-        throw new Error(`Active workspace ${activeWorkspaceId} is not in the server access list. Run list_workspaces then set_active_workspace for the workspace that should receive the DNC import.`);
+        throw new Error(`Active workspace ${activeWorkspaceId} is not in the server access list. Run list_workspaces then set_active_workspace for the exact workspace whose Sellable DNC list should be read or updated.`);
     }
     return match;
 }
+function clampListPositiveInt(value, fallback, max) {
+    const parsed = typeof value === "number"
+        ? value
+        : Number.parseInt(String(value ?? ""), 10);
+    if (!Number.isFinite(parsed) || parsed < 1)
+        return fallback;
+    return Math.min(Math.floor(parsed), max);
+}
+function normalizeDncSourceType(value) {
+    if (value === undefined || value === null || value === "")
+        return "all";
+    if (value === "all" || value === "manual" || value === "hubspot") {
+        return value;
+    }
+    throw new Error("sourceType must be one of all, manual, or hubspot.");
+}
+function optionalTrimmed(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function normalizeCreatedAt(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    return optionalTrimmed(value);
+}
+function compactDncListEntry(entry) {
+    const domain = optionalTrimmed(entry.domain);
+    const linkedin = optionalTrimmed(entry.normalizedLinkedinUrl);
+    const sourceType = optionalTrimmed(entry.sourceType) ?? "manual";
+    return {
+        id: optionalTrimmed(entry.id),
+        type: domain ? "domain" : "linkedin",
+        domain,
+        linkedin,
+        linkedinUsername: optionalTrimmed(entry.linkedinUsername),
+        name: optionalTrimmed(entry.name),
+        source: {
+            type: sourceType,
+            label: optionalTrimmed(entry.sourceLabel) ??
+                (sourceType === "hubspot" ? "HubSpot" : "Manual"),
+            listName: optionalTrimmed(entry.sourceListName),
+        },
+        createdAt: normalizeCreatedAt(entry.createdAt),
+    };
+}
+function buildDncListPath(input) {
+    const page = clampListPositiveInt(input.page, 1, Number.MAX_SAFE_INTEGER);
+    const limit = clampListPositiveInt(input.limit, 25, MAX_DNC_LIST_LIMIT);
+    const sourceType = normalizeDncSourceType(input.sourceType);
+    const params = new URLSearchParams({
+        page: String(page),
+        limit: String(limit),
+    });
+    const search = optionalTrimmed(input.search);
+    const listName = optionalTrimmed(input.listName);
+    if (search)
+        params.set("search", search);
+    if (listName)
+        params.set("listName", listName);
+    if (sourceType !== "all")
+        params.set("sourceType", sourceType);
+    if (input.includeDeleted === true)
+        params.set("includeDeleted", "true");
+    return {
+        path: `/api/v3/dnc-list?${params.toString()}`,
+        page,
+        limit,
+    };
+}
 function makeSignature(payload) {
     return createHmac("sha256", confirmationSecret)
         .update(JSON.stringify(payload))
@@ -556,6 +625,29 @@ async function runDncSpotChecks(entries) {
     }
     return checks;
 }
+export async function listDncEntries(input = {}) {
+    const workspace = await getVerifiedActiveWorkspace();
+    const api = getApi();
+    const request = buildDncListPath(input);
+    const response = await api.get(request.path);
+    const pagination = response.pagination ?? {};
+    return {
+        ok: true,
+        workspaceId: workspace.id,
+        workspaceName: workspace.name,
+        pagination: {
+            total: pagination.total ?? 0,
+            page: pagination.page ?? request.page,
+            limit: pagination.limit ?? request.limit,
+            totalPages: pagination.totalPages ?? 0,
+        },
+        listNames: Array.isArray(response.listNames) ? response.listNames : [],
+        entries: Array.isArray(response.entries)
+            ? response.entries.map(compactDncListEntry)
+            : [],
+        guidance: "This is Sellable's workspace DNC list used by DNC Check.",
+    };
+}
 export async function loadCsvDncEntries(input) {
     const workspace = await getVerifiedActiveWorkspace();
     const api = getApi();

package/dist/tools/leads.d.ts

@@ -1,4 +1,4 @@
-import { type LoadCsvDncEntriesInput } from "./csv-dnc.js";
+import { type ListDncEntriesInput, type LoadCsvDncEntriesInput } from "./csv-dnc.js";
 export declare const MAX_SIGNAL_DISCOVERY_POSTS = 10;
 export declare function normalizeTargetLeadCount(targetLeadCount: unknown, maxImportCount: number): number | undefined;
 type SignalPostForImportSelection = {
@@ -248,6 +248,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -255,7 +260,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -436,6 +440,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -443,7 +452,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -523,6 +531,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -530,7 +543,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -682,6 +694,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -689,7 +706,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -783,6 +799,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -790,7 +811,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -893,6 +913,11 @@ export declare const leadToolDefinitions: ({
             query?: undefined;
             keywords?: undefined;
             domainColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -900,7 +925,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -930,6 +954,109 @@ export declare const leadToolDefinitions: ({
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            page: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            search: {
+                type: string;
+                description: string;
+            };
+            listName: {
+                type: string;
+                description: string;
+            };
+            sourceType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            includeDeleted: {
+                type: string;
+                description: string;
+            };
+            provider?: undefined;
+            campaignOfferId?: undefined;
+            confirmed?: undefined;
+            searchMode?: undefined;
+            organization_num_employees_ranges?: undefined;
+            organization_locations?: undefined;
+            organization_not_locations?: undefined;
+            q_organization_keyword_tags?: undefined;
+            organization_industry_tag_ids?: undefined;
+            latest_funding_amount_min?: undefined;
+            latest_funding_amount_max?: undefined;
+            organization_revenue_min?: undefined;
+            organization_revenue_max?: undefined;
+            person_titles?: undefined;
+            person_seniorities?: undefined;
+            person_locations?: undefined;
+            include_similar_titles?: undefined;
+            q_keywords?: undefined;
+            filters?: undefined;
+            companyFilters?: undefined;
+            contactFilters?: undefined;
+            searchId?: undefined;
+            searchName?: undefined;
+            companySearchMode?: undefined;
+            uploadedDomains?: undefined;
+            currentStep?: undefined;
+            filterType?: undefined;
+            query?: undefined;
+            keywords?: undefined;
+            filePath?: undefined;
+            domainColumn?: undefined;
+            selectedColumns?: undefined;
+            confirmationToken?: undefined;
+            leadListId?: undefined;
+            leadListName?: undefined;
+            linkedInColumn?: undefined;
+            csvText?: undefined;
+            rawText?: undefined;
+            name?: undefined;
+            include?: undefined;
+            exclude?: undefined;
+            seedCompanies?: undefined;
+            seedDomains?: undefined;
+            sort?: undefined;
+            previewOnly?: undefined;
+            companySearchToken?: undefined;
+            selectedCompanyIds?: undefined;
+            domainFilterId?: undefined;
+            type?: undefined;
+            profileUrl?: undefined;
+            postUrl?: undefined;
+            companyUrl?: undefined;
+            headlineICPCriteria?: undefined;
+            rubricGuidelines?: undefined;
+            sourceLeadListId?: undefined;
+            targetLeadCount?: undefined;
+            mode?: undefined;
+            targetEngagerCount?: undefined;
+            maxPostsToScrape?: undefined;
+            tableId?: undefined;
+            campaignName?: undefined;
+            keepInSync?: undefined;
+            jobId?: undefined;
+            reviewBatchLimit?: undefined;
+            allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
+            selections?: undefined;
+            selectionMode?: undefined;
+            scrapePlanMode?: undefined;
+        };
+        required: never[];
+    };
 } | {
     name: string;
     description: string;
@@ -1000,11 +1127,15 @@ export declare const leadToolDefinitions: ({
             selectedColumns?: undefined;
             leadListId?: undefined;
             leadListName?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             include?: undefined;
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -1091,12 +1222,16 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -1978,6 +2113,10 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -2077,13 +2216,17 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             include?: undefined;
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             domainFilterId?: undefined;
@@ -3114,6 +3257,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3121,7 +3269,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -3264,6 +3411,10 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3396,6 +3547,11 @@ export declare const leadToolDefinitions: ({
             confirmationToken?: undefined;
             leadListId?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3403,7 +3559,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -3480,6 +3635,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3487,7 +3647,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -3600,6 +3759,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3607,7 +3771,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -3725,6 +3888,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3732,7 +3900,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -3814,6 +3981,11 @@ export declare const leadToolDefinitions: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3821,7 +3993,6 @@ export declare const leadToolDefinitions: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -4162,6 +4333,33 @@ export declare function loadCsvDncEntriesTool(input: LoadCsvDncEntriesInput): Pr
     }[];
     guidance: string;
 }>;
+export declare function listDncEntriesTool(input?: ListDncEntriesInput): Promise<{
+    ok: boolean;
+    workspaceId: string;
+    workspaceName: string;
+    pagination: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+    listNames: string[];
+    entries: {
+        id: string | null;
+        type: string;
+        domain: string | null;
+        linkedin: string | null;
+        linkedinUsername: string | null;
+        name: string | null;
+        source: {
+            type: string;
+            label: string;
+            listName: string | null;
+        };
+        createdAt: string | null;
+    }[];
+    guidance: string;
+}>;
 export declare function saveDomainFilters(input: SaveDomainFiltersInput): Promise<unknown>;
 export declare function lookupSalesNavFilter(input: LookupSalesNavFilterInput): Promise<{
     filterType: string;

package/dist/tools/leads.js

@@ -4,7 +4,7 @@ import { getApi, SellableApiError } from "../api.js";
 import { resolveSkillsDir } from "../skills.js";
 import { resolveWorkspaceRoot } from "../utils/workspace-root.js";
 import { buildCsvDomainPreview, matchesConfirmationToken, parseConfirmationToken, projectCsvCarryRows, } from "./csv-domains.js";
-import { loadCsvDncEntries, } from "./csv-dnc.js";
+import { listDncEntries, loadCsvDncEntries, } from "./csv-dnc.js";
 import { buildCsvLinkedinPreview, matchesLinkedinConfirmationToken, parseLinkedinConfirmationToken, uploadCsvLinkedinFile, } from "./csv-linkedin.js";
 import { assertInteractionApproval } from "./interaction-mode.js";
 import { assertProviderPromptLoaded, markProviderPromptLoaded, } from "./provider-preflight.js";
@@ -1477,6 +1477,41 @@ export const leadToolDefinitions = [
             required: ["filePath"],
         },
     },
+    {
+        name: "list_dnc_entries",
+        description: "Show the active workspace's current Sellable DNC count, list names, and a compact page of entries through the workspace-scoped DNC endpoint. Use this when the user asks to show/check the current DNC list, count, or first page before importing. This is Sellable DNC used by DNC Check, not provider source-list routing.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: {
+                    type: "number",
+                    description: "Page to read. Defaults to 1.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Entries per page. Defaults to 25. Backend hard cap is 100.",
+                },
+                search: {
+                    type: "string",
+                    description: "Optional search across domain, LinkedIn username, or entry name.",
+                },
+                listName: {
+                    type: "string",
+                    description: "Optional Sellable DNC list name filter.",
+                },
+                sourceType: {
+                    type: "string",
+                    enum: ["all", "manual", "hubspot"],
+                    description: "Optional source filter. Defaults to all Sellable DNC entries.",
+                },
+                includeDeleted: {
+                    type: "boolean",
+                    description: "Include deleted/disabled source entries when true. Defaults to false.",
+                },
+            },
+            required: [],
+        },
+    },
     {
         name: "load_csv_dnc_entries",
         description: "Preview and confirm pasted text, pasted CSV, or a CSV file of domains and LinkedIn profile URLs, then add the valid entries to the active workspace's Sellable DNC list. This is the blocklist/suppression-list path. It reuses Sellable's workspace-scoped DNC endpoints and the campaign DNC Check column, not provider search filters or source-list workarounds.",
@@ -3384,6 +3419,9 @@ export async function loadCsvLinkedinLeads(input) {
 export async function loadCsvDncEntriesTool(input) {
     return loadCsvDncEntries(input);
 }
+export async function listDncEntriesTool(input = {}) {
+    return listDncEntries(input);
+}
 export async function saveDomainFilters(input) {
     const api = getApi();
     return api.post(`/api/v3/prospeo/domain-filters`, {

package/dist/tools/registry.d.ts

@@ -1897,6 +1897,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -1904,7 +1909,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2085,6 +2089,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -2092,7 +2101,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2172,6 +2180,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -2179,7 +2192,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2331,6 +2343,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -2338,7 +2355,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2432,6 +2448,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -2439,7 +2460,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2542,6 +2562,11 @@ export declare const allTools: ({
             query?: undefined;
             keywords?: undefined;
             domainColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -2549,7 +2574,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2579,6 +2603,109 @@ export declare const allTools: ({
         };
         required: string[];
     };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            page: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            search: {
+                type: string;
+                description: string;
+            };
+            listName: {
+                type: string;
+                description: string;
+            };
+            sourceType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            includeDeleted: {
+                type: string;
+                description: string;
+            };
+            provider?: undefined;
+            campaignOfferId?: undefined;
+            confirmed?: undefined;
+            searchMode?: undefined;
+            organization_num_employees_ranges?: undefined;
+            organization_locations?: undefined;
+            organization_not_locations?: undefined;
+            q_organization_keyword_tags?: undefined;
+            organization_industry_tag_ids?: undefined;
+            latest_funding_amount_min?: undefined;
+            latest_funding_amount_max?: undefined;
+            organization_revenue_min?: undefined;
+            organization_revenue_max?: undefined;
+            person_titles?: undefined;
+            person_seniorities?: undefined;
+            person_locations?: undefined;
+            include_similar_titles?: undefined;
+            q_keywords?: undefined;
+            filters?: undefined;
+            companyFilters?: undefined;
+            contactFilters?: undefined;
+            searchId?: undefined;
+            searchName?: undefined;
+            companySearchMode?: undefined;
+            uploadedDomains?: undefined;
+            currentStep?: undefined;
+            filterType?: undefined;
+            query?: undefined;
+            keywords?: undefined;
+            filePath?: undefined;
+            domainColumn?: undefined;
+            selectedColumns?: undefined;
+            confirmationToken?: undefined;
+            leadListId?: undefined;
+            leadListName?: undefined;
+            linkedInColumn?: undefined;
+            csvText?: undefined;
+            rawText?: undefined;
+            name?: undefined;
+            include?: undefined;
+            exclude?: undefined;
+            seedCompanies?: undefined;
+            seedDomains?: undefined;
+            sort?: undefined;
+            previewOnly?: undefined;
+            companySearchToken?: undefined;
+            selectedCompanyIds?: undefined;
+            domainFilterId?: undefined;
+            type?: undefined;
+            profileUrl?: undefined;
+            postUrl?: undefined;
+            companyUrl?: undefined;
+            headlineICPCriteria?: undefined;
+            rubricGuidelines?: undefined;
+            sourceLeadListId?: undefined;
+            targetLeadCount?: undefined;
+            mode?: undefined;
+            targetEngagerCount?: undefined;
+            maxPostsToScrape?: undefined;
+            tableId?: undefined;
+            campaignName?: undefined;
+            keepInSync?: undefined;
+            jobId?: undefined;
+            reviewBatchLimit?: undefined;
+            allowPartialSourceList?: undefined;
+            includeRawImportResult?: undefined;
+            selections?: undefined;
+            selectionMode?: undefined;
+            scrapePlanMode?: undefined;
+        };
+        required: never[];
+    };
 } | {
     name: string;
     description: string;
@@ -2649,11 +2776,15 @@ export declare const allTools: ({
             selectedColumns?: undefined;
             leadListId?: undefined;
             leadListName?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             include?: undefined;
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -2740,12 +2871,16 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -3627,6 +3762,10 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -3726,13 +3865,17 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             include?: undefined;
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             domainFilterId?: undefined;
@@ -4763,6 +4906,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -4770,7 +4918,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -4913,6 +5060,10 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -5045,6 +5196,11 @@ export declare const allTools: ({
             confirmationToken?: undefined;
             leadListId?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -5052,7 +5208,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -5129,6 +5284,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -5136,7 +5296,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -5249,6 +5408,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -5256,7 +5420,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -5374,6 +5537,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -5381,7 +5549,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;
@@ -5463,6 +5630,11 @@ export declare const allTools: ({
             leadListId?: undefined;
             leadListName?: undefined;
             linkedInColumn?: undefined;
+            limit?: undefined;
+            search?: undefined;
+            listName?: undefined;
+            sourceType?: undefined;
+            includeDeleted?: undefined;
             csvText?: undefined;
             rawText?: undefined;
             name?: undefined;
@@ -5470,7 +5642,6 @@ export declare const allTools: ({
             exclude?: undefined;
             seedCompanies?: undefined;
             seedDomains?: undefined;
-            limit?: undefined;
             sort?: undefined;
             previewOnly?: undefined;
             companySearchToken?: undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sellable/mcp",
-  "version": "0.1.254",
+  "version": "0.1.255",
   "type": "module",
   "description": "Sellable MCP server for Claude Code and Codex campaign workflows",
   "main": "dist/index.js",

package/skills/create-campaign/SKILL.md

@@ -58,6 +58,7 @@ allowed-tools:
   - mcp__sellable__get_rows
   - mcp__sellable__get_rows_minimal
   - mcp__sellable__get_table_rows
+  - mcp__sellable__list_dnc_entries
   - mcp__sellable__load_csv_dnc_entries
   - mcp__sellable__load_csv_linkedin_leads
   - mcp__sellable__load_csv_domains
@@ -101,6 +102,11 @@ are for known-account targeting only, not DNC. Campaign creation already
 includes a `DNC Check` column that checks domain and LinkedIn profile before
 message generation.
 
+If the user asks to show/check the current DNC list, count, list names, or first
+page before importing, call `list_dnc_entries`. Confirm the active workspace
+name and ID in the response before any write. This is Sellable's workspace DNC
+list used by DNC Check.
+
 ## Opening Turn Contract
 
 On the first visible response after this skill is invoked, do not narrate

package/skills/create-campaign-v2/references/filter-leads.md

@@ -219,6 +219,8 @@ belong in the recommendation as DNC/suppression instructions outside the rubric
 DNC imports/suppression lists are handled through `load_csv_dnc_entries` outside
 `leadScoringRubrics`. The import previews the exact Sellable workspace name and
 ID, then writes to Sellable's workspace-level DNC list only after confirmation.
+If the user asks to show the current DNC count, list names, or first page before
+import, call `list_dnc_entries` and report the active workspace name and ID.
 Campaign creation already includes `DNC Check`, which checks domain/profile
 before message generation. Do not describe provider workarounds, provider
 search-time limitations, or Prospeo domain filters as the DNC mechanism.

package/skills/create-campaign-v2/references/lead-validation-preview.md

@@ -50,6 +50,8 @@ Supplied-source preview:
   preview. Preview the exact Sellable workspace name and ID and confirm before
   writing. This updates Sellable's workspace-level DNC list; it is not a lead
   source, Prospeo domain filter, or provider workaround.
+  If the user asks for the existing DNC count, list names, or first page first,
+  call `list_dnc_entries` and report the active workspace name and ID.
 - `supplied-linkedin-profiles` uses `load_csv_linkedin_leads` before the
   15-lead import batch only as preview/source attachment. Pre-import calls
   must omit provider-import parameters. Use `campaignOfferId` only to attach the

package/skills/create-campaign-v2/references/step-13-import-leads.md

@@ -61,7 +61,9 @@ Supported branches:
   Sellable workspace name and ID, and confirmation writes only to that
   workspace's Sellable DNC list. This is not a lead source and does not create a
   `domainFilterId`; campaign rows are protected later by the existing
-  `DNC Check` column before message generation.
+  `DNC Check` column before message generation. If the user asks for the
+  current DNC count, list names, or first page before import, call
+  `list_dnc_entries` first.
 - **Supplied LinkedIn profile CSV** — confirm `load_csv_linkedin_leads` only
   after the user approves that supplied-list source. Batch/materialize the
   uploaded CSV into a Sellable lead-list table. Persist the returned

package/skills/find-leads/SKILL.md

@@ -90,6 +90,7 @@ should stay focused on source evidence.
 - `mcp__sellable__search_prospeo`
 - `mcp__sellable__search_prospeo_companies`
 - `mcp__sellable__confirm_prospeo_company_accounts`
+- `mcp__sellable__list_dnc_entries`
 - `mcp__sellable__load_csv_dnc_entries`
 - `mcp__sellable__load_csv_domains`
 - `mcp__sellable__load_csv_linkedin_leads`
@@ -105,6 +106,9 @@ should stay focused on source evidence.
   list after confirming the exact active workspace. Keep the mechanism to
   Sellable DNC and `DNC Check`, not provider search work or Prospeo domain
   filters.
+- If the user asks to see the current DNC count, list names, or first page
+  before import, call `list_dnc_entries`. Report the active workspace name and
+  ID from the tool response before any DNC write.
 - Do not infer sender identities from meeting attendance alone. Only treat someone as a sender when the source material explicitly identifies them as a sender or supplies their LinkedIn URL.
 - Do not ask Layer 1 questions already answered by a transcript, ICP doc, or Layer 0 research.
 - Do not include Apollo in the explorer set for this phase.
@@ -136,6 +140,8 @@ Execution flow:
      DNC entries.
    - Campaign creation already includes `DNC Check`, which checks domain/profile
      before message generation.
+   - If the user wants the existing DNC count or first page first, call
+     `list_dnc_entries` before previewing the import.
 3. If the user has a CSV of LinkedIn profile URLs on disk, call `load_csv_linkedin_leads` first.
    - Preview, confirm, then review the resulting lead list before `confirm_lead_list`.
    - Confirmed execution uploads the raw CSV file, starts the server-owned import job, and waits on lead-list readiness before returning.