@leadbay/mcp 0.23.13 → 0.23.14

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @leadbay/mcp
 
+## 0.23.14 — 2026-07-03
+
+Registry: publish the hosted remote endpoint so GitHub Copilot / VS Code can offer Leadbay as a one-click remote connector (product#3861).
+
+- **`server.json` `remotes`** — the registry entry now advertises the hosted Streamable HTTP endpoint (`https://mcp.leadbay.app/mcp`) alongside the npm package. Landed in code in 0.23.13 but needs this version bump to actually re-publish to the MCP Registry (the registry won't re-publish an already-published version). Auth is standard MCP OAuth (discovered via `.well-known`), so no header/API-key declaration.
+
 ## 0.23.13 — 2026-07-03
 
 Directory-submission schema fix.

package/dist/bin.js

@@ -5931,7 +5931,7 @@ WHEN NOT TO USE: as a substitute for leadbay_research_lead_by_id \u2014 that alr
 
 ## CREDIT COST \u2014 show the balance, discreetly
 
-Once \`all_done\` is true the result carries \`credits_remaining\` (the post-spend AI-credit balance). Don't make a fuss \u2014 no sentence, no callout. Just append ONE small italic line in parentheses at the very END of your reply: \`_(N credits remaining)_\`. If \`credits_remaining\` is null (billing unavailable), omit the line \u2014 don't print 0. Do NOT report a "credits used" figure for this run: the per-contact cost can't be scoped to this specific enrichment (a lead's contact list mixes in earlier runs), so any "X used" number would be misleading.
+Once \`all_done\` is true the result carries \`credits_remaining\` (the post-spend AI-credit balance). Don't make a fuss \u2014 no sentence, no callout. Just append ONE small italic line in parentheses at the very END of your reply: \`_(N credits remaining)_\`. If \`credits_remaining\` is null (billing unavailable), omit the line \u2014 don't print 0. If \`credits_remaining\` is the string \`"unlimited"\` (internal/unlimited account), also omit the line \u2014 there is no finite balance to show; do NOT print "unlimited". Do NOT report a "credits used" figure for this run: the per-contact cost can't be scoped to this specific enrichment (a lead's contact list mixes in earlier runs), so any "X used" number would be misleading.
 `;
     leadbay_bulk_qualify_leads = `Pick the next N unqualified leads in the active lens and qualify them (run AI rescore + web fetch). Pass \`wait_for_completion:false\` to return quickly with \`{status:'running', qualify_id}\`; poll leadbay_qualify_status with that id. With \`wait_for_completion\` omitted/true, the legacy behavior polls until the answers are populated or a budget is exhausted. Already-qualified leads (those with a non-null \`ai_agent_lead_score\`) are silently no-ops on the backend, so this composite paginates past them to find fresh candidates. On 429 mid-fanout, stops launching but keeps polling already-launched leads.
 
@@ -6411,7 +6411,7 @@ WHEN NOT TO USE: for bulk enrichment by job title across many leads \u2014 use l
 
 ## CREDIT COST \u2014 discreet
 
-This is a paid call. The result returns \`credits_remaining\` (billing.ai_credits, read before the spend). Don't make a fuss about credits: only flag the balance if it's low (e.g. \u2264 a few credits) so the user can decide. Otherwise append it quietly as a small italic parenthetical at the END of your reply \u2014 \`_(N credits remaining)_\`. Don't quote an exact per-contact cost (the rate is backend-only). The actual per-contact cost (enrichment.credits_used) appears on the contact via leadbay_get_contacts after enrichment. If \`credits_remaining\` is null, omit the line \u2014 don't assume zero.
+This is a paid call. The result returns \`credits_remaining\` (billing.ai_credits, read before the spend). Don't make a fuss about credits: only flag the balance if it's low (e.g. \u2264 a few credits) so the user can decide. Otherwise append it quietly as a small italic parenthetical at the END of your reply \u2014 \`_(N credits remaining)_\`. Don't quote an exact per-contact cost (the rate is backend-only). The actual per-contact cost (enrichment.credits_used) appears on the contact via leadbay_get_contacts after enrichment. If \`credits_remaining\` is null, omit the line \u2014 don't assume zero. If \`credits_remaining\` is the string \`"unlimited"\` (internal/unlimited account), also omit the line and proceed freely \u2014 do NOT print "unlimited" and never tell the user they're out of credits.
 
 This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible for confirming intent before invocation; the MCP server does not soft-prompt for confirmation. See \`annotations.destructiveHint\`.
 `;
@@ -6425,9 +6425,9 @@ WHEN NOT TO USE: to enrich a single contact \u2014 that's leadbay_enrich_contact
 
 Enrichment is the main PAID operation. Surface cost both before and after.
 
-**BEFORE (confirm before launching).** The discover / preview_only / dry_run modes return \`credits_remaining\` (the balance) and \`enrichable_contacts\` (the volume that would be enriched). Tell the user plainly: **"You have {credits_remaining} credits. This will enrich {enrichable_contacts} contacts."** then ask them to confirm before you launch the paid run. Route that confirmation through \`ask_user_input_v0\` ("Enrich {enrichable_contacts} contacts now?" \u2192 ["Yes, enrich", "No, cancel"]). Do NOT state an exact estimated cost \u2014 the per-contact credit rate lives backend-side and is not in the preview; show the balance and the count, never a fabricated "will cost N credits". If \`credits_remaining\` is null, billing is unavailable \u2014 say the balance is unknown, don't assume zero or unlimited.
+**BEFORE (confirm before launching).** The discover / preview_only / dry_run modes return \`credits_remaining\` (the balance) and \`enrichable_contacts\` (the volume that would be enriched). Tell the user plainly: **"You have {credits_remaining} credits. This will enrich {enrichable_contacts} contacts."** then ask them to confirm before you launch the paid run. Route that confirmation through \`ask_user_input_v0\` ("Enrich {enrichable_contacts} contacts now?" \u2192 ["Yes, enrich", "No, cancel"]). Do NOT state an exact estimated cost \u2014 the per-contact credit rate lives backend-side and is not in the preview; show the balance and the count, never a fabricated "will cost N credits". If \`credits_remaining\` is null, billing is unavailable \u2014 say the balance is unknown, don't assume zero or unlimited. If \`credits_remaining\` is the string \`"unlimited"\`, this is an internal/unlimited account: proceed freely and say NOTHING about credits \u2014 drop the "You have {credits_remaining} credits" sentence entirely (still name the count and still confirm before launching); do NOT announce "unlimited" and never tell the user they're out of credits.
 
-**AFTER (show the balance, discreetly).** Once the job finishes \u2014 poll \`leadbay_bulk_enrich_status\`, which returns \`credits_remaining\` (the post-spend balance). Don't make a fuss: append ONE small italic line in parentheses at the very END of your reply \u2014 \`_(N credits remaining)_\`. Omit it if \`credits_remaining\` is null. Do NOT report a "credits used" figure: per-run cost can't be scoped reliably (a lead's contacts mix earlier enrichments), so only the balance is shown.
+**AFTER (show the balance, discreetly).** Once the job finishes \u2014 poll \`leadbay_bulk_enrich_status\`, which returns \`credits_remaining\` (the post-spend balance). Don't make a fuss: append ONE small italic line in parentheses at the very END of your reply \u2014 \`_(N credits remaining)_\`. Omit it if \`credits_remaining\` is null. Omit it too if \`credits_remaining\` is the string \`"unlimited"\` (internal/unlimited account) \u2014 do NOT print \`_(unlimited credits remaining)_\` or otherwise announce unlimited. Do NOT report a "credits used" figure: per-run cost can't be scoped reliably (a lead's contacts mix earlier enrichments), so only the balance is shown.
 
 ## GATE \u2014 PREFER BUILT-IN HOST WIDGETS
 
@@ -9962,11 +9962,34 @@ var init_qualify_lead = __esm({
   }
 });
 
+// ../core/dist/composite/_credits-helpers.js
+function isUnlimitedAccount(me) {
+  return me.email?.toLowerCase().trim().endsWith("@leadbay.ai") ?? false;
+}
+async function readCreditsRemaining(client, force = false) {
+  try {
+    const me = await client.resolveMe(force);
+    if (isUnlimitedAccount(me))
+      return UNLIMITED;
+    return me.organization.billing?.ai_credits ?? null;
+  } catch {
+    return null;
+  }
+}
+var UNLIMITED;
+var init_credits_helpers = __esm({
+  "../core/dist/composite/_credits-helpers.js"() {
+    "use strict";
+    UNLIMITED = "unlimited";
+  }
+});
+
 // ../core/dist/tools/enrich-contacts.js
 var enrichContacts;
 var init_enrich_contacts = __esm({
   "../core/dist/tools/enrich-contacts.js"() {
     "use strict";
+    init_credits_helpers();
     init_tool_descriptions_generated();
     enrichContacts = {
       name: "leadbay_enrich_contacts",
@@ -10011,9 +10034,13 @@ var init_enrich_contacts = __esm({
         let creditsRemaining = null;
         try {
           const me = await client.request("GET", "/users/me");
-          creditsRemaining = me.organization.billing?.ai_credits ?? null;
-          if (creditsRemaining !== null && creditsRemaining <= 0) {
-            throw client.makeError("QUOTA_EXCEEDED", "No enrichment credits remaining", "Contact Leadbay support to extend your credit quota");
+          if (isUnlimitedAccount(me)) {
+            creditsRemaining = UNLIMITED;
+          } else {
+            creditsRemaining = me.organization.billing?.ai_credits ?? null;
+            if (typeof creditsRemaining === "number" && creditsRemaining <= 0) {
+              throw client.makeError("QUOTA_EXCEEDED", "No enrichment credits remaining", "Contact Leadbay support to extend your credit quota");
+            }
           }
         } catch (e) {
           if (e?.code === "QUOTA_EXCEEDED")
@@ -17421,6 +17448,7 @@ var init_account_status = __esm({
   "../core/dist/composite/account-status.js"() {
     "use strict";
     init_agent_memory();
+    init_credits_helpers();
     init_tool_descriptions_generated();
     accountStatus = {
       name: "leadbay_account_status",
@@ -17458,7 +17486,11 @@ var init_account_status = __esm({
                 type: "boolean",
                 description: "True if Leadbay is mid-regenerating intelligence after a refine_prompt; new leads will reflect it shortly."
               },
-              plan: { type: ["string", "null"] }
+              plan: { type: ["string", "null"] },
+              unlimited_credits: {
+                type: "boolean",
+                description: "True for internal/unlimited accounts (billing disabled server-side). When true, DO NOT read the null `plan` or absent quota as 'no credits' \u2014 the account has unlimited credits; enrichment/qualify proceed freely. Stay SILENT on credits: don't announce 'unlimited', don't show a balance, and never tell the user they're out of credits. False for normal accounts, where the usual quota/credit story applies."
+              }
             }
           },
           last_requested_lens: {
@@ -17562,7 +17594,11 @@ var init_account_status = __esm({
             name: me.organization.name,
             ai_agent_enabled: me.organization.ai_agent_enabled ?? false,
             computing_intelligence: me.organization.computing_intelligence ?? false,
-            plan: quota?.plan ?? me.organization.quota_plan ?? null
+            plan: quota?.plan ?? me.organization.quota_plan ?? null,
+            // Internal/unlimited account (billing disabled). The backend zeroes
+            // plan/quota for these, so without this flag the agent misreads
+            // plan:null as "no credits" and refuses enrichment. product#3851.
+            unlimited_credits: isUnlimitedAccount(me)
           },
           // Lens is withheld unless the user asked (lensAsked, above). When present,
           // the id is normalized to the STRING form (my-lenses.ts) so it matches the
@@ -19976,21 +20012,6 @@ var init_qualify_status = __esm({
   }
 });
 
-// ../core/dist/composite/_credits-helpers.js
-async function readCreditsRemaining(client, force = false) {
-  try {
-    const me = await client.resolveMe(force);
-    return me.organization.billing?.ai_credits ?? null;
-  } catch {
-    return null;
-  }
-}
-var init_credits_helpers = __esm({
-  "../core/dist/composite/_credits-helpers.js"() {
-    "use strict";
-  }
-});
-
 // ../core/dist/composite/enrich-titles.js
 var DEFAULT_CANDIDATE_COUNT, enrichTitles;
 var init_enrich_titles = __esm({
@@ -20081,8 +20102,8 @@ var init_enrich_titles = __esm({
             description: "Count of enrichable contacts at preview time."
           },
           credits_remaining: {
-            type: ["number", "null"],
-            description: "AI-credit balance BEFORE launching (billing.ai_credits). Present in discover / preview_only / dry_run modes. Pair with enrichable_contacts to tell the user 'you have N credits, this will enrich M contacts' \u2014 do NOT estimate an exact cost (the per-contact rate is backend-only). Null = billing unavailable."
+            type: ["number", "string", "null"],
+            description: `AI-credit balance BEFORE launching (billing.ai_credits). Present in discover / preview_only / dry_run modes. Pair with enrichable_contacts to tell the user 'you have N credits, this will enrich M contacts' \u2014 do NOT estimate an exact cost (the per-contact rate is backend-only). Null = billing unavailable. The string "unlimited" = an internal/unlimited account: proceed with enrichment freely and say NOTHING about credits (no balance, no 'unlimited', no 'no credits').`
           },
           selected_lead_count: {
             type: "number",
@@ -20466,8 +20487,8 @@ var init_bulk_enrich_status = __esm({
             description: "True when overall_progress.done === total AND no partial_failures."
           },
           credits_remaining: {
-            type: ["number", "null"],
-            description: "AI-credit balance re-read after the spend (force-refreshed /users/me \u2192 billing.ai_credits). Present only when all_done. Null = billing unavailable (don't read as zero). NOTE: a per-run 'credits used' figure is intentionally NOT returned \u2014 getContacts can't scope cost to this bulk, so any sum would conflate historical enrichments."
+            type: ["number", "string", "null"],
+            description: `AI-credit balance re-read after the spend (force-refreshed /users/me \u2192 billing.ai_credits). Present only when all_done. Null = billing unavailable (don't read as zero). The string "unlimited" = an internal/unlimited account: omit the _(N credits remaining)_ line entirely (there is no finite balance to show). NOTE: a per-run 'credits used' figure is intentionally NOT returned \u2014 getContacts can't scope cost to this bulk, so any sum would conflate historical enrichments.`
           },
           partial_failures: {
             type: "array",
@@ -23260,7 +23281,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 
 # PHASE 0 \u2014 STATE + AUDIENCE
 
-Call \`leadbay_account_status\` to see my remaining quota, my **enrichment credits**, and my **active lens**. Note \`web_fetch_remaining\` (qualification budget) and the enrichment credit balance \u2014 Phase 3 spends credits.
+Call \`leadbay_account_status\` to see my remaining quota, my **enrichment credits**, and my **active lens**. Note \`web_fetch_remaining\` (qualification budget) and the enrichment credit balance \u2014 Phase 3 spends credits. If \`organization.unlimited_credits\` is true, this is an internal/unlimited account: skip every credit-balance mention below and proceed with enrichment freely \u2014 never tell me I'm out of credits.
 
 Resolve the audience:
 
@@ -23379,9 +23400,9 @@ Call \`leadbay_recall_ordered_titles({leadIds, lensId})\` and \`leadbay_enrich_t
 
 Tell me what you swapped in one line ("dropped Corbett + RBS \u2014 ops-only; swapped in Acme + Globex which have Sales VPs"). The goal is a final cohort where EVERY lead has a real buyer to call.
 
-**Step C \u2014 show the spend + persona and confirm.** State the persona, the chosen titles, and "You have {credits_remaining} credits; this enriches {enrichable_contacts} contacts." Confirm via \`ask_user_input_v0\` ("Enrich these {enrichable_contacts} <persona> contacts now?" \u2192 ["Yes, enrich", "No, skip", "Change the persona/titles"]). Never launch a paid run without this. Enrich up to the campaign size (default 20) best persona-matching contacts.
+**Step C \u2014 show the spend + persona and confirm.** State the persona, the chosen titles, and "You have {credits_remaining} credits; this enriches {enrichable_contacts} contacts." Confirm via \`ask_user_input_v0\` ("Enrich these {enrichable_contacts} <persona> contacts now?" \u2192 ["Yes, enrich", "No, skip", "Change the persona/titles"]). Never launch a paid run without this. Enrich up to the campaign size (default 20) best persona-matching contacts. (Unlimited account \u2014 \`credits_remaining\` is \`"unlimited"\` or \`unlimited_credits\` was true: drop the "You have {credits_remaining} credits" clause and just state the persona + count; still confirm before launching.)
 
-**Step D \u2014 launch + poll.** On yes: \`leadbay_enrich_titles({leadIds, lensId, titles:[...chosen], email:true, phone:true})\` to launch, then poll \`leadbay_bulk_enrich_status\` until done (enrichment can take several minutes \u2014 keep polling, don't render an empty sheet prematurely). Append one small line at the very end of your reply: \`_(N credits remaining)_\`.
+**Step D \u2014 launch + poll.** On yes: \`leadbay_enrich_titles({leadIds, lensId, titles:[...chosen], email:true, phone:true})\` to launch, then poll \`leadbay_bulk_enrich_status\` until done (enrichment can take several minutes \u2014 keep polling, don't render an empty sheet prematurely). Append one small line at the very end of your reply: \`_(N credits remaining)_\` \u2014 but omit it entirely when \`credits_remaining\` is \`"unlimited"\` (unlimited account has no finite balance to show).
 
 If I skip enrichment, continue \u2014 the campaign can be enriched later from the call sheet.
 
@@ -23411,7 +23432,7 @@ Then STOP. Building a campaign is NOT outreaching \u2014 do not send anything an
 - Enrichment targets MY buyer persona \u2014 the people who would actually buy what *I* sell, derived from my product/ICP \u2014 NOT generic seniority. For a sales/prospecting tool that means the revenue org (sales / BD / growth / marketing leaders); a Director of Operations, COO, or logistics manager is useless no matter how senior. Get the persona right or the campaign is worthless.
 - Selection is DATA-DRIVEN (\`leadbay_recall_ordered_titles\` + \`leadbay_enrich_titles\` discovery) but FILTERED to the persona \u2014 never blindly repeat past-enriched or suggested titles that don't match who buys my product.
 - The FINAL cohort must be all buyer-ready: drop/swap any lead with no enrichable buyer-persona contact (Phase 3 Step B.5) rather than shipping it empty. A campaign where half the leads have no buyer to call is a failed campaign. Pick a generous pool in Phase 2 so swaps are possible.
-- NEVER launch paid enrichment without showing \`credits_remaining\` + \`enrichable_contacts\`, naming the persona, and getting a yes.
+- NEVER launch paid enrichment without showing \`credits_remaining\` + \`enrichable_contacts\`, naming the persona, and getting a yes. (Exception on an unlimited account \u2014 \`credits_remaining\` is \`"unlimited"\` / \`unlimited_credits\` true: skip the \`credits_remaining\` display only; still show \`enrichable_contacts\`, name the persona, and get a yes.)
 - Qualify / pick BEFORE \`leadbay_create_campaign\` \u2014 never seed a campaign with unvetted leads.
 - Carry the captured \`lensId\` on every call. A lens shift loses the cohort.
 - End at the rendered call sheet, then hand off to \`leadbay_work_campaign\`. Do NOT re-implement the calling / follow-up loop here, and do NOT call \`leadbay_report_outreach\`.
@@ -27812,7 +27833,7 @@ var OAUTH_BASE_URLS = {
     fr: "https://staging.api.leadbay.app"
   }
 };
-var VERSION = "0.23.13";
+var VERSION = "0.23.14";
 var HELP = `
 leadbay-mcp ${VERSION} \u2014 Leadbay Model Context Protocol server
 

package/dist/http-server.js

@@ -75,7 +75,7 @@ If \`pull_leads\` itself fails and you have no prior batch, then yes \u2014 retr
 
 # PHASE 0 \u2014 STATE + AUDIENCE
 
-Call \`leadbay_account_status\` to see my remaining quota, my **enrichment credits**, and my **active lens**. Note \`web_fetch_remaining\` (qualification budget) and the enrichment credit balance \u2014 Phase 3 spends credits.
+Call \`leadbay_account_status\` to see my remaining quota, my **enrichment credits**, and my **active lens**. Note \`web_fetch_remaining\` (qualification budget) and the enrichment credit balance \u2014 Phase 3 spends credits. If \`organization.unlimited_credits\` is true, this is an internal/unlimited account: skip every credit-balance mention below and proceed with enrichment freely \u2014 never tell me I'm out of credits.
 
 Resolve the audience:
 
@@ -194,9 +194,9 @@ Call \`leadbay_recall_ordered_titles({leadIds, lensId})\` and \`leadbay_enrich_t
 
 Tell me what you swapped in one line ("dropped Corbett + RBS \u2014 ops-only; swapped in Acme + Globex which have Sales VPs"). The goal is a final cohort where EVERY lead has a real buyer to call.
 
-**Step C \u2014 show the spend + persona and confirm.** State the persona, the chosen titles, and "You have {credits_remaining} credits; this enriches {enrichable_contacts} contacts." Confirm via \`ask_user_input_v0\` ("Enrich these {enrichable_contacts} <persona> contacts now?" \u2192 ["Yes, enrich", "No, skip", "Change the persona/titles"]). Never launch a paid run without this. Enrich up to the campaign size (default 20) best persona-matching contacts.
+**Step C \u2014 show the spend + persona and confirm.** State the persona, the chosen titles, and "You have {credits_remaining} credits; this enriches {enrichable_contacts} contacts." Confirm via \`ask_user_input_v0\` ("Enrich these {enrichable_contacts} <persona> contacts now?" \u2192 ["Yes, enrich", "No, skip", "Change the persona/titles"]). Never launch a paid run without this. Enrich up to the campaign size (default 20) best persona-matching contacts. (Unlimited account \u2014 \`credits_remaining\` is \`"unlimited"\` or \`unlimited_credits\` was true: drop the "You have {credits_remaining} credits" clause and just state the persona + count; still confirm before launching.)
 
-**Step D \u2014 launch + poll.** On yes: \`leadbay_enrich_titles({leadIds, lensId, titles:[...chosen], email:true, phone:true})\` to launch, then poll \`leadbay_bulk_enrich_status\` until done (enrichment can take several minutes \u2014 keep polling, don't render an empty sheet prematurely). Append one small line at the very end of your reply: \`_(N credits remaining)_\`.
+**Step D \u2014 launch + poll.** On yes: \`leadbay_enrich_titles({leadIds, lensId, titles:[...chosen], email:true, phone:true})\` to launch, then poll \`leadbay_bulk_enrich_status\` until done (enrichment can take several minutes \u2014 keep polling, don't render an empty sheet prematurely). Append one small line at the very end of your reply: \`_(N credits remaining)_\` \u2014 but omit it entirely when \`credits_remaining\` is \`"unlimited"\` (unlimited account has no finite balance to show).
 
 If I skip enrichment, continue \u2014 the campaign can be enriched later from the call sheet.
 
@@ -226,7 +226,7 @@ Then STOP. Building a campaign is NOT outreaching \u2014 do not send anything an
 - Enrichment targets MY buyer persona \u2014 the people who would actually buy what *I* sell, derived from my product/ICP \u2014 NOT generic seniority. For a sales/prospecting tool that means the revenue org (sales / BD / growth / marketing leaders); a Director of Operations, COO, or logistics manager is useless no matter how senior. Get the persona right or the campaign is worthless.
 - Selection is DATA-DRIVEN (\`leadbay_recall_ordered_titles\` + \`leadbay_enrich_titles\` discovery) but FILTERED to the persona \u2014 never blindly repeat past-enriched or suggested titles that don't match who buys my product.
 - The FINAL cohort must be all buyer-ready: drop/swap any lead with no enrichable buyer-persona contact (Phase 3 Step B.5) rather than shipping it empty. A campaign where half the leads have no buyer to call is a failed campaign. Pick a generous pool in Phase 2 so swaps are possible.
-- NEVER launch paid enrichment without showing \`credits_remaining\` + \`enrichable_contacts\`, naming the persona, and getting a yes.
+- NEVER launch paid enrichment without showing \`credits_remaining\` + \`enrichable_contacts\`, naming the persona, and getting a yes. (Exception on an unlimited account \u2014 \`credits_remaining\` is \`"unlimited"\` / \`unlimited_credits\` true: skip the \`credits_remaining\` display only; still show \`enrichable_contacts\`, name the persona, and get a yes.)
 - Qualify / pick BEFORE \`leadbay_create_campaign\` \u2014 never seed a campaign with unvetted leads.
 - Carry the captured \`lensId\` on every call. A lens shift loses the cohort.
 - End at the rendered call sheet, then hand off to \`leadbay_work_campaign\`. Do NOT re-implement the calling / follow-up loop here, and do NOT call \`leadbay_report_outreach\`.
@@ -7061,7 +7061,7 @@ WHEN NOT TO USE: as a substitute for leadbay_research_lead_by_id \u2014 that alr
 
 ## CREDIT COST \u2014 show the balance, discreetly
 
-Once \`all_done\` is true the result carries \`credits_remaining\` (the post-spend AI-credit balance). Don't make a fuss \u2014 no sentence, no callout. Just append ONE small italic line in parentheses at the very END of your reply: \`_(N credits remaining)_\`. If \`credits_remaining\` is null (billing unavailable), omit the line \u2014 don't print 0. Do NOT report a "credits used" figure for this run: the per-contact cost can't be scoped to this specific enrichment (a lead's contact list mixes in earlier runs), so any "X used" number would be misleading.
+Once \`all_done\` is true the result carries \`credits_remaining\` (the post-spend AI-credit balance). Don't make a fuss \u2014 no sentence, no callout. Just append ONE small italic line in parentheses at the very END of your reply: \`_(N credits remaining)_\`. If \`credits_remaining\` is null (billing unavailable), omit the line \u2014 don't print 0. If \`credits_remaining\` is the string \`"unlimited"\` (internal/unlimited account), also omit the line \u2014 there is no finite balance to show; do NOT print "unlimited". Do NOT report a "credits used" figure for this run: the per-contact cost can't be scoped to this specific enrichment (a lead's contact list mixes in earlier runs), so any "X used" number would be misleading.
 `;
 var leadbay_bulk_qualify_leads = `Pick the next N unqualified leads in the active lens and qualify them (run AI rescore + web fetch). Pass \`wait_for_completion:false\` to return quickly with \`{status:'running', qualify_id}\`; poll leadbay_qualify_status with that id. With \`wait_for_completion\` omitted/true, the legacy behavior polls until the answers are populated or a budget is exhausted. Already-qualified leads (those with a non-null \`ai_agent_lead_score\`) are silently no-ops on the backend, so this composite paginates past them to find fresh candidates. On 429 mid-fanout, stops launching but keeps polling already-launched leads.
 
@@ -7541,7 +7541,7 @@ WHEN NOT TO USE: for bulk enrichment by job title across many leads \u2014 use l
 
 ## CREDIT COST \u2014 discreet
 
-This is a paid call. The result returns \`credits_remaining\` (billing.ai_credits, read before the spend). Don't make a fuss about credits: only flag the balance if it's low (e.g. \u2264 a few credits) so the user can decide. Otherwise append it quietly as a small italic parenthetical at the END of your reply \u2014 \`_(N credits remaining)_\`. Don't quote an exact per-contact cost (the rate is backend-only). The actual per-contact cost (enrichment.credits_used) appears on the contact via leadbay_get_contacts after enrichment. If \`credits_remaining\` is null, omit the line \u2014 don't assume zero.
+This is a paid call. The result returns \`credits_remaining\` (billing.ai_credits, read before the spend). Don't make a fuss about credits: only flag the balance if it's low (e.g. \u2264 a few credits) so the user can decide. Otherwise append it quietly as a small italic parenthetical at the END of your reply \u2014 \`_(N credits remaining)_\`. Don't quote an exact per-contact cost (the rate is backend-only). The actual per-contact cost (enrichment.credits_used) appears on the contact via leadbay_get_contacts after enrichment. If \`credits_remaining\` is null, omit the line \u2014 don't assume zero. If \`credits_remaining\` is the string \`"unlimited"\` (internal/unlimited account), also omit the line and proceed freely \u2014 do NOT print "unlimited" and never tell the user they're out of credits.
 
 This tool MUTATES state. The caller (agent or human-in-the-loop) is responsible for confirming intent before invocation; the MCP server does not soft-prompt for confirmation. See \`annotations.destructiveHint\`.
 `;
@@ -7555,9 +7555,9 @@ WHEN NOT TO USE: to enrich a single contact \u2014 that's leadbay_enrich_contact
 
 Enrichment is the main PAID operation. Surface cost both before and after.
 
-**BEFORE (confirm before launching).** The discover / preview_only / dry_run modes return \`credits_remaining\` (the balance) and \`enrichable_contacts\` (the volume that would be enriched). Tell the user plainly: **"You have {credits_remaining} credits. This will enrich {enrichable_contacts} contacts."** then ask them to confirm before you launch the paid run. Route that confirmation through \`ask_user_input_v0\` ("Enrich {enrichable_contacts} contacts now?" \u2192 ["Yes, enrich", "No, cancel"]). Do NOT state an exact estimated cost \u2014 the per-contact credit rate lives backend-side and is not in the preview; show the balance and the count, never a fabricated "will cost N credits". If \`credits_remaining\` is null, billing is unavailable \u2014 say the balance is unknown, don't assume zero or unlimited.
+**BEFORE (confirm before launching).** The discover / preview_only / dry_run modes return \`credits_remaining\` (the balance) and \`enrichable_contacts\` (the volume that would be enriched). Tell the user plainly: **"You have {credits_remaining} credits. This will enrich {enrichable_contacts} contacts."** then ask them to confirm before you launch the paid run. Route that confirmation through \`ask_user_input_v0\` ("Enrich {enrichable_contacts} contacts now?" \u2192 ["Yes, enrich", "No, cancel"]). Do NOT state an exact estimated cost \u2014 the per-contact credit rate lives backend-side and is not in the preview; show the balance and the count, never a fabricated "will cost N credits". If \`credits_remaining\` is null, billing is unavailable \u2014 say the balance is unknown, don't assume zero or unlimited. If \`credits_remaining\` is the string \`"unlimited"\`, this is an internal/unlimited account: proceed freely and say NOTHING about credits \u2014 drop the "You have {credits_remaining} credits" sentence entirely (still name the count and still confirm before launching); do NOT announce "unlimited" and never tell the user they're out of credits.
 
-**AFTER (show the balance, discreetly).** Once the job finishes \u2014 poll \`leadbay_bulk_enrich_status\`, which returns \`credits_remaining\` (the post-spend balance). Don't make a fuss: append ONE small italic line in parentheses at the very END of your reply \u2014 \`_(N credits remaining)_\`. Omit it if \`credits_remaining\` is null. Do NOT report a "credits used" figure: per-run cost can't be scoped reliably (a lead's contacts mix earlier enrichments), so only the balance is shown.
+**AFTER (show the balance, discreetly).** Once the job finishes \u2014 poll \`leadbay_bulk_enrich_status\`, which returns \`credits_remaining\` (the post-spend balance). Don't make a fuss: append ONE small italic line in parentheses at the very END of your reply \u2014 \`_(N credits remaining)_\`. Omit it if \`credits_remaining\` is null. Omit it too if \`credits_remaining\` is the string \`"unlimited"\` (internal/unlimited account) \u2014 do NOT print \`_(unlimited credits remaining)_\` or otherwise announce unlimited. Do NOT report a "credits used" figure: per-run cost can't be scoped reliably (a lead's contacts mix earlier enrichments), so only the balance is shown.
 
 ## GATE \u2014 PREFER BUILT-IN HOST WIDGETS
 
@@ -11033,6 +11033,22 @@ var qualifyLead = {
   }
 };
 
+// ../core/dist/composite/_credits-helpers.js
+var UNLIMITED = "unlimited";
+function isUnlimitedAccount(me) {
+  return me.email?.toLowerCase().trim().endsWith("@leadbay.ai") ?? false;
+}
+async function readCreditsRemaining(client, force = false) {
+  try {
+    const me = await client.resolveMe(force);
+    if (isUnlimitedAccount(me))
+      return UNLIMITED;
+    return me.organization.billing?.ai_credits ?? null;
+  } catch {
+    return null;
+  }
+}
+
 // ../core/dist/tools/enrich-contacts.js
 var enrichContacts = {
   name: "leadbay_enrich_contacts",
@@ -11077,9 +11093,13 @@ var enrichContacts = {
     let creditsRemaining = null;
     try {
       const me = await client.request("GET", "/users/me");
-      creditsRemaining = me.organization.billing?.ai_credits ?? null;
-      if (creditsRemaining !== null && creditsRemaining <= 0) {
-        throw client.makeError("QUOTA_EXCEEDED", "No enrichment credits remaining", "Contact Leadbay support to extend your credit quota");
+      if (isUnlimitedAccount(me)) {
+        creditsRemaining = UNLIMITED;
+      } else {
+        creditsRemaining = me.organization.billing?.ai_credits ?? null;
+        if (typeof creditsRemaining === "number" && creditsRemaining <= 0) {
+          throw client.makeError("QUOTA_EXCEEDED", "No enrichment credits remaining", "Contact Leadbay support to extend your credit quota");
+        }
       }
     } catch (e) {
       if (e?.code === "QUOTA_EXCEEDED")
@@ -17975,7 +17995,11 @@ var accountStatus = {
             type: "boolean",
             description: "True if Leadbay is mid-regenerating intelligence after a refine_prompt; new leads will reflect it shortly."
           },
-          plan: { type: ["string", "null"] }
+          plan: { type: ["string", "null"] },
+          unlimited_credits: {
+            type: "boolean",
+            description: "True for internal/unlimited accounts (billing disabled server-side). When true, DO NOT read the null `plan` or absent quota as 'no credits' \u2014 the account has unlimited credits; enrichment/qualify proceed freely. Stay SILENT on credits: don't announce 'unlimited', don't show a balance, and never tell the user they're out of credits. False for normal accounts, where the usual quota/credit story applies."
+          }
         }
       },
       last_requested_lens: {
@@ -18079,7 +18103,11 @@ var accountStatus = {
         name: me.organization.name,
         ai_agent_enabled: me.organization.ai_agent_enabled ?? false,
         computing_intelligence: me.organization.computing_intelligence ?? false,
-        plan: quota?.plan ?? me.organization.quota_plan ?? null
+        plan: quota?.plan ?? me.organization.quota_plan ?? null,
+        // Internal/unlimited account (billing disabled). The backend zeroes
+        // plan/quota for these, so without this flag the agent misreads
+        // plan:null as "no credits" and refuses enrichment. product#3851.
+        unlimited_credits: isUnlimitedAccount(me)
       },
       // Lens is withheld unless the user asked (lensAsked, above). When present,
       // the id is normalized to the STRING form (my-lenses.ts) so it matches the
@@ -19835,16 +19863,6 @@ var qualifyStatus = {
   }
 };
 
-// ../core/dist/composite/_credits-helpers.js
-async function readCreditsRemaining(client, force = false) {
-  try {
-    const me = await client.resolveMe(force);
-    return me.organization.billing?.ai_credits ?? null;
-  } catch {
-    return null;
-  }
-}
-
 // ../core/dist/composite/enrich-titles.js
 var DEFAULT_CANDIDATE_COUNT = 25;
 var enrichTitles = {
@@ -19929,8 +19947,8 @@ var enrichTitles = {
         description: "Count of enrichable contacts at preview time."
       },
       credits_remaining: {
-        type: ["number", "null"],
-        description: "AI-credit balance BEFORE launching (billing.ai_credits). Present in discover / preview_only / dry_run modes. Pair with enrichable_contacts to tell the user 'you have N credits, this will enrich M contacts' \u2014 do NOT estimate an exact cost (the per-contact rate is backend-only). Null = billing unavailable."
+        type: ["number", "string", "null"],
+        description: `AI-credit balance BEFORE launching (billing.ai_credits). Present in discover / preview_only / dry_run modes. Pair with enrichable_contacts to tell the user 'you have N credits, this will enrich M contacts' \u2014 do NOT estimate an exact cost (the per-contact rate is backend-only). Null = billing unavailable. The string "unlimited" = an internal/unlimited account: proceed with enrichment freely and say NOTHING about credits (no balance, no 'unlimited', no 'no credits').`
       },
       selected_lead_count: {
         type: "number",
@@ -20304,8 +20322,8 @@ var bulkEnrichStatus = {
         description: "True when overall_progress.done === total AND no partial_failures."
       },
       credits_remaining: {
-        type: ["number", "null"],
-        description: "AI-credit balance re-read after the spend (force-refreshed /users/me \u2192 billing.ai_credits). Present only when all_done. Null = billing unavailable (don't read as zero). NOTE: a per-run 'credits used' figure is intentionally NOT returned \u2014 getContacts can't scope cost to this bulk, so any sum would conflate historical enrichments."
+        type: ["number", "string", "null"],
+        description: `AI-credit balance re-read after the spend (force-refreshed /users/me \u2192 billing.ai_credits). Present only when all_done. Null = billing unavailable (don't read as zero). The string "unlimited" = an internal/unlimited account: omit the _(N credits remaining)_ line entirely (there is no finite balance to show). NOTE: a per-run 'credits used' figure is intentionally NOT returned \u2014 getContacts can't scope cost to this bulk, so any sum would conflate historical enrichments.`
       },
       partial_failures: {
         type: "array",
@@ -24067,7 +24085,7 @@ function parseWriteEnv(env = process.env) {
 }
 
 // src/http-server.ts
-var VERSION = true ? "0.23.13" : "0.0.0-dev";
+var VERSION = true ? "0.23.14" : "0.0.0-dev";
 var PORT = Number(process.env.PORT ?? 8080);
 var HOST = process.env.HOST ?? "0.0.0.0";
 var sseSessions = /* @__PURE__ */ new Map();

package/dist/installer-electron.js

@@ -1804,7 +1804,7 @@ var init_installer_gui = __esm({
     init_install_dxt();
     init_install_shared();
     init_oauth();
-    VERSION = true ? "0.23.13" : "0.0.0-dev";
+    VERSION = true ? "0.23.14" : "0.0.0-dev";
     MESSAGES = {
       en: {
         installer: {

package/dist/installer-gui.js

@@ -1067,7 +1067,7 @@ async function oauthLogin(opts) {
 }
 
 // installer/installer-gui.ts
-var VERSION = true ? "0.23.13" : "0.0.0-dev";
+var VERSION = true ? "0.23.14" : "0.0.0-dev";
 var MESSAGES = {
   en: {
     installer: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leadbay/mcp",
-  "version": "0.23.13",
+  "version": "0.23.14",
   "mcpName": "io.github.leadbay/leadbay-mcp",
   "description": "Model Context Protocol (MCP) server for Leadbay — AI lead discovery, qualification, and enrichment for Claude Desktop, Cursor, and Claude Code.",
   "type": "module",