@vantagestack/mcp-server 0.1.59 → 0.1.63

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, positionsFlattened: 1, ordersCancelled: 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 position(s), cancelled 2 order(s)");
+    });
+    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/tools/sync-accounts.d.ts

@@ -0,0 +1,18 @@
+import { VantageClient } from "../client.js";
+import { UserResolver, ToolResult } from "../user.js";
+/**
+ * ACCT-DISC-LIVE-02 — `sync_connection_accounts` MCP tool.
+ *
+ * Triggers an on-demand broker /account/list refresh for one connection so
+ * newly-funded accounts (Topstep eval activations, prop-firm passes, new
+ * Tradovate sub-accounts) surface in VantagePipe within seconds — no need
+ * to wait for the periodic 15-min sweep, no need to click Reconnect on the
+ * connection-detail page.
+ *
+ * Server-side throttle: VP returns syncStatus="cached" if the same connection
+ * was synced <30s ago. Calling this tool repeatedly is free.
+ *
+ * Returns the post-sync account list so the caller doesn't need a second
+ * round-trip.
+ */
+export declare function syncConnectionAccounts(client: VantageClient, resolver: UserResolver, input: Record<string, unknown>): Promise<ToolResult>;

package/dist/tools/sync-accounts.js

@@ -0,0 +1,68 @@
+import { makeErrorResult } from "../user.js";
+/**
+ * ACCT-DISC-LIVE-02 — `sync_connection_accounts` MCP tool.
+ *
+ * Triggers an on-demand broker /account/list refresh for one connection so
+ * newly-funded accounts (Topstep eval activations, prop-firm passes, new
+ * Tradovate sub-accounts) surface in VantagePipe within seconds — no need
+ * to wait for the periodic 15-min sweep, no need to click Reconnect on the
+ * connection-detail page.
+ *
+ * Server-side throttle: VP returns syncStatus="cached" if the same connection
+ * was synced <30s ago. Calling this tool repeatedly is free.
+ *
+ * Returns the post-sync account list so the caller doesn't need a second
+ * round-trip.
+ */
+export async function syncConnectionAccounts(client, resolver, input) {
+    try {
+        const connId = input?.connectionId;
+        if (typeof connId !== "number" || !Number.isInteger(connId) || connId <= 0) {
+            return {
+                content: [{ type: "text", text: "connectionId (positive integer) is required." }],
+                isError: true,
+            };
+        }
+        const userId = await resolver.resolve(client);
+        const res = await client.post(`/api/account/${userId}/connections/${connId}/sync-accounts`, {});
+        const lines = [];
+        switch (res.syncStatus) {
+            case "ok":
+                lines.push(`✅ Synced connection ${connId} with broker.`);
+                break;
+            case "cached":
+                lines.push(`⏱️ Connection ${connId} was synced recently (<30s ago) — returning cached account list.`);
+                break;
+            case "not_supported":
+                lines.push(`ℹ️ Broker for connection ${connId} does not have a periodic-sync adapter (LEAN). No sync attempted.`);
+                break;
+            case "auth_dead":
+                lines.push(`🔴 Connection ${connId}: stored credentials rejected by broker. The user needs to click Reconnect.`);
+                break;
+            case "failed":
+                lines.push(`⚠️ Sync failed for connection ${connId}: ${res.error ?? "unknown error"}. Returning last-known account list.`);
+                break;
+        }
+        if (res.lastSyncedAt) {
+            lines.push(`Last synced: ${res.lastSyncedAt}`);
+        }
+        lines.push("");
+        if (!res.accounts?.length) {
+            lines.push("_No accounts on this connection._");
+        }
+        else {
+            lines.push(`### ${res.accounts.length} account${res.accounts.length === 1 ? "" : "s"}:`);
+            for (const a of res.accounts) {
+                const env = a.environment ? ` [${a.environment}]` : "";
+                const off = a.isEnabled ? "" : " (disabled)";
+                const stat = a.brokerStatus ? ` — ${a.brokerStatus}` : "";
+                lines.push(`- **${a.accountSpec ?? a.accountId}** (#${a.accountId})${env}${off}${stat}`);
+            }
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    }
+    catch (e) {
+        return makeErrorResult(e);
+    }
+}
+//# sourceMappingURL=sync-accounts.js.map

package/dist/tools/sync-accounts.js.map

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

package/dist/tools/trade.d.ts

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

package/dist/tools/trade.js

@@ -0,0 +1,49 @@
+// TRD-08 — MCP tool wrapping GET /api/trades/{id}/detail.
+//
+// Read-only counterpart to inspect_signal / get_signal_history. Returns the
+// full per-trade aggregation (trade row, parent signal, account block,
+// execution timeline, status log, broker logs, slippage, siblings).
+import { makeErrorResult } from "../user.js";
+export async function getTrade(client, _resolver, input) {
+    try {
+        const tradeId = Number(input.tradeId);
+        if (!Number.isFinite(tradeId) || tradeId <= 0)
+            return makeErrorResult(new Error("tradeId must be a positive integer"));
+        const r = await client.get(`/api/trades/${tradeId}/detail`);
+        const t = r.trade ?? {};
+        const a = r.account ?? {};
+        const sig = r.signal;
+        const accountStr = a.label
+            ? `${a.label} · ${a.spec ?? a.rawId ?? ""}`
+            : (a.deleted ? "Deleted account" : (a.spec ?? a.rawId ?? "—"));
+        const pnl = t.pnlDollars;
+        const pnlStr = pnl == null
+            ? "OPEN"
+            : (pnl > 0 ? `+$${pnl.toFixed(2)}` : (pnl < 0 ? `-$${Math.abs(pnl).toFixed(2)}` : "$0.00"));
+        const summary = [
+            `Trade #${t.id} · ${t.symbol} ${t.side?.toUpperCase()} ${t.quantity} · ${pnlStr}`,
+            `Account: ${accountStr} [${a.brokerType ?? "?"}]`,
+            sig ? `Signal: #${sig.id} ${sig.action} ${sig.ticker} (${sig.status})` : "Signal: none (CSV import or orphan)",
+            r.group ? `Group: ${r.group.name} (#${r.group.id})` : "",
+            `Entry: ${t.entryPrice ?? "?"} @ ${t.entryAtUtc ?? "?"}`,
+            t.exitPrice != null ? `Exit:  ${t.exitPrice} @ ${t.exitAtUtc ?? "?"}` : "Exit:  — (still open)",
+        ].filter(Boolean).join("\n");
+        const execLines = (r.execution ?? [])
+            .map((s, i) => `  ${i + 1}. ${s.label ?? s.kind} @ ${s.t}${s.deltaMs != null ? ` (+${s.deltaMs}ms)` : ""}`)
+            .join("\n");
+        const execSection = execLines ? `\n\nExecution:\n${execLines}` : "";
+        const sibSection = (r.siblings ?? []).length > 0
+            ? `\n\nFan-out siblings: ${(r.siblings ?? []).join(", ")}`
+            : "";
+        return {
+            content: [
+                { type: "text", text: summary + execSection + sibSection },
+                { type: "text", text: JSON.stringify(r, null, 2) },
+            ],
+        };
+    }
+    catch (err) {
+        return makeErrorResult(err);
+    }
+}
+//# sourceMappingURL=trade.js.map

package/dist/tools/trade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trade.js","sourceRoot":"","sources":["../../src/tools/trade.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

@@ -27,5 +27,5 @@
     "typescript": "^5.7.0",
     "vitest": "^2.0.0"
   },
-  "version": "0.1.59"
+  "version": "0.1.63"
 }