@vantagestack/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,74 @@
+# VantagePipe MCP Server
+
+MCP server for [VantagePipe](https://app.vantage-stack.com) — lets AI coding agents send trading signals, read position state, and monitor broker connections through natural language.
+
+## Quick start
+
+```bash
+VANTAGE_API_KEY=vp_live_... npx @vantagestack/mcp-server
+```
+
+## Setup
+
+### 1. Get an API key
+
+Log in to VantagePipe → Settings → API Keys → Create key. Copy the full `vp_live_...` key.
+
+### 2. Add to Claude Code
+
+In your project, add to `.claude/settings.local.json`:
+
+```json
+{
+  "mcpServers": {
+    "vantage": {
+      "command": "npx",
+      "args": ["-y", "@vantagestack/mcp-server"],
+      "env": {
+        "VANTAGE_API_KEY": "vp_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Add to Claude Desktop
+
+In `~/Library/Application Support/Claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "vantage": {
+      "command": "npx",
+      "args": ["-y", "@vantagestack/mcp-server"],
+      "env": {
+        "VANTAGE_API_KEY": "vp_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `VANTAGE_API_KEY` | Yes | — | Your VantagePipe API key (`vp_{env}_{id}_{secret}`) |
+| `VANTAGE_API_ORIGIN` | No | `https://app.vantage-stack.com` | Override for local development |
+
+## Available tools
+
+| Tool | Description |
+|---|---|
+| `ping_vantage` | Check connectivity and API key validity |
+
+More tools arriving in AGNT-02 (signal actions) and AGNT-03 (read + inspection).
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```

package/dist/client.d.ts

@@ -0,0 +1,20 @@
+export interface VantageConfig {
+    apiKey: string;
+    origin: string;
+}
+export declare function loadConfig(): VantageConfig;
+export declare function validateStartup(config: VantageConfig): Promise<void>;
+export declare class VantageClient {
+    private readonly config;
+    constructor(config: VantageConfig);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    postWebhook<T>(groupId: string, secret: string, body: unknown): Promise<T>;
+}
+export declare class VantageApiError extends Error {
+    readonly status: number;
+    readonly path: string;
+    readonly body: string;
+    constructor(status: number, path: string, body: string);
+}
+export declare function apiErrorText(err: unknown): string;

package/dist/client.js

@@ -0,0 +1,104 @@
+const DEFAULT_ORIGIN = "https://app.vantage-stack.com";
+export function loadConfig() {
+    const apiKey = process.env.VANTAGE_API_KEY;
+    if (!apiKey) {
+        console.error("Error: VANTAGE_API_KEY environment variable is required.");
+        console.error("Get your API key from VantagePipe → Settings → API Keys.");
+        process.exit(1);
+    }
+    const parts = apiKey.split("_");
+    if (parts[0] !== "vp" || parts.length < 4) {
+        console.error("Error: VANTAGE_API_KEY format invalid. Expected vp_{env}_{publicId}_{secret} (4 underscore-separated segments).");
+        process.exit(1);
+    }
+    const origin = (process.env.VANTAGE_API_ORIGIN ?? DEFAULT_ORIGIN).replace(/\/$/, "");
+    return { apiKey, origin };
+}
+export async function validateStartup(config) {
+    const url = `${config.origin}/health`;
+    let res;
+    try {
+        res = await fetch(url, { signal: AbortSignal.timeout(8000) });
+    }
+    catch (err) {
+        console.error(`Error: Cannot reach VantagePipe at ${config.origin}/health`);
+        console.error("  Check VANTAGE_API_ORIGIN or your network connection.");
+        console.error(`  Cause: ${err instanceof Error ? err.message : String(err)}`);
+        process.exit(1);
+    }
+    if (!res.ok) {
+        console.error(`Error: VantagePipe health check returned HTTP ${res.status} at ${url}`);
+        process.exit(1);
+    }
+}
+export class VantageClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async get(path) {
+        const res = await fetch(`${this.config.origin}${path}`, {
+            headers: {
+                Authorization: `Bearer ${this.config.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            throw new VantageApiError(res.status, path, body);
+        }
+        return res.json();
+    }
+    async post(path, body) {
+        const res = await fetch(`${this.config.origin}${path}`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.config.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new VantageApiError(res.status, path, text);
+        }
+        return res.json();
+    }
+    async postWebhook(groupId, secret, body) {
+        const path = `/webhook/group/${groupId}/${secret}`;
+        const res = await fetch(`${this.config.origin}${path}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "");
+            throw new VantageApiError(res.status, path, text);
+        }
+        return res.json();
+    }
+}
+export class VantageApiError extends Error {
+    status;
+    path;
+    body;
+    constructor(status, path, body) {
+        super(`VantagePipe API error ${status} on ${path}: ${body}`);
+        this.status = status;
+        this.path = path;
+        this.body = body;
+    }
+}
+export function apiErrorText(err) {
+    if (err instanceof VantageApiError) {
+        try {
+            const parsed = JSON.parse(err.body);
+            return parsed.error ?? err.message;
+        }
+        catch {
+            return err.message;
+        }
+    }
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig, validateStartup, VantageClient } from "./client.js";
+import { UserResolver } from "./user.js";
+import { pingVantage } from "./tools/ping.js";
+import { sendSignal, exitPositions, flattenGroup, } from "./tools/signals.js";
+import { listGroups, getGroupState, checkConnections, getSignalHistory, inspectSignal, } from "./tools/read.js";
+const config = loadConfig();
+await validateStartup(config);
+const client = new VantageClient(config);
+const resolver = new UserResolver();
+const server = new Server({ name: "vantage-pipe-mcp", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "ping_vantage",
+            description: "Check that VantagePipe is reachable and the API key is valid. " +
+                "Returns the service version and environment. Run this first when setting up or diagnosing connection issues.",
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "list_groups",
+            description: "List all signal groups owned by this account. Returns group IDs, names, account counts, " +
+                "and webhook URLs. Use this to discover groupId and secret for send_signal and other tools.",
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "get_group_state",
+            description: "Get live account state for a group: open positions, working orders, and stale signals per member. " +
+                "The primary 'am I flat?' check. Use before sending signals to understand current exposure.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    groupId: { type: "string", description: "Group ID (from list_groups)" },
+                    secret: { type: "string", description: "Group webhook secret (from list_groups webhookUrl)" },
+                },
+                required: ["groupId", "secret"],
+            },
+        },
+        {
+            name: "check_connections",
+            description: "Check broker connection health: connected/disconnected status, token expiry, broker type per connection. " +
+                "Run before sending signals if you suspect a connection issue.",
+            inputSchema: { type: "object", properties: {}, required: [] },
+        },
+        {
+            name: "get_signal_history",
+            description: "Get recent signals for a group with status (executed/partial/failed). " +
+                "Supports filtering by ticker, status, and quantity.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    groupId: { type: "string", description: "Group ID" },
+                    limit: { type: "number", description: "Max signals to return (default 50, max 200)" },
+                    status: { type: "string", description: "Filter by status: executed, partial, failed" },
+                    ticker: { type: "string", description: "Filter by ticker symbol (e.g. MYM1!)" },
+                },
+                required: ["groupId"],
+            },
+        },
+        {
+            name: "inspect_signal",
+            description: "Get full execution detail for a signal ID: broker call log, per-account results, audit trail. " +
+                "Use to diagnose why a signal failed or partially executed.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    signalId: { type: "string", description: "Signal ID (from get_signal_history or send_signal response)" },
+                },
+                required: ["signalId"],
+            },
+        },
+        {
+            name: "send_signal",
+            description: "Send a trading signal to a VantagePipe group. Fans out to all active accounts. " +
+                "Actions: buy, sell, exit, add, reduce. Order types: market, limit, stop, stop_limit. " +
+                "Same signal within 60s returns the cached result (safe for agent retries). " +
+                "For bracket orders use limitPrice (take-profit) and stopLoss together with a market entry.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    groupId: { type: "string", description: "Group ID" },
+                    secret: { type: "string", description: "Group webhook secret" },
+                    action: { type: "string", description: "buy | sell | exit | add | reduce" },
+                    ticker: { type: "string", description: "Instrument symbol (e.g. MYM1!, ES1!)" },
+                    quantity: { type: "number", description: "Number of contracts" },
+                    orderType: { type: "string", description: "market | limit | stop | stop_limit (default: market)" },
+                    limitPrice: { type: "number", description: "Limit or take-profit price" },
+                    stopPrice: { type: "number", description: "Stop entry price" },
+                    takeProfit: { type: "number", description: "Take-profit offset in points" },
+                    stopLoss: { type: "number", description: "Stop-loss offset in points" },
+                    comment: { type: "string", description: "Optional comment (T1_entry, Recoup_entry, etc.)" },
+                    timeInForce: { type: "string", description: "DAY | GTC | IOC | FOK" },
+                },
+                required: ["groupId", "secret", "action", "ticker"],
+            },
+        },
+        {
+            name: "exit_positions",
+            description: "Send an exit signal to a group, closing all open positions for the specified ticker (or all tickers). " +
+                "Uses action=exit on the group webhook. Safe to call when already flat — returns success with 0 dispatched.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    groupId: { type: "string", description: "Group ID" },
+                    secret: { type: "string", description: "Group webhook secret" },
+                    ticker: { type: "string", description: "Ticker to exit (omit to exit all tickers)" },
+                    comment: { type: "string", description: "Optional comment" },
+                },
+                required: ["groupId", "secret"],
+            },
+        },
+        {
+            name: "flatten_group",
+            description: "SAFETY OPERATION: immediately closes ALL open positions and cancels ALL working orders " +
+                "across every account in the group via the VantagePipe flatten API. " +
+                "Requires confirm: true to prevent accidental execution.",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    groupId: { type: "string", description: "Group ID" },
+                    confirm: { type: "boolean", description: "Must be true to execute — prevents accidental flatten" },
+                },
+                required: ["groupId", "confirm"],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const input = (req.params.arguments ?? {});
+    switch (req.params.name) {
+        case "ping_vantage": return pingVantage(client);
+        case "list_groups": return listGroups(client, resolver, input);
+        case "get_group_state": return getGroupState(client, resolver, input);
+        case "check_connections": return checkConnections(client, resolver, input);
+        case "get_signal_history": return getSignalHistory(client, resolver, input);
+        case "inspect_signal": return inspectSignal(client, resolver, input);
+        case "send_signal": return sendSignal(client, resolver, input);
+        case "exit_positions": return exitPositions(client, resolver, input);
+        case "flatten_group": return flattenGroup(client, resolver, input);
+        default:
+            return {
+                content: [{ type: "text", text: `Unknown tool: ${req.params.name}` }],
+                isError: true,
+            };
+    }
+});
+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":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;AAC5B,MAAM,eAAe,CAAC,MAAM,CAAC,CAAC;AAC9B,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACzC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;AAEpC,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAChC,CAAC;AAEF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,cAAc;YACpB,WAAW,EACT,gEAAgE;gBAChE,8GAA8G;YAChH,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;SAC9D;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,0FAA0F;gBAC1F,4FAA4F;YAC9F,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;SAC9D;QACD;YACE,IAAI,EAAE,iBAAiB;YACvB,WAAW,EACT,oGAAoG;gBACpG,4FAA4F;YAC9F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6BAA6B,EAAE;oBACvE,MAAM,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oDAAoD,EAAE;iBAC/F;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;aAChC;SACF;QACD;YACE,IAAI,EAAE,mBAAmB;YACzB,WAAW,EACT,2GAA2G;gBAC3G,+DAA+D;YACjE,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;SAC9D;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EACT,wEAAwE;gBACxE,qDAAqD;YACvD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;oBACpD,KAAK,EAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;oBACvF,MAAM,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;oBACvF,MAAM,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;iBACjF;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACtB;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,gGAAgG;gBAChG,4DAA4D;YAC9D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;iBACzG;gBACD,QAAQ,EAAE,CAAC,UAAU,CAAC;aACvB;SACF;QACD;YACE,IAAI,EAAE,aAAa;YACnB,WAAW,EACT,iFAAiF;gBACjF,uFAAuF;gBACvF,6EAA6E;gBAC7E,4FAA4F;YAC9F,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;oBACvD,MAAM,EAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBACnE,MAAM,EAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;oBAC/E,MAAM,EAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;oBACnF,QAAQ,EAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qBAAqB,EAAE;oBAClE,SAAS,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sDAAsD,EAAE;oBACnG,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;oBACzE,SAAS,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;oBAC/D,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;oBAC3E,QAAQ,EAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;oBACzE,OAAO,EAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;oBAC9F,WAAW,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;iBACrE;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC;aACpD;SACF;QACD;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EACT,wGAAwG;gBACxG,4GAA4G;YAC9G,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;oBACpD,MAAM,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBAChE,MAAM,EAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;oBACrF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;iBAC7D;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;aAChC;SACF;QACD;YACE,IAAI,EAAE,eAAe;YACrB,WAAW,EACT,yFAAyF;gBACzF,qEAAqE;gBACrE,yDAAyD;YAC3D,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE;oBACpD,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uDAAuD,EAAE;iBACnG;gBACD,QAAQ,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;aACjC;SACF;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5D,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAA4B,CAAC;IAEtE,QAAQ,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACxB,KAAK,cAAc,CAAC,CAAU,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QACzD,KAAK,aAAa,CAAC,CAAW,OAAO,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzE,KAAK,iBAAiB,CAAC,CAAO,OAAO,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5E,KAAK,mBAAmB,CAAC,CAAK,OAAO,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/E,KAAK,oBAAoB,CAAC,CAAI,OAAO,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/E,KAAK,gBAAgB,CAAC,CAAQ,OAAO,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5E,KAAK,aAAa,CAAC,CAAW,OAAO,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzE,KAAK,gBAAgB,CAAC,CAAQ,OAAO,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC5E,KAAK,eAAe,CAAC,CAAS,OAAO,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE3E;YACE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC9E,OAAO,EAAE,IAAI;aACd,CAAC;IACN,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/ping.d.ts

@@ -0,0 +1,8 @@
+import { VantageClient } from "../client.js";
+export declare function pingVantage(client: VantageClient): Promise<{
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+}>;

package/dist/tools/ping.js

@@ -0,0 +1,22 @@
+import { apiErrorText } from "../client.js";
+export async function pingVantage(client) {
+    try {
+        const health = await client.get("/health");
+        const version = health.version ? ` Version: ${health.version}.` : "";
+        const env = health.environment ? ` Environment: ${health.environment}.` : "";
+        const text = `VantagePipe is reachable.${version}${env}`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Could not reach VantagePipe: ${apiErrorText(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=ping.js.map

package/dist/tools/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/tools/ping.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,cAAc,CAAC;AAU3D,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAqB;IAErB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAiB,SAAS,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,IAAI,GAAG,4BAA4B,OAAO,GAAG,GAAG,EAAE,CAAC;QACzD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC/C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,gCAAgC,YAAY,CAAC,GAAG,CAAC,EAAE;iBAC1D;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/ping.test.d.ts

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

package/dist/tools/ping.test.js

@@ -0,0 +1,25 @@
+import { describe, it, expect } from "vitest";
+import { pingVantage } from "./ping.js";
+const makeClient = (getImpl) => ({ get: getImpl });
+describe("ping_vantage", () => {
+    it("returns ok message with version when health responds", async () => {
+        const client = makeClient(() => Promise.resolve({ ok: true, version: "1.2.3", environment: "prod" }));
+        const result = await pingVantage(client);
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("1.2.3");
+        expect(result.content[0].text).toContain("prod");
+    });
+    it("returns ok message without version when health has no version field", async () => {
+        const client = makeClient(() => Promise.resolve({ ok: true }));
+        const result = await pingVantage(client);
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toBe("VantagePipe is reachable.");
+    });
+    it("returns isError true when API call throws", async () => {
+        const client = makeClient(() => Promise.reject(new Error("network error")));
+        const result = await pingVantage(client);
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("network error");
+    });
+});
+//# sourceMappingURL=ping.test.js.map

package/dist/tools/ping.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.test.js","sourceRoot":"","sources":["../../src/tools/ping.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,MAAM,UAAU,GAAG,CAAC,OAA+B,EAAE,EAAE,CACrD,CAAC,EAAE,GAAG,EAAE,OAAO,EAA+B,CAAA,CAAC;AAEjD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAC7B,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CACrE,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACnF,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC/D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,7 @@
+import { VantageClient } from "../client.js";
+import { UserResolver, ToolResult } from "../user.js";
+export declare function listGroups(client: VantageClient, resolver: UserResolver, _input: Record<string, unknown>): Promise<ToolResult>;
+export declare function getGroupState(client: VantageClient, _resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;
+export declare function checkConnections(client: VantageClient, resolver: UserResolver, _input: Record<string, unknown>): Promise<ToolResult>;
+export declare function getSignalHistory(client: VantageClient, _resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;
+export declare function inspectSignal(client: VantageClient, _resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;

package/dist/tools/read.js

@@ -0,0 +1,149 @@
+import { makeErrorResult } from "../user.js";
+export async function listGroups(client, resolver, _input) {
+    try {
+        const userId = await resolver.resolve(client);
+        const groups = await client.get(`/api/account/${userId}/groups`);
+        const summary = groups
+            .map((g) => `• ${g.name} (id=${g.id}, accounts=${g.accounts?.length ?? 0})`)
+            .join("\n");
+        return {
+            content: [
+                { type: "text", text: `${groups.length} group(s):\n${summary}` },
+                {
+                    type: "text",
+                    text: JSON.stringify(groups.map((g) => ({
+                        groupId: g.id,
+                        name: g.name,
+                        accountCount: g.accounts?.length ?? 0,
+                        webhookUrl: g.webhookUrl,
+                    })), null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+export async function getGroupState(client, _resolver, input) {
+    const groupId = String(input.groupId ?? "");
+    const secret = String(input.secret ?? "");
+    if (!groupId || !secret)
+        return makeErrorResult(new Error("groupId and secret are required"));
+    try {
+        const state = await client.get(`/webhook/group/${groupId}/${secret}/account-state`);
+        const members = state.members ?? [];
+        const summaryLines = members.map((m) => {
+            const spec = m.accountSpec ?? m.userId ?? "?";
+            const positions = m.positions ?? [];
+            const orders = m.workingOrders ?? [];
+            const posStr = positions.length === 0 ? "FLAT" : `${positions.length} open position(s)`;
+            const ordStr = orders.length > 0 ? `, ${orders.length} working order(s)` : "";
+            const errStr = m.error ? ` [${m.error}]` : "";
+            return `• ${spec}: ${posStr}${ordStr}${errStr}`;
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: summaryLines.length > 0 ? summaryLines.join("\n") : "No active accounts in group",
+                },
+                { type: "text", text: JSON.stringify(state, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+export async function checkConnections(client, resolver, _input) {
+    try {
+        const userId = await resolver.resolve(client);
+        const connections = await client.get(`/api/account/${userId}/connections`);
+        const summaryLines = connections.map((c) => {
+            const status = c.isActive && c.isEnabled ? "connected" : "disconnected";
+            const expiry = c.accessTokenExpiry
+                ? ` (token expires ${new Date(c.accessTokenExpiry).toISOString()})`
+                : "";
+            return `• ${c.label ?? c.brokerType} [${c.brokerType}]: ${status}${expiry}`;
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: connections.length > 0
+                        ? summaryLines.join("\n")
+                        : "No connections found",
+                },
+                { type: "text", text: JSON.stringify(connections, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+export async function getSignalHistory(client, _resolver, input) {
+    const groupId = String(input.groupId ?? "");
+    if (!groupId)
+        return makeErrorResult(new Error("groupId is required"));
+    const params = new URLSearchParams();
+    if (input.limit)
+        params.set("limit", String(input.limit));
+    if (input.status)
+        params.set("status", String(input.status));
+    if (input.ticker)
+        params.set("ticker", String(input.ticker));
+    const qs = params.toString() ? `?${params.toString()}` : "";
+    try {
+        const res = await client.get(`/api/groups/${groupId}/signals${qs}`);
+        const signals = res.signals ?? [];
+        const lines = signals.map((s) => `• [${s.receivedAt}] ${s.action} ${s.ticker} ${s.status} (id=${s.id})`);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `${res.total} total signal(s), showing ${signals.length}:\n${lines.join("\n")}`,
+                },
+                { type: "text", text: JSON.stringify(res, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+export async function inspectSignal(client, _resolver, input) {
+    const signalId = String(input.signalId ?? "");
+    if (!signalId)
+        return makeErrorResult(new Error("signalId is required"));
+    try {
+        const [signal, audit] = await Promise.all([
+            client.get(`/api/signals/${signalId}`),
+            client
+                .get(`/api/signals/${signalId}/audit`)
+                .catch(() => null),
+        ]);
+        const summaryParts = [
+            `Signal ${signalId}: ${signal.action} ${signal.ticker}`,
+            `Status: ${signal.status}`,
+        ];
+        if (signal.errorMessage)
+            summaryParts.push(`Error: ${signal.errorMessage}`);
+        if (signal.executedAt)
+            summaryParts.push(`Executed: ${signal.executedAt}`);
+        return {
+            content: [
+                { type: "text", text: summaryParts.join(" | ") },
+                {
+                    type: "text",
+                    text: JSON.stringify({ signal, audit: audit ?? "unavailable" }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

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

package/dist/tools/read.test.d.ts

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

package/dist/tools/read.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from "vitest";
+import { listGroups, getGroupState, checkConnections, getSignalHistory, inspectSignal, } from "./read.js";
+const makeClient = (getImpl) => ({ get: getImpl });
+const makeResolver = (userId = 42) => ({ resolve: async () => userId });
+describe("list_groups", () => {
+    it("returns group summary and JSON", async () => {
+        const client = makeClient(() => Promise.resolve([
+            { id: 7, name: "Main Group", accounts: [{}, {}], webhookUrl: "https://x/webhook/group/7/secret" },
+        ]));
+        const result = await listGroups(client, makeResolver(), {});
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("Main Group");
+        expect(result.content[0].text).toContain("id=7");
+    });
+    it("returns isError when API fails", async () => {
+        const client = makeClient(() => Promise.reject(new Error("401")));
+        const result = await listGroups(client, makeResolver(), {});
+        expect(result.isError).toBe(true);
+    });
+});
+describe("get_group_state", () => {
+    it("shows FLAT when no positions", async () => {
+        const client = makeClient(() => Promise.resolve({ members: [{ accountSpec: "Demo123", positions: [], workingOrders: [] }] }));
+        const result = await getGroupState(client, makeResolver(), { groupId: "7", secret: "abc" });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("FLAT");
+    });
+    it("shows open position count", async () => {
+        const client = makeClient(() => Promise.resolve({
+            members: [{ accountSpec: "Demo123", positions: [{ symbol: "MYM" }], workingOrders: [] }],
+        }));
+        const result = await getGroupState(client, makeResolver(), { groupId: "7", secret: "abc" });
+        expect(result.content[0].text).toContain("1 open position");
+    });
+    it("returns isError when groupId missing", async () => {
+        const client = makeClient(() => Promise.resolve({}));
+        const result = await getGroupState(client, makeResolver(), {});
+        expect(result.isError).toBe(true);
+    });
+});
+describe("check_connections", () => {
+    it("returns connection status", async () => {
+        const client = makeClient(() => Promise.resolve([
+            { id: 1, label: "Tradovate Demo", brokerType: "tradovate", isActive: true, isEnabled: true },
+        ]));
+        const result = await checkConnections(client, makeResolver(), {});
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("Tradovate Demo");
+        expect(result.content[0].text).toContain("connected");
+    });
+});
+describe("get_signal_history", () => {
+    it("returns signal list", async () => {
+        const client = makeClient(() => Promise.resolve({
+            total: 2,
+            offset: 0,
+            limit: 50,
+            signals: [
+                { id: 1, action: "buy", ticker: "MYM1!", status: "executed", receivedAt: "2026-04-29T10:00:00Z" },
+                { id: 2, action: "sell", ticker: "MYM1!", status: "failed", receivedAt: "2026-04-29T11:00:00Z" },
+            ],
+        }));
+        const result = await getSignalHistory(client, makeResolver(), { groupId: "7" });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("2 total signal(s)");
+        expect(result.content[0].text).toContain("executed");
+    });
+    it("returns isError when groupId missing", async () => {
+        const client = makeClient(() => Promise.resolve({}));
+        const result = await getSignalHistory(client, makeResolver(), {});
+        expect(result.isError).toBe(true);
+    });
+});
+describe("inspect_signal", () => {
+    it("combines signal and audit", async () => {
+        const client = makeClient((path) => {
+            if (path.endsWith("/audit"))
+                return Promise.resolve({ events: [] });
+            return Promise.resolve({ id: 123, action: "buy", ticker: "MYM1!", status: "executed" });
+        });
+        const result = await inspectSignal(client, makeResolver(), { signalId: "123" });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("Signal 123");
+        expect(result.content[0].text).toContain("executed");
+    });
+    it("returns isError when signalId missing", async () => {
+        const client = makeClient(() => Promise.resolve({}));
+        const result = await inspectSignal(client, makeResolver(), {});
+        expect(result.isError).toBe(true);
+    });
+    it("still returns signal if audit call fails", async () => {
+        const client = makeClient((path) => {
+            if (path.endsWith("/audit"))
+                return Promise.reject(new Error("404"));
+            return Promise.resolve({ id: 55, action: "sell", ticker: "ES1!", status: "partial" });
+        });
+        const result = await inspectSignal(client, makeResolver(), { signalId: "55" });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[1].text).toContain('"audit": "unavailable"');
+    });
+});
+//# sourceMappingURL=read.test.js.map

package/dist/tools/read.test.js.map

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

package/dist/tools/signals.d.ts

@@ -0,0 +1,5 @@
+import { VantageClient } from "../client.js";
+import { UserResolver, ToolResult } from "../user.js";
+export declare function sendSignal(client: VantageClient, resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;
+export declare function exitPositions(client: VantageClient, _resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;
+export declare function flattenGroup(client: VantageClient, resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;

package/dist/tools/signals.js

@@ -0,0 +1,142 @@
+import { makeErrorResult } from "../user.js";
+const VALID_ACTIONS = ["buy", "sell", "exit", "add", "reduce"];
+const VALID_ORDER_TYPES = ["market", "limit", "stop", "stop_limit"];
+export async function sendSignal(client, resolver, input) {
+    const groupId = String(input.groupId ?? "");
+    const secret = String(input.secret ?? "");
+    const action = String(input.action ?? "");
+    const ticker = String(input.ticker ?? "");
+    if (!groupId || !secret)
+        return makeErrorResult(new Error("groupId and secret are required"));
+    if (!VALID_ACTIONS.includes(action)) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Invalid action "${action}". Valid values: ${VALID_ACTIONS.join(", ")}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    if (!ticker)
+        return makeErrorResult(new Error("ticker is required"));
+    const payload = { action, ticker };
+    if (input.quantity != null)
+        payload.quantity = Number(input.quantity);
+    if (input.orderType != null) {
+        const ot = String(input.orderType);
+        if (!VALID_ORDER_TYPES.includes(ot)) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid orderType "${ot}". Valid values: ${VALID_ORDER_TYPES.join(", ")}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        payload.orderType = ot;
+    }
+    if (input.limitPrice != null)
+        payload.limitPrice = Number(input.limitPrice);
+    if (input.stopPrice != null)
+        payload.stopPrice = Number(input.stopPrice);
+    if (input.takeProfit != null)
+        payload.takeProfit = Number(input.takeProfit);
+    if (input.stopLoss != null)
+        payload.stopLoss = Number(input.stopLoss);
+    if (input.comment != null)
+        payload.comment = String(input.comment);
+    if (input.timeInForce != null)
+        payload.timeInForce = String(input.timeInForce);
+    try {
+        const res = await client.postWebhook(groupId, secret, payload);
+        if (!res.success) {
+            return { content: [{ type: "text", text: res.error ?? "Signal dispatch failed" }], isError: true };
+        }
+        const summary = `${res.dispatched ?? 0} of ${res.total ?? 0} accounts executed`;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Signal dispatched: ${summary}. Envelope signal ID: ${res.envelopeSignalId ?? "unknown"}`,
+                },
+                {
+                    type: "text",
+                    text: JSON.stringify({ dispatched: res.dispatched, total: res.total, envelopeSignalId: res.envelopeSignalId, results: res.results }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+export async function exitPositions(client, _resolver, input) {
+    const groupId = String(input.groupId ?? "");
+    const secret = String(input.secret ?? "");
+    if (!groupId || !secret)
+        return makeErrorResult(new Error("groupId and secret are required"));
+    const payload = {
+        action: "exit",
+        ticker: input.ticker ? String(input.ticker) : "ALL",
+    };
+    if (input.comment != null)
+        payload.comment = String(input.comment);
+    try {
+        const res = await client.postWebhook(groupId, secret, payload);
+        if (!res.success) {
+            return { content: [{ type: "text", text: res.error ?? "Exit failed" }], isError: true };
+        }
+        const summary = `${res.dispatched ?? 0} of ${res.total ?? 0} accounts received exit signal`;
+        return {
+            content: [
+                { type: "text", text: summary },
+                {
+                    type: "text",
+                    text: JSON.stringify({ dispatched: res.dispatched, total: res.total, results: res.results }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+export async function flattenGroup(client, resolver, input) {
+    if (input.confirm !== true) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "flatten_group requires confirm: true — this closes ALL positions and cancels ALL working orders " +
+                        "across every account in the group. Pass confirm: true to proceed.",
+                },
+            ],
+            isError: true,
+        };
+    }
+    const groupId = String(input.groupId ?? "");
+    if (!groupId)
+        return makeErrorResult(new Error("groupId is required"));
+    try {
+        const userId = await resolver.resolve(client);
+        const res = await client.post(`/api/account/${userId}/groups/${groupId}/flatten`, {});
+        if (!res.success) {
+            return { content: [{ type: "text", text: res.error ?? "Flatten failed" }], isError: true };
+        }
+        const summary = `Closed ${res.closed ?? 0} positions, cancelled ${res.cancelled ?? 0} orders`;
+        return {
+            content: [
+                { type: "text", text: summary },
+                { type: "text", text: JSON.stringify(res, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+//# sourceMappingURL=signals.js.map

package/dist/tools/signals.js.map

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

package/dist/tools/signals.test.d.ts

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

package/dist/tools/signals.test.js

@@ -0,0 +1,92 @@
+import { describe, it, expect } from "vitest";
+import { sendSignal, exitPositions, flattenGroup } from "./signals.js";
+const makeClient = (postWebhookImpl, postImpl) => ({
+    postWebhook: postWebhookImpl ?? (() => Promise.resolve({ success: true, dispatched: 2, total: 2, envelopeSignalId: 99, results: [] })),
+    post: postImpl ?? (() => Promise.resolve({ success: true, closed: 1, cancelled: 2 })),
+});
+const makeResolver = (userId = 42) => ({ resolve: async () => userId });
+describe("send_signal", () => {
+    it("dispatches signal and returns summary", async () => {
+        const result = await sendSignal(makeClient(), makeResolver(), {
+            groupId: "7",
+            secret: "abc",
+            action: "buy",
+            ticker: "MYM1!",
+            quantity: 1,
+        });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("2 of 2 accounts executed");
+        expect(result.content[0].text).toContain("99");
+    });
+    it("returns isError for invalid action", async () => {
+        const result = await sendSignal(makeClient(), makeResolver(), {
+            groupId: "7", secret: "abc", action: "short", ticker: "MYM1!",
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("buy, sell, exit");
+    });
+    it("returns isError for invalid orderType", async () => {
+        const result = await sendSignal(makeClient(), makeResolver(), {
+            groupId: "7", secret: "abc", action: "buy", ticker: "MYM1!", orderType: "twap",
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("market, limit, stop");
+    });
+    it("returns isError when API fails", async () => {
+        const client = makeClient(() => Promise.reject(new Error("503")));
+        const result = await sendSignal(client, makeResolver(), {
+            groupId: "7", secret: "abc", action: "buy", ticker: "MYM1!",
+        });
+        expect(result.isError).toBe(true);
+    });
+    it("returns isError when groupId missing", async () => {
+        const result = await sendSignal(makeClient(), makeResolver(), {
+            action: "buy", ticker: "MYM1!",
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+describe("exit_positions", () => {
+    it("sends action=exit and returns summary", async () => {
+        const client = makeClient(() => Promise.resolve({ success: true, dispatched: 1, total: 1, results: [] }));
+        const result = await exitPositions(client, makeResolver(), {
+            groupId: "7", secret: "abc",
+        });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("accounts received exit signal");
+    });
+    it("returns isError when groupId missing", async () => {
+        const result = await exitPositions(makeClient(), makeResolver(), {});
+        expect(result.isError).toBe(true);
+    });
+});
+describe("flatten_group", () => {
+    it("returns isError without confirm:true", async () => {
+        const result = await flattenGroup(makeClient(), makeResolver(), {
+            groupId: "7",
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("confirm: true");
+    });
+    it("returns isError when confirm is false", async () => {
+        const result = await flattenGroup(makeClient(), makeResolver(), {
+            groupId: "7", confirm: false,
+        });
+        expect(result.isError).toBe(true);
+    });
+    it("calls flatten endpoint and returns summary with confirm:true", async () => {
+        const result = await flattenGroup(makeClient(), makeResolver(), {
+            groupId: "7", confirm: true,
+        });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("Closed 1 positions, cancelled 2 orders");
+    });
+    it("returns isError when API fails", async () => {
+        const client = makeClient(undefined, () => Promise.reject(new Error("500")));
+        const result = await flattenGroup(client, makeResolver(), {
+            groupId: "7", confirm: true,
+        });
+        expect(result.isError).toBe(true);
+    });
+});
+//# sourceMappingURL=signals.test.js.map

package/dist/tools/signals.test.js.map

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

package/dist/user.d.ts

@@ -0,0 +1,19 @@
+import { VantageClient } from "./client.js";
+export declare class UserResolver {
+    private userId;
+    resolve(client: VantageClient): Promise<number>;
+}
+export declare function makeErrorResult(err: unknown): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError: true;
+};
+export type ToolResult = {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: true;
+};

package/dist/user.js

@@ -0,0 +1,21 @@
+import { apiErrorText } from "./client.js";
+export class UserResolver {
+    userId = null;
+    async resolve(client) {
+        if (this.userId !== null)
+            return this.userId;
+        const me = await client.get("/api/auth/me");
+        if (!me.authenticated || !me.userId) {
+            throw new Error("API key authenticated but /api/auth/me returned no userId. Check key validity.");
+        }
+        this.userId = me.userId;
+        return this.userId;
+    }
+}
+export function makeErrorResult(err) {
+    return {
+        content: [{ type: "text", text: apiErrorText(err) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=user.js.map

package/dist/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../src/user.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,YAAY,EAAE,MAAM,aAAa,CAAC;AAO1D,MAAM,OAAO,YAAY;IACf,MAAM,GAAkB,IAAI,CAAC;IAErC,KAAK,CAAC,OAAO,CAAC,MAAqB;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAC7C,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,GAAG,CAAa,cAAc,CAAC,CAAC;QACxD,IAAI,CAAC,EAAE,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAI1C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@vantagestack/mcp-server",
+  "version": "0.1.0",
+  "description": "VantagePipe MCP server — send signals, read positions, monitor connections via AI coding agents",
+  "type": "module",
+  "bin": {
+    "vantage-pipe-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "test": "vitest run"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.0.0"
+  }
+}