@mentoringo/vantage-ops-mcp 1.3.0

package/README.md

@@ -0,0 +1,268 @@
+# @mentoringo/vantage-ops-mcp
+
+MCP server that makes Vantage CRM operable from Claude Code. Read-only DynamoDB queries plus authenticated write tools that flow through the Vantage Lambda API.
+
+Install this in your local environment so Claude Code can search, mutate, and orchestrate Vantage records on your behalf — creating companies, launching campaigns, tracking outreach, advancing pipeline stages, and more.
+
+**Location:** This package lives at `tools/vantage-ops-mcp/` inside the `mentoringo/vantage` monorepo. It is published to npm as `@mentoringo/vantage-ops-mcp` so end users do not need to clone the repo.
+
+## Architecture
+
+```mermaid
+flowchart LR
+    subgraph local["Your machine"]
+        CC[Claude Code]
+        MCP[vantage-ops MCP<br/>this package]
+        ENV[(env<br/>VANTAGE_MCP_KEY)]
+    end
+    subgraph aws["AWS (us-east-1)"]
+        APIGW[API Gateway<br/>/mcp/proxy+]
+        AUTH[api_key_authorizer]
+        LAM[Unified Lambda<br/>scope-gated handlers]
+        DDB[(DynamoDB<br/>vantage-*)]
+    end
+
+    CC -- stdio --> MCP
+    ENV -. resolve on startup .-> MCP
+    MCP -- HTTPS + Bearer key --> APIGW
+    APIGW --> AUTH
+    AUTH -- allow + scopes --> LAM
+    LAM -- @require_scope<br/>checks scope --> DDB
+
+    style MCP fill:#e0f2fe
+    style AUTH fill:#fef3c7
+    style LAM fill:#fef3c7
+```
+
+**One path.** Reads and writes both flow through `/mcp/{proxy+}` with a scope-gated bearer token. Reads hit a `/v2/mcp-reads` dispatcher (scope `mcp:read`) that executes allowlisted DynamoDB queries with the Lambda's IAM role; writes hit resource endpoints that run the same handlers the dashboard uses, preserving slug generation, stage history, audit trails, and access control. **No AWS credentials are required on the operator machine.**
+
+**Full tool reference:** [docs/TOOLS.md](docs/TOOLS.md)
+**Scope / key model:** [docs/SCOPES.md](docs/SCOPES.md)
+**Common workflows:** [docs/RECIPES.md](docs/RECIPES.md)
+
+---
+
+## Who this is for
+
+Team operators with a provisioned `VANTAGE_MCP_KEY`. If you don't have a key yet, ask the platform admin — your key's scopes determine which tools you can use.
+
+Typical rollouts:
+
+| Role | Scopes on key | Tools available |
+|---|---|---|
+| Full operator (Justin, biz partner) | `*` or all `:*` | Every read + write tool |
+| BD researcher | `companies:*`, `contacts:*`, `activities:write` | Read everything + create contacts + log activities |
+| SDR / caller | `contacts:write`, `activities:write`, `outreach:write` | Log touches, update contacts, record outreach attempts |
+| Read-only analyst | `*:read` | All reads, no mutations |
+
+---
+
+## Prerequisites
+
+- **Node 20+**
+- **`VANTAGE_MCP_KEY`** — issued once by the platform admin; covers both reads and writes. Your key's scopes (`mcp:read`, `contacts:write`, etc.) determine which tools you can call.
+
+---
+
+## Install
+
+Add to `~/.claude.json` under `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "vantage-ops": {
+      "command": "npx",
+      "args": ["-y", "@mentoringo/vantage-ops-mcp@latest"],
+      "env": {
+        "VANTAGE_MCP_KEY": "vk_live_xxxxxxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Code. The first invocation pre-warms the npx cache (~3 seconds); subsequent starts are instant.
+
+To pin a specific version instead of tracking `@latest`, swap the tag: `@mentoringo/vantage-ops-mcp@1.1.0`.
+
+### Bundled skills
+
+Slash-command workflows (`/vet-leads`, `/lead-enrich`, `/contact-enrich`, `/campaign-launch`) ship in `.claude/skills/` and need to be linked into `~/.claude/skills/` so Claude Code discovers them. Until a published `install-skills` workflow lands (tracked in vantage roadmap), copy them by cloning vantage once:
+
+```bash
+git clone git@github.com:mentoringo/vantage.git ~/repo/vantage
+ln -s ~/repo/vantage/tools/vantage-ops-mcp/.claude/skills/* ~/.claude/skills/
+```
+
+The MCP tools themselves do not require the clone — npx handles those.
+
+### From-source install (contributors)
+
+```bash
+git clone git@github.com:mentoringo/vantage.git ~/repo/vantage
+cd ~/repo/vantage/tools/vantage-ops-mcp
+npm install
+npm run build
+npm run install-claude
+```
+
+`npm run install-claude` does two things idempotently:
+
+1. **Registers the MCP server** in `~/.claude.json` under `mcpServers.vantage-ops` pointing at the local `dist/`.
+2. **Symlinks the bundled skills** under `.claude/skills/*` into `~/.claude/skills/`.
+
+To uninstall: `npm run install-claude -- --uninstall`. To preview without changes: `npm run install-claude -- --dry-run`.
+
+## Configure
+
+The `env` block in `~/.claude.json` (above) is the canonical place for `VANTAGE_MCP_KEY`. Legacy local-clone installs may still read `~/repo/.env` — both work, but new installs should use the env block.
+
+The key was handed to you once at provisioning — if you lost it, it cannot be recovered. Ask for a replacement.
+
+Verify after restart:
+
+```
+vantage_mcp_health
+```
+
+Expected:
+
+```json
+{
+  "api_url": "https://mbmhmzrur4.execute-api.us-east-1.amazonaws.com/prod",
+  "key_configured": true
+}
+```
+
+---
+
+## Tool inventory at a glance
+
+**24 read tools + 23 write tools + 2 health = 49 total.**
+
+### Read tools (need `mcp:read` scope on key)
+
+| Domain | Tools |
+|---|---|
+| Companies | `companies_search`, `company_get`, `companies_stats` |
+| Contacts | `contacts_search`, `contact_get`, `contacts_by_company` |
+| Opportunities / Pipeline | `pipeline_list`, `pipeline_get`, `pipeline_summary` |
+| Campaigns | `campaigns_list`, `campaign_get`, `campaigns_stats` |
+| Clients / Users | `clients_list`, `client_get`, `users_list` |
+| Ops | `health`, `mcp_health`, `table_counts` |
+
+### Write tools (need a scoped `VANTAGE_MCP_KEY`)
+
+| Domain | Tools | Scope |
+|---|---|---|
+| Companies | `company_create`, `company_update`, `company_delete` | `companies:write` |
+| Contacts | `contact_create`, `contact_update`, `contact_delete` | `contacts:write` |
+| Opportunities | `opportunity_create`, `opportunity_update`, `opportunity_update_stage`, `opportunity_delete` | `opportunities:write` |
+| Campaigns | `campaign_create`, `campaign_update`, `campaign_delete`, `campaign_start`, `campaign_pause`, `campaign_add_targets`, `campaign_add_recipients`, `campaign_recipient_update`, `campaign_source_contacts` | `campaigns:write` |
+| Apollo | `apollo_search_contacts`, `apollo_search_companies`, `apollo_unlock_email`, `apollo_import_contact` | `apollo:write` |
+| Templates | `template_create`, `template_update`, `template_delete` | `templates:write` |
+| Outreach | `outreach_record`, `outreach_update` | `outreach:write` |
+| Activities | `activity_log` | `activities:write` |
+
+All tool names are prefixed with `vantage_` when called (e.g. `vantage_company_create`). Full schemas in [docs/TOOLS.md](docs/TOOLS.md).
+
+---
+
+## Bundled skills
+
+The MCP server is the tool surface; the bundled skills are slash-command workflows that orchestrate those tools end-to-end. After linking the skills directory (see Install), all four are usable from any Claude Code session as `/<skill-name>`.
+
+| Skill | Stage in lifecycle | What it does |
+|---|---|---|
+| `/vet-leads` | Pre-import | Deterministic file QA on a raw lead list (xlsx/csv) — flags role mailboxes, name-vs-email typos, missing fields, reseller-vs-end-user mismatches, dedup hits. Annotates each row with a `disposition` column. Free; no Apollo. |
+| `/lead-enrich` | Pre-import | Enriches a lead list with domains (for auto-logo), current company names, industry, dedup. Respects `disposition` from `/vet-leads` if present. |
+| `/contact-enrich` | Post-import | Fills `linkedin_url` + `title` on already-imported Vantage contacts. Apollo `unlock_email` (paid, optional) + WebSearch fallback. |
+| `/campaign-launch` | End-to-end | Builds a Vantage campaign from a lead file or ICP frame — companies + contacts + templates + targets + recipients staged in `draft` for human sign-off. |
+
+Designed lifecycle:
+
+```
+/vet-leads <file>            → vetted.csv  (operator reviews)
+/lead-enrich <vetted.csv>    → enriched-import.csv
+import via Vantage UI / API
+/contact-enrich --campaign   → fills LinkedIn + title gaps
+/campaign-launch <id>        → templates, sequence, ready to launch
+```
+
+Each skill is also registered as an MCP `prompt` for forward-compat with the Claude Agent SDK and any future Claude Code support for prompt-as-slash invocation. Filesystem skill files are the canonical source — the prompts read from the same `.claude/skills/<name>/SKILL.md` at server startup.
+
+---
+
+## Quick-check after install
+
+```
+vantage_health
+vantage_mcp_health
+vantage_companies_search status=prospect limit=3
+```
+
+If all three respond, you're good.
+
+---
+
+## Updating
+
+With the `@latest` tag in `~/.claude.json`, npx fetches the newest published version on each Claude Code restart. To force a refresh without restarting Claude Code, clear the npm cache for this package: `npm cache clean --force` (or `rm -rf ~/.npm/_npx/<hash>`).
+
+For pinned installs (`@1.1.0` rather than `@latest`), edit `~/.claude.json` to bump the version tag and restart.
+
+For from-source installs, `git pull && npm install && npm run build` then restart Claude Code.
+
+---
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---|---|
+| **Tool missing in Claude session** | Restart Claude Code. If pinned to a specific version, check the version's CHANGELOG. If on `@latest`, clear the npx cache to force a re-fetch. |
+| **Vantage UI shows recipient as "Sent" after they replied** | The campaign's embedded `recipients[contact].engagement_status` is a separate field from `outreach.status` and does not auto-sync. Use `vantage_outreach_update` AND `vantage_campaign_recipient_update` together when capturing an inbound reply. |
+| `VANTAGE_MCP_KEY not set` on first write | Confirm the `env` block in `~/.claude.json` has the key and Claude Code was restarted. |
+| `403 insufficient scope. Required: X` | Your key doesn't cover this tool — ask admin for an expanded key (see `docs/SCOPES.md`) |
+| Read tools fail with `403 Insufficient scope. Required: mcp:read` | Your key lacks `mcp:read` — ask admin to re-mint with reads enabled |
+| `401 Unauthorized` on every write | Key revoked, expired, or mistyped — verify with admin |
+| `404 Not found` on a specific opp/contact | Record doesn't exist in V2 table — check `vantage_pipeline_get` / `vantage_contact_get` first |
+
+---
+
+## Testing
+
+Three layers:
+
+```bash
+npm test       # 72 tests — schema contracts + mocked HTTP (runs offline in <200ms)
+npm run smoke  # live end-to-end against prod API — needs a valid VANTAGE_MCP_KEY
+npm run build  # TypeScript type check
+```
+
+`npm test` is safe in any environment — sentinel values are inlined in the test script, `global.fetch` is stubbed, the network is never touched.
+
+`npm run smoke` creates a test contact + opportunity in prod against the sharptrain client (`34ec0933-…`), exercises every write tool, then cleans up. Each step reports pass/fail; exit code is 0 on full pass. Your key needs: `contacts:write`, `opportunities:write`, `activities:write`. Provide your key via shell env or a local `.env.test` (gitignored).
+
+See `tests/client.test.ts` for HTTP shape coverage, `tests/tools.test.ts` for schema contracts, and `scripts/smoke.ts` for the live happy path.
+
+---
+
+## Key lifecycle
+
+- **Default TTL:** 90 days
+- **Recovery:** plaintext is not stored, only a SHA256 hash. Lost keys must be revoked + re-issued
+- **Rotation:** request a new key before expiry; run in parallel briefly, then revoke the old one
+- **Leak response:** admin runs `vantage_keys.py revoke --id <uuid>` immediately
+
+---
+
+## Next steps
+
+- Read [docs/TOOLS.md](docs/TOOLS.md) for the full tool schema reference
+- Read [docs/SCOPES.md](docs/SCOPES.md) to understand which scopes unlock which tools
+- Read [docs/RECIPES.md](docs/RECIPES.md) for common workflows (launching a campaign, tracking an outreach touch, etc.)
+
+For development conventions and contribution guide see [CLAUDE.md](CLAUDE.md).
+
+Questions? Ping the platform admin.

package/dist/dynamo.d.ts

@@ -0,0 +1,70 @@
+export declare const tables: {
+    readonly companies: "companies";
+    readonly contacts: "contacts";
+    readonly campaigns: "campaigns";
+    readonly campaignTargets: "campaign-targets";
+    readonly opportunities: "opportunities";
+    readonly clients: "clients";
+    readonly users: "users";
+    readonly outreach: "outreach";
+    readonly activities: "activities";
+};
+export declare class VantageReadError extends Error {
+    status: number;
+    body: unknown;
+    constructor(status: number, body: unknown, message: string);
+}
+export declare function getItem(table: string, key: Record<string, any>): Promise<Record<string, any> | null>;
+export interface QueryExtras {
+    limit?: number;
+    scanForward?: boolean;
+    expressionNames?: Record<string, string>;
+    exclusiveStartKey?: Record<string, any>;
+}
+export declare function queryByIndex(table: string, indexName: string, keyCondition: string, expressionValues: Record<string, any>, o?: QueryExtras): Promise<{
+    items: Record<string, any>[];
+    count: number;
+    lastEvaluatedKey?: Record<string, any>;
+}>;
+export declare function queryTable(table: string, keyCondition: string, expressionValues: Record<string, any>, o?: {
+    limit?: number;
+    scanForward?: boolean;
+    exclusiveStartKey?: Record<string, any>;
+}): Promise<{
+    items: Record<string, any>[];
+    count: number;
+    lastEvaluatedKey?: Record<string, any>;
+}>;
+export interface ScanOptions {
+    limit?: number;
+    filterExpression?: string;
+    expressionValues?: Record<string, any>;
+    expressionNames?: Record<string, string>;
+    projectionExpression?: string;
+    exclusiveStartKey?: Record<string, any>;
+}
+export declare function scanTable(table: string, o?: ScanOptions): Promise<{
+    items: Record<string, any>[];
+    count: number;
+    scannedCount: number;
+    lastEvaluatedKey?: Record<string, any>;
+}>;
+export declare function scanAll(table: string, o?: ScanOptions, maxItems?: number): Promise<{
+    items: Record<string, any>[];
+    scannedCount: number;
+    truncated: boolean;
+}>;
+export declare function scanCount(table: string, o?: {
+    filterExpression?: string;
+    expressionValues?: Record<string, any>;
+    expressionNames?: Record<string, string>;
+}): Promise<number>;
+export declare function describeTable(table: string): Promise<{
+    itemCount: number;
+    tableSizeBytes: number;
+}>;
+export declare function apiHealth(baseUrl?: string): Promise<{
+    healthy: boolean;
+    message: string;
+}>;
+export declare function readsConfigured(): boolean;

package/dist/dynamo.js

@@ -0,0 +1,238 @@
+/**
+ * Non-AWS read client — talks to Vantage's /v2/mcp-reads dispatcher
+ * over HTTPS using the same VANTAGE_MCP_KEY used for writes.
+ *
+ * This module keeps the function names (getItem, queryByIndex, scanTable,
+ * scanAll, scanCount) the read tools have always imported so swapping
+ * AWS CLI for HTTP is invisible at the call sites. Each function shapes
+ * its request for the dispatcher (op + table alias + DDB expression
+ * arguments) and returns the same object shape the previous unmarshalling
+ * layer produced — plain JS objects, not DynamoDB JSON.
+ *
+ * See: vantage/lambdas/api/mcp_reads/handler.py
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const DEFAULT_API_URL = "https://mbmhmzrur4.execute-api.us-east-1.amazonaws.com/prod";
+// Logical aliases the backend allowlist understands. The full DDB table
+// name is resolved server-side so staging/prod reuse the same client.
+export const tables = {
+    companies: "companies",
+    contacts: "contacts",
+    campaigns: "campaigns",
+    // Junction: (campaign_id, company_id) — exposes attached targets without
+    // requiring callers to round-trip through the REST handler.
+    campaignTargets: "campaign-targets",
+    opportunities: "opportunities",
+    clients: "clients",
+    users: "users",
+    outreach: "outreach",
+    activities: "activities",
+};
+// ── env/config resolution ──────────────────────────────────────────────
+// Mirrors mcp-client.ts so the read path and write path resolve the same
+// key+URL from the same sources (env block, then ~/repo/.env).
+function parseDotenv(path) {
+    const out = {};
+    if (!existsSync(path))
+        return out;
+    try {
+        const text = readFileSync(path, "utf8");
+        for (const raw of text.split(/\r?\n/)) {
+            const line = raw.trim();
+            if (!line || line.startsWith("#"))
+                continue;
+            const m = line.match(/^(?:export\s+)?([A-Z_][A-Z0-9_]*)\s*=\s*(.*)$/i);
+            if (!m)
+                continue;
+            let [, key, value] = m;
+            value = value.trim();
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            out[key] = value;
+        }
+    }
+    catch {
+        // Unreadable — caller falls back to process.env.
+    }
+    return out;
+}
+function resolveConfig() {
+    let apiKey = process.env.VANTAGE_MCP_KEY || null;
+    let apiUrl = process.env.VANTAGE_API_URL || DEFAULT_API_URL;
+    if (!apiKey) {
+        const envFile = parseDotenv(join(homedir(), "repo", ".env"));
+        apiKey = envFile.VANTAGE_MCP_KEY || null;
+        apiUrl = apiUrl || envFile.VANTAGE_API_URL || DEFAULT_API_URL;
+    }
+    return { apiUrl, apiKey };
+}
+const { apiUrl, apiKey } = resolveConfig();
+export class VantageReadError extends Error {
+    status;
+    body;
+    constructor(status, body, message) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.name = "VantageReadError";
+    }
+}
+async function dispatch(body) {
+    if (!apiKey) {
+        throw new Error("VANTAGE_MCP_KEY not set. Add it to ~/repo/.env or the mcp.json env block " +
+            "for the vantage-ops server. Read tools now use the same key as writes.");
+    }
+    const url = `${apiUrl}/mcp/v2/mcp-reads`;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    const text = await res.text();
+    let parsed = text;
+    if (text) {
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // Non-JSON body — surfacing the raw text is more useful than hiding it.
+        }
+    }
+    if (!res.ok) {
+        const message = typeof parsed === "object" && parsed && "message" in parsed
+            ? String(parsed.message)
+            : `Vantage reads ${body.op} returned ${res.status}`;
+        throw new VantageReadError(res.status, parsed, message);
+    }
+    return parsed;
+}
+// ── Public API (same shape as the prior AWS-CLI-backed module) ─────────
+export async function getItem(table, key) {
+    const out = await dispatch({
+        op: "get_item",
+        table,
+        key,
+    });
+    return out.item ?? null;
+}
+export async function queryByIndex(table, indexName, keyCondition, expressionValues, o = {}) {
+    const out = await dispatch({
+        op: "query",
+        table,
+        index: indexName,
+        key_condition: keyCondition,
+        expression_values: expressionValues,
+        expression_names: o.expressionNames,
+        limit: o.limit,
+        scan_forward: o.scanForward,
+        exclusive_start_key: o.exclusiveStartKey,
+    });
+    return {
+        items: out.items || [],
+        count: out.count || 0,
+        lastEvaluatedKey: out.last_evaluated_key,
+    };
+}
+export async function queryTable(table, keyCondition, expressionValues, o = {}) {
+    const out = await dispatch({
+        op: "query",
+        table,
+        key_condition: keyCondition,
+        expression_values: expressionValues,
+        limit: o.limit,
+        scan_forward: o.scanForward,
+        exclusive_start_key: o.exclusiveStartKey,
+    });
+    return {
+        items: out.items || [],
+        count: out.count || 0,
+        lastEvaluatedKey: out.last_evaluated_key,
+    };
+}
+export async function scanTable(table, o = {}) {
+    const out = await dispatch({
+        op: "scan",
+        table,
+        filter_expression: o.filterExpression,
+        expression_values: o.expressionValues,
+        expression_names: o.expressionNames,
+        projection_expression: o.projectionExpression,
+        limit: o.limit,
+        exclusive_start_key: o.exclusiveStartKey,
+    });
+    return {
+        items: out.items || [],
+        count: out.count || 0,
+        scannedCount: out.scanned_count || 0,
+        lastEvaluatedKey: out.last_evaluated_key,
+    };
+}
+// Paginates through an entire table (or stops after maxItems).
+// Use for aggregate stats or filter-only searches where the single-page
+// scan misses matches past the first 1 MB page.
+export async function scanAll(table, o = {}, maxItems = 10000) {
+    const items = [];
+    let scannedCount = 0;
+    let exclusiveStartKey = o.exclusiveStartKey;
+    let truncated = false;
+    while (true) {
+        const page = await scanTable(table, { ...o, exclusiveStartKey });
+        items.push(...page.items);
+        scannedCount += page.scannedCount;
+        if (items.length >= maxItems) {
+            truncated = !!page.lastEvaluatedKey;
+            items.length = Math.min(items.length, maxItems);
+            break;
+        }
+        if (!page.lastEvaluatedKey)
+            break;
+        exclusiveStartKey = page.lastEvaluatedKey;
+    }
+    return { items, scannedCount, truncated };
+}
+export async function scanCount(table, o = {}) {
+    const out = await dispatch({
+        op: "scan",
+        table,
+        filter_expression: o.filterExpression,
+        expression_values: o.expressionValues,
+        expression_names: o.expressionNames,
+        select: "COUNT",
+    });
+    return out.count || 0;
+}
+export async function describeTable(table) {
+    const out = await dispatch({
+        op: "describe_table",
+        table,
+    });
+    return {
+        itemCount: out.item_count || 0,
+        tableSizeBytes: out.table_size_bytes || 0,
+    };
+}
+// ── Health check via HTTP (unchanged) ──────────────────────────────────
+export async function apiHealth(baseUrl = process.env.VANTAGE_PUBLIC_API_URL || "https://vantage.mentoringo.com") {
+    try {
+        const res = await fetch(`${baseUrl}/api/health`, { method: "GET" });
+        return {
+            healthy: res.ok,
+            message: `HTTP ${res.status}`,
+        };
+    }
+    catch (e) {
+        return { healthy: false, message: e.message || String(e) };
+    }
+}
+// Exposed for diagnostics (vantage_mcp_health tool).
+export function readsConfigured() {
+    return !!apiKey;
+}
+//# sourceMappingURL=dynamo.js.map

package/dist/dynamo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo.js","sourceRoot":"","sources":["../src/dynamo.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,51 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { registerCompanyTools } from "./tools/company-tools.js";
+import { registerContactTools } from "./tools/contact-tools.js";
+import { registerCampaignTools } from "./tools/campaign-tools.js";
+import { registerPipelineTools } from "./tools/pipeline-tools.js";
+import { registerAdminTools } from "./tools/admin-tools.js";
+import { registerMcpWriteTools } from "./tools/mcp-write-tools.js";
+import { registerBundledSkillPrompts } from "./prompts.js";
+const server = new McpServer({
+    name: "vantage-ops",
+    version: "1.0.0",
+});
+registerCompanyTools(server);
+registerContactTools(server);
+registerCampaignTools(server);
+registerPipelineTools(server);
+registerAdminTools(server);
+registerMcpWriteTools(server);
+registerBundledSkillPrompts(server);
+const mode = process.env.MCP_TRANSPORT ?? "stdio";
+if (mode === "http") {
+    const port = parseInt(process.env.PORT ?? "9402");
+    const apiKey = process.env.MCP_API_KEY;
+    const app = createMcpExpressApp({ host: "0.0.0.0" });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    app.post("/mcp", async (req, res) => {
+        if (apiKey) {
+            const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+            const keyFromHeader = req.headers["x-api-key"];
+            const keyFromQuery = url.searchParams.get("key");
+            if (keyFromHeader !== apiKey && keyFromQuery !== apiKey) {
+                res.writeHead(401, { "Content-Type": "application/json" });
+                res.end(JSON.stringify({ jsonrpc: "2.0", error: { code: -32001, message: "Unauthorized" }, id: null }));
+                return;
+            }
+        }
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
+        await server.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+        res.on("close", () => { transport.close(); });
+    });
+    app.listen(port, () => console.log(`vantage-ops HTTP on :${port}${apiKey ? " (auth enabled)" : " (no auth)"}`));
+}
+else {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}