@opennous/mcp 0.44.0 → 0.44.2

package/LICENSE

@@ -0,0 +1,216 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Copyright 2026 Nous
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@opennous/mcp",
-  "version": "0.44.0",
+  "version": "0.44.2",
   "description": "Nous — the Context Graph for AI Agents.",
-  "license": "AGPL-3.0-only",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/NousC/nous.git",
+    "url": "git+https://github.com/NousC/opennous.git",
     "directory": "apps/mcp"
   },
   "type": "module",

package/src/client.js

@@ -71,8 +71,8 @@ function currentApiUrl() {
 export function validateConfig() {
   if (!resolvedEnv("NOUS_API_KEY") && !fileApiKey()) {
     throw new Error(
-      "No Nous API key found. Run the /nous-login command (or `npx @opennous/cli login`) to sign in, " +
-      "or set NOUS_API_KEY."
+      "No Nous API key found. Run `npx @opennous/cli login` to sign in (or `npx @opennous/cli init` " +
+      "to set up from scratch), or set NOUS_API_KEY."
     );
   }
 }

package/src/index.js

@@ -17,10 +17,10 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { validateConfig } from "./client.js";
 import { createServer } from "./server.js";
 
-// Advisory only — don't hard-exit if there's no key yet. The user may install
-// the plugin and then run /nous-login; the server must already be running so the
-// key (resolved per-call from env or ~/.nous/config.json) is picked up without a
-// restart.
+// Advisory only — don't hard-exit if there's no key yet. The user may register
+// the MCP first and sign in after (`npx @opennous/cli login`); the server must
+// already be running so the key (resolved per-call from env or ~/.nous/config.json)
+// is picked up without a restart.
 try {
   validateConfig();
 } catch (err) {

package/src/server.js

@@ -89,9 +89,10 @@ const pct     = (c) => `${Math.round((c ?? 0) * 100)}%`;
 // Gong/Granola). Returned by get_routing_preferences; the agent writes it into
 // the user's CLAUDE.md (Claude Code) or the user pastes it into claude.ai org
 // preferences. Mirrors the Install page's "short" version.
-const ROUTING_PREFERENCES = `# Nous is this workspace's GTM context graph
+const ROUTING_PREFERENCES = `# Nous is this workspace's Revenue Context Layer
 
-Nous is our context graph for GTM. It resolves every person, conversation, and
+Nous is our Revenue Context Layer for GTM: the pre-computed context every agent reads
+before it acts. Underneath, a context graph resolves every person, conversation, and
 touchpoint across our GTM tool stack into one account record, with each fact's
 confidence and freshness, the full interaction timeline, a 0-100 ICP fit score on
 every account, plus our own ICP, positioning, and pricing. Agents read engineered
@@ -283,6 +284,19 @@ export function createServer() {
         for (const f of rec.facts) lines.push(`  [${f.category}] ${f.content}${f.date ? `  (${relAge(f.date)})` : ""}`);
         lines.push("");
       }
+      const docs = rec.documents ?? [];
+      if (docs.length) {
+        // Saved briefs / notes / transcripts kept on the contact — previews only.
+        // The agent needs to KNOW these exist so it never reports "no brief on
+        // file" when one is saved; the full body is read with search_notes.
+        lines.push(`DOCUMENTS (${docs.length} — saved notes & meeting records, read with search_notes):`);
+        for (const d of docs) {
+          const when = d.date ? `  (${relAge(d.date)})` : "";
+          lines.push(`  ${d.type.replace(/_/g, " ")}${d.title ? ` · ${d.title}` : ""}${when}`);
+          if (d.snippet) lines.push(`      ${d.snippet}`);
+        }
+        lines.push("");
+      }
       const claims = Object.values(rec.claims ?? {});
       if (claims.length) {
         lines.push(`ATTRIBUTES (${claims.length}):`);
@@ -526,6 +540,99 @@ export function createServer() {
     }
   );
 
+  // ===========================================================================
+  // TOOL: score  —  POST /v2/score
+  // The thin scoring verb an external list (spreadsheet, Clay column, agent)
+  // calls to get Nous's judgment on a row and have it land in the graph. The
+  // list stays wherever the user built it; Nous owns the score. Read-mostly:
+  // returns the live ICP fit + intent, bootstrap-staking a known-but-unscored
+  // row on demand. Cheaper and leaner than get_context on purpose.
+  // ===========================================================================
+  const scoreOne = (r) => {
+    if (!r.resolved) {
+      if (r.reason === "ambiguous") {
+        const names = (r.candidates || []).map(c => c.name || c.entity_id).join(", ");
+        return `ambiguous — several people match${names ? `: ${names}` : ""}. Score by email or LinkedIn URL instead.`;
+      }
+      return "not in the graph yet — enrich this account first (signals/firmographics), then score.";
+    }
+    if (!r.scored) return `known, but awaiting enrichment — no scoreable claims yet (${r.entity_id}).`;
+    const tier = (r.icp.tier || "").replace(/_/g, " ") || "untiered";
+    return `ICP ${r.icp.score}/100 (${tier})${r.icp.fit ? " ✓fit" : ""} · intent ${r.intent.score}/100 ${r.intent.band}` +
+           (r.icp.reason ? `\n    ${r.icp.reason}` : "");
+  };
+  server.tool(
+    "score",
+    "Score a lead against our live ICP model and intent axis, and write the judgment into the graph so " +
+    "every other agent reads the same number. This is for scoring a list the user built ELSEWHERE (a " +
+    "Google Sheet, a Clay column, a CRM export): the list stays where it is, Nous returns the score. " +
+    "Give an email, domain, LinkedIn URL, or entity UUID (or up to 100 at once via `identifiers`). " +
+    "Returns ICP fit 0-100 + tier (tier_1/2/3/not_icp, which drives the play) and decaying intent " +
+    "0-100 + band. It reads the live score (staking one on demand for a known-but-unscored account); " +
+    "the score keeps evolving on its own afterwards. If a row isn't in the graph yet it comes back " +
+    "`unknown_identifier` — enrich that account first (signal-scan / a lead-builder), then score.",
+    {
+      identifier: z.string().optional().describe("One lead — an email, domain, LinkedIn URL, or entity UUID."),
+      identifiers: z.array(z.string()).optional().describe("A batch of leads (max 100 per call; loop for a larger list)."),
+      intent: z.string().optional().describe("Optional hint about why you're scoring (recorded, does not change the score)."),
+    },
+    async ({ identifier, identifiers, intent }) => {
+      if (Array.isArray(identifiers) && identifiers.length) {
+        const r = await post("/v2/score", { identifiers, intent });
+        const lines = (r.results || []).map(x => `  ${x.identifier} — ${scoreOne(x)}`);
+        const scored = (r.results || []).filter(x => x.scored).length;
+        return { content: [{ type: "text", text: `Scored ${scored}/${(r.results || []).length}:\n${lines.join("\n")}` }] };
+      }
+      const r = await post("/v2/score", { identifier, intent });
+      return { content: [{ type: "text", text: `${identifier} — ${scoreOne(r)}` }] };
+    }
+  );
+
+  // ===========================================================================
+  // TOOL: attach_list  —  POST /v2/lead-lists/attach
+  // Batch-score a list the user built ELSEWHERE (a Google Sheet, a CRM export, a
+  // Clay table). One call: create/reuse a Nous list, ingest the rows (entities
+  // resolved+deduped), score every row into the graph. The list stays where it
+  // is; Nous keeps the roster so the scores stay fresh and agents can read them.
+  // ===========================================================================
+  server.tool(
+    "attach_list",
+    "Score a whole list the user built somewhere ELSE — a Google Sheet, a CRM export, a Clay table — " +
+    "in one call. Give the rows and Nous creates a lead list, resolves each row to a person/company " +
+    "(deduped against everything already in the graph), and scores every one against the live ICP model " +
+    "+ intent axis so the judgment lands in the graph for other agents. The spreadsheet stays the user's; " +
+    "Nous just owns the score and keeps it fresh. Each row needs an email OR a LinkedIn URL. Rows we don't " +
+    "know enough about yet come back `awaiting_enrichment` — run signal-scan / a lead-builder on them, then " +
+    "re-attach. Pass `lead_list_id` instead of `name` to add to an existing list. Max 200 rows per call — " +
+    "loop for a bigger sheet.",
+    {
+      name: z.string().optional().describe("Name for the new list (e.g. 'Q3 sheet — inbound'). Omit only when passing lead_list_id."),
+      lead_list_id: z.string().optional().describe("Add to an existing list instead of creating one."),
+      source: z.string().optional().describe("Where the list came from, e.g. 'google_sheet', 'crm_export' (default 'external')."),
+      rows: z.array(z.object({
+        email: z.string().optional(),
+        linkedin_url: z.string().optional(),
+        domain: z.string().optional(),
+        company: z.string().optional(),
+        name: z.string().optional(),
+      }).passthrough()).describe("The list rows. Each needs an email or a linkedin_url."),
+      import_duplicates: z.boolean().optional().describe("Force-insert rows already in this list (default false — deduped)."),
+    },
+    async ({ name, lead_list_id, source, rows, import_duplicates }) => {
+      const r = await post("/v2/lead-lists/attach", { name, lead_list_id, source, rows, import_duplicates });
+      const head = `Attached ${rows.length} rows to list ${r.lead_list_id} — ` +
+        `${r.inserted} new, ${r.duplicate_skipped} already in list. ` +
+        `Scored ${r.scored}; ${r.awaiting_enrichment} awaiting enrichment; ${r.unresolved} unresolved.`;
+      const top = (r.results || [])
+        .filter(x => x.scored)
+        .sort((a, b) => (b.icp?.score ?? 0) - (a.icp?.score ?? 0))
+        .slice(0, 10)
+        .map(x => `  ${x.identifier} — ICP ${x.icp.score} (${(x.icp.tier || "").replace(/_/g, " ")}) · intent ${x.intent.score} ${x.intent.band}`);
+      const tail = r.awaiting_enrichment ? `\n\n${r.awaiting_enrichment} rows need enrichment before they can score — run signal-scan or a lead-builder on the list, then re-attach.` : "";
+      return { content: [{ type: "text", text: `${head}${top.length ? `\n\nTop scored:\n${top.join("\n")}` : ""}${tail}` }] };
+    }
+  );
+
   // ===========================================================================
   // TOOL: attention  —  GET /v2/attention
   // What to look at: accounts gone quiet, key facts decayed.
@@ -757,7 +864,10 @@ export function createServer() {
       const lines = [`Documents matching "${question}":`, ""];
       for (const d of r.documents) {
         const when = d.date ? `  [${relAge(d.date)}]` : "";
-        lines.push(`  ${d.type.replace(/_/g, " ")}${d.title ? ` · ${d.title}` : ""}  (${pct(d.similarity)})${when}`);
+        // similarity is null for recency-matched hits (a note too fresh to be
+        // embedded yet) — label those "recent" instead of a bogus 0%.
+        const match = d.similarity == null ? "recent" : pct(d.similarity);
+        lines.push(`  ${d.type.replace(/_/g, " ")}${d.title ? ` · ${d.title}` : ""}  (${match})${when}`);
         if (d.snippet) lines.push(`    ${d.snippet}`);
         lines.push(`    (entity_id: ${d.entity_id})`);
       }
@@ -1046,6 +1156,12 @@ export function createServer() {
           ...imp.map((s) => `  • ${s.section}${s.source_path ? `  ← ${s.source_path}` : ""}`),
         ];
         if (r.skipped?.length) lines.push("", `Skipped (unknown/empty): ${r.skipped.join(", ")}`);
+        // Section-check nudges from the server — the ICP file synced but is missing
+        // canonical sections (buyer, fit, triggers, …). Surface them so the agent
+        // rounds the file out and re-syncs, instead of the gaps passing silently.
+        for (const w of (r.warnings ?? [])) {
+          lines.push("", `⚠ ${w.message}`);
+        }
         const sig = r.signals ?? [];
         if (r.model_status === "created" && sig.length) {
           lines.push("", `Built the ICP scoring model — ${sig.length} signal${sig.length === 1 ? "" : "s"}.`);
@@ -1095,9 +1211,15 @@ export function createServer() {
           "No ICP scoring model yet. Sync the user's ICP file with sync_icp first (or build one with " +
           "build_icp_model / train_icp_model), then call this to write it back." }] };
       }
-      const note = r.has_outcomes
+      // Lift can only be learned from WINS, so a win-less cohort (losses only) is
+      // still seed estimates — don't claim it's "trained on real closed deals".
+      const wonCount = r.calibration?.won ?? 0;
+      const lostCount = r.calibration?.lost ?? 0;
+      const note = wonCount > 0
         ? "This model is trained on real closed deals (lift + calibration shown)."
-        : "This model is seeded from the ICP only — add closed deals with train_icp_model to sharpen it.";
+        : lostCount > 0
+          ? `Still seed estimates — ${lostCount} closed-lost recorded but no closed-won yet to learn lift from. Add closed-won with train_icp_model to sharpen it.`
+          : "This model is seeded from the ICP only — add closed deals with train_icp_model to sharpen it.";
       return { content: [{ type: "text", text:
         `Write the block below into ${r.target_path} with your file editor — replace any existing block ` +
         `between the nous:icp markers, or append it if there's none (create the file/section if absent). ` +