@adrata/adrata-mcp 1.0.43 → 1.0.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adrata/adrata-mcp",
-  "version": "1.0.43",
+  "version": "1.0.44",
   "description": "Adrata MCP Server \u2014 connect Claude Code, Codex, Gemini, Cursor, and other AI tools to your CRM. About 275 tools registered at startup for companies, people, deals, actions, buyer groups, warm intros, webhooks and intelligence, plus 65 more behind eight named toolsets you load with enable_toolset.",
   "type": "module",
   "main": "server.js",
@@ -9,7 +9,7 @@
   },
   "scripts": {
     "start": "node server.js",
-    "test": "node --test analytics.test.js server.test.js api-bridge.test.js http/edge-block.test.js http/rate-limit.test.js audit-flush.test.js buyer-group-writes.test.js note-writes.test.js mcp-spec.test.js packaging.test.js product-profile.test.js security.test.js security.cap-contract.test.js tool-annotations.test.js toolsets.test.js toolsets/communications.test.js toolsets/prospecting.test.js access/auth.test.js access/oauth-callback.test.js access/oauth-session.test.js access/oauth-capabilities.test.js access/oauth-scope-grantability.test.js scripts/local-dev-server.test.js tools/competitive-coverage.test.js tools/describe-count.test.js tools/email-tools.test.js tools/scheduling.test.js tools/work-board-tools.test.js tools/launches/work-launch-tools.test.js tools/work-hub/audit.test.js tools/work-hub/field-changes.test.js tools/work-hub/criteria-quality.test.js tools/roadmap-tools.test.js tools/provisioning/onboarding-tools.test.js tools/source-control/connection-tools.test.js governance/money.test.js http/rate-limit-policy.test.js"
+    "test": "node --test analytics.test.js server.test.js api-bridge.test.js http/edge-block.test.js http/rate-limit.test.js audit-flush.test.js buyer-group-writes.test.js note-writes.test.js mcp-spec.test.js packaging.test.js product-profile.test.js security.test.js security.cap-contract.test.js tool-annotations.test.js toolsets.test.js toolsets/communications.test.js toolsets/prospecting.test.js access/auth.test.js access/oauth-callback.test.js access/oauth-session.test.js access/oauth-capabilities.test.js access/oauth-scope-grantability.test.js scripts/local-dev-server.test.js tools/competitive-coverage.test.js tools/describe-count.test.js tools/email-tools.test.js tools/scheduling.test.js tools/work-board-tools.test.js tools/launches/work-launch-tools.test.js tools/work-hub/audit.test.js tools/work-hub/field-changes.test.js tools/work-hub/criteria-quality.test.js tools/roadmap-tools.test.js tools/provisioning/onboarding-tools.test.js tools/source-control/connection-tools.test.js governance/money.test.js http/rate-limit-policy.test.js tools/free-search.test.js"
   },
   "keywords": [
     "mcp",

package/server.js

@@ -40,7 +40,7 @@ import {
   getValidAgentToken,
 } from './access/auth.js';
 import { TIERS } from './access/tiers.js';
-import { findCompany, findPerson } from './tools/free-search.js';
+import { findCompany, findPerson, findCompanyInWorkspace, findPersonInWorkspace } from './tools/free-search.js';
 import { applySecurityLayer } from './security.js';
 import { describeEdgeBlock } from './http/edge-block.js';
 import { createRateLimitRegistry } from './http/rate-limit.js';
@@ -1123,17 +1123,30 @@ server.tool('move_pipeline_card',
     }
   });
 
-// ===== FREE TIER: Claude-powered search (zero cost to Adrata) =====
+// ===== find_company / find_person =====
+//
+// A seat with a credential gets its WORKSPACE RECORD (found / not found / could
+// not check). Only a server with no credential at all falls back to the
+// training-data profile prompt, which carries no upsell. See tools/free-search.js.
+
+function hasWorkspaceCredential() {
+  const auth = currentAuth();
+  return Boolean(auth?.token || auth?.apiKey);
+}
 
 server.tool('find_company',
-  'Search for a company using Claude\'s training data. Returns a structured profile with industry, key people, estimated size, competitors, and sales angles. Free tier — no API key needed. For verified real-time data, upgrade to Pro.',
-  { name: z.string().describe('Company name to research (e.g. "Stripe", "Snowflake", "Datadog")') },
-  async (a) => findCompany(a.name));
+  'Find a company. Connected to a workspace, returns that workspace\'s company record (or says plainly that none matches, or that the workspace could not be checked). With no workspace connected, returns an unverified profile from Claude\'s training data.',
+  { name: z.string().describe('Company name or domain (e.g. "Stripe", "stripe.com")') },
+  async (a) => (hasWorkspaceCredential()
+    ? findCompanyInWorkspace(a.name, (query) => api('GET', '/api/v1/companies', { params: { search: query, limit: 25, page: 1 } }))
+    : findCompany(a.name)));
 
 server.tool('find_person',
-  'Search for a professional using Claude\'s training data. Returns a structured profile with title, company, background, expertise, and sales context. Free tier — no API key needed. For verified contact info and buyer signals, upgrade to Pro.',
-  { name: z.string().describe('Full name of the person to research (e.g. "Patrick Collison", "Jensen Huang")') },
-  async (a) => findPerson(a.name));
+  'Find a person. Connected to a workspace, returns that workspace\'s person record (or says plainly that none matches, or that the workspace could not be checked). With no workspace connected, returns an unverified profile from Claude\'s training data.',
+  { name: z.string().describe('Full name or email of the person (e.g. "Patrick Collison")') },
+  async (a) => (hasWorkspaceCredential()
+    ? findPersonInWorkspace(a.name, (query) => api('GET', '/api/v1/people', { params: { search: query, limit: 25, page: 1 } }))
+    : findPerson(a.name)));
 
 // ===== GOVERNED WRITES (shared) =====
 //

package/server.json

@@ -3,7 +3,7 @@
   "name": "com.adrata/adrata-mcp",
   "description": "Adrata revenue-intelligence MCP server: companies, people, opportunities, actions, buyer groups, enrichment, email, and workspace operations for AI agents.",
   "status": "active",
-  "version": "1.0.43",
+  "version": "1.0.44",
   "websiteUrl": "https://adrata.com/developers",
   "repository": {
     "url": "https://github.com/adrata/adrata",
@@ -15,7 +15,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@adrata/adrata-mcp",
-      "version": "1.0.43",
+      "version": "1.0.44",
       "transport": {
         "type": "stdio"
       },

package/tools/free-search.js

@@ -1,11 +1,20 @@
 /**
- * Free Tier Claude-Powered Search
+ * find_company / find_person
  *
- * These tools return structured prompts that guide Claude (the LLM running the
- * MCP client) to search its own training data for company and person profiles.
+ * Connected to a workspace, these return the WORKSPACE RECORD — the thing a
+ * seller asking "find Acme" means. Measured on Colin's day-one audit
+ * (2026-09-12): a connected seat got back a raw model prompt ending "Upgrade to
+ * Adrata Pro for enriched intelligence" instead of the record sitting in its own
+ * CRM. Owner ruling 2026-09-11: no seat sees credits, prices, quotas or upsells.
  *
- * Cost to Adrata: $0 — Claude's own knowledge does the work.
- * No API key needed, no account needed, unlimited usage.
+ * Three states, never two:
+ *   - found:          the workspace record(s), labelled as such;
+ *   - not found:      said plainly — the workspace was checked and has no match;
+ *   - could not look: said plainly — nothing was ruled out.
+ *
+ * With no credential at all there is no workspace to check, so the tool falls
+ * back to a structured training-data profile prompt, labelled unverified, with
+ * no upsell in it.
  */
 
 // ---------------------------------------------------------------------------
@@ -56,8 +65,7 @@ IMPORTANT: Respond with ONLY a valid JSON object matching this exact schema. No
   "competitors": ["Competitor 1", "Competitor 2", "Competitor 3"],
   "recent_highlights": "Notable recent developments, funding, acquisitions, or strategic moves from training data",
   "ideal_sales_angles": "2-3 sentence suggestion for how a seller might approach this company",
-  "data_freshness": "Based on training data through early 2025. Some details may have changed.",
-  "upgrade_prompt": "Want verified contacts, real-time headcount, funding rounds, hiring signals, and intent data? Upgrade to Adrata Pro for enriched intelligence."
+  "data_freshness": "Based on training data through early 2025. Some details may have changed."
 }
 
 Rules:
@@ -84,8 +92,7 @@ IMPORTANT: Respond with ONLY a valid JSON object matching this exact schema. No
   "notable_achievements": "Key accomplishments, board seats, speaking engagements, publications",
   "linkedin_likely": "Likely LinkedIn URL pattern (e.g. linkedin.com/in/firstname-lastname) — note: unverified",
   "sales_context": "2-3 sentence suggestion for how a seller might approach this person — what they likely care about",
-  "data_freshness": "Based on training data through early 2025. Current role may have changed.",
-  "upgrade_prompt": "Want verified email, phone, social profiles, recent activity, and buyer signals? Upgrade to Adrata Pro for enriched contact intelligence."
+  "data_freshness": "Based on training data through early 2025. Current role may have changed."
 }
 
 Rules:
@@ -158,3 +165,118 @@ export function findPerson(name) {
   cacheSet(cacheKey, result);
   return result;
 }
+
+// ---------------------------------------------------------------------------
+// Workspace-record lookup (connected seats)
+// ---------------------------------------------------------------------------
+
+const WORKSPACE_MATCH_LIMIT = 5;
+
+/** Pull the record array out of the API's list envelope, whatever its shape. */
+export function recordsFromListResponse(response, collection) {
+  const candidates = [
+    response,
+    response?.data,
+    response?.data?.[collection],
+    response?.data?.items,
+    response?.data?.data,
+    response?.[collection],
+    response?.items,
+  ];
+  for (const candidate of candidates) {
+    if (Array.isArray(candidate)) return candidate;
+  }
+  return [];
+}
+
+function normalize(value) {
+  return typeof value === 'string' ? value.trim().toLowerCase() : '';
+}
+
+function recordName(record, kind) {
+  if (kind === 'person') {
+    return (
+      record?.fullName ||
+      record?.name ||
+      [record?.firstName, record?.lastName].filter(Boolean).join(' ')
+    );
+  }
+  return record?.name;
+}
+
+function exactMatches(records, query, kind) {
+  const wanted = normalize(query);
+  return records.filter((record) => {
+    if (normalize(recordName(record, kind)) === wanted) return true;
+    if (kind === 'company') {
+      return [record?.domain, record?.website].some((d) => normalize(d).replace(/^https?:\/\/(www\.)?/, '').replace(/\/$/, '') === wanted);
+    }
+    return normalize(record?.email) === wanted;
+  });
+}
+
+function textResult(payload, isError = false) {
+  return {
+    content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+    ...(isError ? { isError: true } : {}),
+  };
+}
+
+/**
+ * Look the name up in the connected workspace and return what is there.
+ *
+ * `lookup(name)` performs the authenticated list read and resolves to the raw
+ * API response; it is injected so this stays testable without a server.
+ */
+async function findInWorkspace(kind, name, lookup) {
+  const label = kind === 'company' ? 'company' : 'person';
+  const query = String(name ?? '').trim();
+  let response;
+  try {
+    response = await lookup(query);
+  } catch {
+    // The honest third state. Never an empty result, never "not found".
+    return textResult(
+      {
+        source: 'workspace',
+        status: 'could_not_check',
+        query,
+        message: `Couldn't check the workspace for a ${label} named "${query}" right now, so nothing was ruled out. Try again in a moment.`,
+      },
+      true,
+    );
+  }
+
+  const records = recordsFromListResponse(response, kind === 'company' ? 'companies' : 'people');
+  if (records.length === 0) {
+    return textResult({
+      source: 'workspace',
+      status: 'not_found',
+      query,
+      message: `No ${label} matching "${query}" is in this workspace.`,
+    });
+  }
+
+  const exact = exactMatches(records, query, kind);
+  const matches = (exact.length > 0 ? exact : records).slice(0, WORKSPACE_MATCH_LIMIT);
+  return textResult({
+    source: 'workspace',
+    status: exact.length > 0 ? 'found' : 'similar_found',
+    query,
+    message:
+      exact.length > 0
+        ? `Found ${exact.length === 1 ? 'the' : exact.length} workspace ${label} record${exact.length === 1 ? '' : 's'} for "${query}".`
+        : `No exact match for "${query}"; these workspace ${label} records are the closest.`,
+    [kind === 'company' ? 'companies' : 'people']: matches,
+  });
+}
+
+/** find_company for a seat with a credential: the workspace record, three-state. */
+export function findCompanyInWorkspace(name, lookup) {
+  return findInWorkspace('company', name, lookup);
+}
+
+/** find_person for a seat with a credential: the workspace record, three-state. */
+export function findPersonInWorkspace(name, lookup) {
+  return findInWorkspace('person', name, lookup);
+}