datafye-mcp-api 2.0.15

package/dist/tools/crypto.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+import { toolResult } from "../util.js";
+export function registerCryptoTools(server, envManager) {
+    const client = () => envManager.getClient();
+    // ---------------------------------------------------------------------------
+    // Reference
+    // ---------------------------------------------------------------------------
+    server.tool("get_crypto_securities", "Get the securities master (symbol, name, exchange) for the crypto dataset.", {
+        date: z
+            .string()
+            .optional()
+            .describe("Date (yyyy-MM-dd). Omit for current date."),
+        exchanges: z
+            .string()
+            .optional()
+            .describe("Comma-separated exchange filter"),
+    }, async ({ date, exchanges }) => {
+        return toolResult(await client().get("/crypto/reference/securities", { date, exchanges }));
+    });
+    // ---------------------------------------------------------------------------
+    // Live — Tick Data
+    // ---------------------------------------------------------------------------
+    server.tool("get_crypto_latest_trade_time", "Get the timestamp of the last crypto trade received by the live feed.", {}, async () => {
+        return toolResult(await client().get("/crypto/live/trades/latest-time"));
+    });
+    server.tool("get_crypto_latest_trades", "Get the last crypto trade for each requested symbol from the live feed.", {
+        symbols: z
+            .string()
+            .describe("Comma-separated symbols (e.g. X:BTC-USD,X:ETH-USD)"),
+    }, async ({ symbols }) => {
+        return toolResult(await client().get("/crypto/live/trades/latest", { symbols }));
+    });
+    server.tool("get_crypto_latest_quote_time", "Get the timestamp of the last crypto quote received by the live feed.", {}, async () => {
+        return toolResult(await client().get("/crypto/live/quotes/latest-time"));
+    });
+    server.tool("get_crypto_top_of_book", "Get the current top-of-book bid/ask quote for each requested crypto symbol.", {
+        symbols: z
+            .string()
+            .describe("Comma-separated symbols (e.g. X:BTC-USD,X:ETH-USD)"),
+    }, async ({ symbols }) => {
+        return toolResult(await client().get("/crypto/live/quotes/top-of-book", { symbols }));
+    });
+    // ---------------------------------------------------------------------------
+    // Live — Aggregates
+    // ---------------------------------------------------------------------------
+    server.tool("get_crypto_live_agg_latest_time", "Get the timestamp of the last trade received by the crypto live aggregates subsystem.", {}, async () => {
+        return toolResult(await client().get("/crypto/live/agg/trades/latest-time"));
+    });
+    server.tool("get_crypto_live_ohlcs", "Get crypto OHLC candles for the current trading day.", {
+        frequency: z
+            .enum(["Minute"])
+            .describe("Candle frequency (currently only Minute for live)"),
+        symbol: z.string().describe("Symbol to fetch (e.g. X:BTC-USD)"),
+    }, async ({ frequency, symbol }) => {
+        return toolResult(await client().get("/crypto/live/agg/ohlcs", { frequency, symbol }));
+    });
+    // ---------------------------------------------------------------------------
+    // History
+    // ---------------------------------------------------------------------------
+    server.tool("get_crypto_historical_ohlcs", "Get historical crypto OHLC candles. For Second/Minute frequency, from and to must be within the same day.", {
+        frequency: z
+            .enum(["Second", "Minute", "Hour", "Day"])
+            .describe("Candle frequency"),
+        symbols: z
+            .string()
+            .describe("Comma-separated symbols (e.g. X:BTC-USD,X:ETH-USD)"),
+        from: z
+            .string()
+            .describe("Start timestamp inclusive (yyyy-MM-DDThh:mm:ss)"),
+        to: z
+            .string()
+            .describe("End timestamp inclusive (yyyy-MM-DDThh:mm:ss)"),
+    }, async ({ frequency, symbols, from, to }) => {
+        return toolResult(await client().get("/crypto/history/ohlcs", {
+            frequency,
+            symbols,
+            from,
+            to,
+        }));
+    });
+    server.tool("get_crypto_top_gainers", "Get crypto assets that gained at or above a threshold percentage.", {
+        date: z.string().describe("Date (yyyy-MM-dd)"),
+        gainThreshold: z
+            .number()
+            .describe("Minimum gain percentage (e.g. 2 = 2%)"),
+        maxCount: z
+            .number()
+            .int()
+            .optional()
+            .describe("Max results (0 or omit for all)"),
+    }, async ({ date, gainThreshold, maxCount }) => {
+        return toolResult(await client().get("/crypto/history/top-gainers", {
+            date,
+            gainThreshold,
+            maxCount,
+        }));
+    });
+}
+//# sourceMappingURL=crypto.js.map

package/dist/tools/crypto.js.map

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

package/dist/tools/deployment.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EnvironmentManager } from "../environment.js";
+export declare function registerDeploymentTools(server: McpServer, envManager: EnvironmentManager): void;

package/dist/tools/deployment.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { toolResult } from "../util.js";
+export function registerDeploymentTools(server, envManager) {
+    const client = () => envManager.getClient();
+    server.tool("ping", "Health check for the Datafye environment. Optionally filter by dataset (SIP, Synthetic, Crypto), service (Reference, Feed, Agg, History), or system name. Returns service health status.", {
+        dataset: z
+            .enum(["SIP", "Synthetic", "Crypto"])
+            .optional()
+            .describe("Filter to a specific dataset"),
+        service: z
+            .enum(["Reference", "Feed", "Agg", "History"])
+            .optional()
+            .describe("Filter to a specific service within the dataset"),
+        system: z
+            .string()
+            .optional()
+            .describe("Check health of a specific system by name (mutually exclusive with dataset)"),
+    }, async ({ dataset, service, system }) => {
+        return toolResult(await client().get("/health/ping", { dataset, service, system }));
+    });
+    server.tool("get_deployed_datasets", "Get the list of datasets deployed in this environment (e.g. SIP, Synthetic, Crypto).", {}, async () => {
+        return toolResult(await client().get("/deployment/datasets"));
+    });
+    server.tool("get_deployed_systems", "Get the list of systems deployed in this environment (e.g. datafye-sip-system, datafye-api-system).", {}, async () => {
+        return toolResult(await client().get("/deployment/systems"));
+    });
+    server.tool("get_deployed_symbols", "Get the map of dataset to allowed symbols. An asterisk (*) means all symbols are allowed.", {}, async () => {
+        return toolResult(await client().get("/deployment/symbols"));
+    });
+    server.tool("get_deployment_descriptor", "Get the deployment descriptor (YAML configuration) used to provision this environment.", {
+        pretty: z
+            .boolean()
+            .optional()
+            .describe("If true, returns raw YAML; otherwise a JSON wrapper"),
+    }, async ({ pretty }) => {
+        return toolResult(await client().get("/deployment/descriptor", { pretty }));
+    });
+}
+//# sourceMappingURL=deployment.js.map

package/dist/tools/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","sourceRoot":"","sources":["../../src/tools/deployment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,uBAAuB,CACrC,MAAiB,EACjB,UAA8B;IAE9B,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;IAE5C,MAAM,CAAC,IAAI,CACT,MAAM,EACN,0LAA0L,EAC1L;QACE,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;aACpC,QAAQ,EAAE;aACV,QAAQ,CAAC,8BAA8B,CAAC;QAC3C,OAAO,EAAE,CAAC;aACP,IAAI,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;aAC7C,QAAQ,EAAE;aACV,QAAQ,CAAC,iDAAiD,CAAC;QAC9D,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,6EAA6E,CAC9E;KACJ,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE;QACrC,OAAO,UAAU,CACf,MAAM,MAAM,EAAE,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CACjE,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,uBAAuB,EACvB,sFAAsF,EACtF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAChE,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,qGAAqG,EACrG,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/D,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,2FAA2F,EAC3F,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC/D,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,wFAAwF,EACxF;QACE,MAAM,EAAE,CAAC;aACN,OAAO,EAAE;aACT,QAAQ,EAAE;aACV,QAAQ,CAAC,qDAAqD,CAAC;KACnE,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QACnB,OAAO,UAAU,CAAC,MAAM,MAAM,EAAE,CAAC,GAAG,CAAC,wBAAwB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/environment.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EnvironmentManager } from "../environment.js";
+export declare function registerEnvironmentTools(server: McpServer, envManager: EnvironmentManager): void;

package/dist/tools/environment.js

@@ -0,0 +1,16 @@
+import { z } from "zod";
+import { toolResult } from "../util.js";
+export function registerEnvironmentTools(server, envManager) {
+    server.tool("connect", "Connect to a Datafye environment by URL. Use this when the environment is running outside the default network (e.g. on the host machine or a remote cloud). The URL should point to the REST API base (e.g. https://myfoundry-foundry-dev-api.datafye.io).", {
+        url: z
+            .string()
+            .describe("Base URL of the Datafye REST API (e.g. http://localhost:7776 or https://myfoundry-foundry-dev-api.datafye.io)"),
+    }, async ({ url }) => {
+        const result = envManager.connect(url);
+        return toolResult(result);
+    });
+    server.tool("status", "Get the current connection status — shows which Datafye environment URL is active.", {}, async () => {
+        return toolResult(envManager.getStatus());
+    });
+}
+//# sourceMappingURL=environment.js.map

package/dist/tools/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/tools/environment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,UAAU,wBAAwB,CACtC,MAAiB,EACjB,UAA8B;IAE9B,MAAM,CAAC,IAAI,CACT,SAAS,EACT,4PAA4P,EAC5P;QACE,GAAG,EAAE,CAAC;aACH,MAAM,EAAE;aACR,QAAQ,CACP,+GAA+G,CAChH;KACJ,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAChB,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,oFAAoF,EACpF,EAAE,EACF,KAAK,IAAI,EAAE;QACT,OAAO,UAAU,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/stocks-backtest.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EnvironmentManager } from "../environment.js";
+export declare function registerStocksBacktestTools(server: McpServer, envManager: EnvironmentManager): void;

package/dist/tools/stocks-backtest.js

@@ -0,0 +1,248 @@
+import { z } from "zod";
+import { toolResult } from "../util.js";
+const datasetParam = z
+    .enum(["SIP", "Synthetic"])
+    .optional()
+    .describe("Dataset (default: SIP)");
+export function registerStocksBacktestTools(server, envManager) {
+    const client = () => envManager.getClient();
+    // ---------------------------------------------------------------------------
+    // Clear backtest state (shared across all datasets)
+    // ---------------------------------------------------------------------------
+    server.tool("clear_backtest_state", "Clear all backtest state in the Foundry environment. Call this before starting a new backtest to ensure a clean slate. Typical workflow: 1) fetch history, 2) clear state, 3) start replay.", {}, async () => {
+        return toolResult(await client().del("/backtest/state"));
+    });
+    // ---------------------------------------------------------------------------
+    // Tick History Fetch
+    // ---------------------------------------------------------------------------
+    server.tool("start_stocks_tick_fetch", "Start fetching tick history (trades and/or quotes) from the data provider for backtest replay. Foundry only.", {
+        dataset: datasetParam,
+        date: z.string().describe("Start date (yyyy-MM-dd)"),
+        symbols: z
+            .string()
+            .optional()
+            .describe("Comma-separated symbols. Omit for all."),
+        noTrades: z
+            .boolean()
+            .optional()
+            .describe("Exclude trade data (default: false)"),
+        noQuotes: z
+            .boolean()
+            .optional()
+            .describe("Exclude quote data (default: false)"),
+        numDays: z
+            .number()
+            .int()
+            .optional()
+            .describe("Number of days from start date (default: 1)"),
+        sortByExchangeTs: z
+            .boolean()
+            .optional()
+            .describe("Sort by exchange timestamp (default: true)"),
+    }, async ({ dataset, date, symbols, noTrades, noQuotes, numDays, sortByExchangeTs }) => {
+        return toolResult(await client().startBacktestHistoryFetch("stocks", "ticks", {
+            dataset,
+            date,
+            symbols,
+            noTrades,
+            noQuotes,
+            numDays,
+            sortByExchangeTs,
+        }));
+    });
+    server.tool("check_stocks_tick_fetch", "Check whether a stocks tick history fetch is currently running.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().checkBacktestHistoryFetch("stocks", "ticks", { dataset }));
+    });
+    server.tool("cancel_stocks_tick_fetch", "Cancel a running stocks tick history fetch.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().cancelBacktestHistoryFetch("stocks", "ticks", { dataset }));
+    });
+    // ---------------------------------------------------------------------------
+    // Quote History Fetch
+    // ---------------------------------------------------------------------------
+    server.tool("start_stocks_quote_fetch", "Start fetching quote history from the data provider. Use this if your algo only needs quotes. Otherwise prefer tick history (includes both). Foundry only.", {
+        dataset: datasetParam,
+        date: z.string().describe("Start date (yyyy-MM-dd)"),
+        symbols: z
+            .string()
+            .optional()
+            .describe("Comma-separated symbols. Omit for all."),
+        numDays: z
+            .number()
+            .int()
+            .optional()
+            .describe("Number of days (default: 1)"),
+        format: z
+            .enum(["Binary", "Json", "Csv"])
+            .optional()
+            .describe("Output format (default: Binary — use Binary for replay)"),
+        sortByExchangeTs: z
+            .boolean()
+            .optional()
+            .describe("Sort by exchange timestamp (default: true)"),
+        groupBySymbol: z
+            .boolean()
+            .optional()
+            .describe("Group output files by symbol (default: false)"),
+    }, async ({ dataset, date, symbols, numDays, format, sortByExchangeTs, groupBySymbol }) => {
+        return toolResult(await client().startBacktestHistoryFetch("stocks", "quotes", {
+            dataset,
+            date,
+            symbols,
+            numDays,
+            format,
+            sortByExchangeTs,
+            groupBySymbol,
+        }));
+    });
+    server.tool("check_stocks_quote_fetch", "Check whether a stocks quote history fetch is currently running.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().checkBacktestHistoryFetch("stocks", "quotes", { dataset }));
+    });
+    server.tool("cancel_stocks_quote_fetch", "Cancel a running stocks quote history fetch.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().cancelBacktestHistoryFetch("stocks", "quotes", { dataset }));
+    });
+    // ---------------------------------------------------------------------------
+    // Trade History Fetch
+    // ---------------------------------------------------------------------------
+    server.tool("start_stocks_trade_fetch", "Start fetching trade history from the data provider. Use this if your algo only needs trades. Otherwise prefer tick history (includes both). Foundry only.", {
+        dataset: datasetParam,
+        date: z.string().describe("Start date (yyyy-MM-dd)"),
+        symbols: z
+            .string()
+            .optional()
+            .describe("Comma-separated symbols. Omit for all."),
+        numDays: z
+            .number()
+            .int()
+            .optional()
+            .describe("Number of days (default: 1)"),
+        format: z
+            .enum(["Binary", "Json", "Csv"])
+            .optional()
+            .describe("Output format (default: Binary — use Binary for replay)"),
+        sortByExchangeTs: z
+            .boolean()
+            .optional()
+            .describe("Sort by exchange timestamp (default: true)"),
+        groupBySymbol: z
+            .boolean()
+            .optional()
+            .describe("Group output files by symbol (default: false)"),
+    }, async ({ dataset, date, symbols, numDays, format, sortByExchangeTs, groupBySymbol }) => {
+        return toolResult(await client().startBacktestHistoryFetch("stocks", "trades", {
+            dataset,
+            date,
+            symbols,
+            numDays,
+            format,
+            sortByExchangeTs,
+            groupBySymbol,
+        }));
+    });
+    server.tool("check_stocks_trade_fetch", "Check whether a stocks trade history fetch is currently running.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().checkBacktestHistoryFetch("stocks", "trades", { dataset }));
+    });
+    server.tool("cancel_stocks_trade_fetch", "Cancel a running stocks trade history fetch.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().cancelBacktestHistoryFetch("stocks", "trades", { dataset }));
+    });
+    // ---------------------------------------------------------------------------
+    // OHLC History Fetch
+    // ---------------------------------------------------------------------------
+    server.tool("start_stocks_ohlc_fetch", "Start fetching OHLC history at a given frequency from the data provider. Foundry only.", {
+        dataset: datasetParam,
+        date: z.string().describe("Start date (yyyy-MM-dd)"),
+        symbols: z
+            .string()
+            .optional()
+            .describe("Comma-separated symbols. Omit for all."),
+        numDays: z
+            .number()
+            .int()
+            .optional()
+            .describe("Number of days (default: 1)"),
+        frequency: z
+            .enum(["Second", "Minute", "Hour", "Day"])
+            .describe("OHLC frequency"),
+        adjusted: z
+            .boolean()
+            .optional()
+            .describe("Fetch split-adjusted data (default: false)"),
+    }, async ({ dataset, date, symbols, numDays, frequency, adjusted }) => {
+        return toolResult(await client().startBacktestHistoryFetch("stocks", "ohlcs", {
+            dataset,
+            date,
+            symbols,
+            numDays,
+            frequency,
+            adjusted,
+        }));
+    });
+    server.tool("check_stocks_ohlc_fetch", "Check whether a stocks OHLC history fetch is currently running.", {
+        dataset: datasetParam,
+        frequency: z
+            .enum(["Second", "Minute", "Hour", "Day"])
+            .describe("OHLC frequency to check"),
+    }, async ({ dataset, frequency }) => {
+        return toolResult(await client().checkBacktestHistoryFetch("stocks", "ohlcs", {
+            dataset,
+            frequency,
+        }));
+    });
+    server.tool("cancel_stocks_ohlc_fetch", "Cancel a running stocks OHLC history fetch.", {
+        dataset: datasetParam,
+        frequency: z
+            .enum(["Second", "Minute", "Hour", "Day"])
+            .describe("OHLC frequency to cancel"),
+    }, async ({ dataset, frequency }) => {
+        return toolResult(await client().cancelBacktestHistoryFetch("stocks", "ohlcs", {
+            dataset,
+            frequency,
+        }));
+    });
+    // ---------------------------------------------------------------------------
+    // Tick History Replay
+    // ---------------------------------------------------------------------------
+    server.tool("start_stocks_tick_replay", "Start replaying previously fetched tick history data. This drives backtest execution. Foundry only. Typical workflow: 1) fetch tick history, 2) clear backtest state, 3) start tick replay.", {
+        dataset: datasetParam,
+        date: z
+            .string()
+            .describe("Date of previously fetched tick history (yyyy-MM-dd)"),
+        rateType: z
+            .enum(["Exact", "MultipleOfActual"])
+            .optional()
+            .describe("Replay rate type (default: Exact)"),
+        rate: z
+            .number()
+            .int()
+            .optional()
+            .describe("Replay rate multiplier when rateType=MultipleOfActual (default: 1)"),
+        startTime: z
+            .string()
+            .optional()
+            .describe('Time within day to start replay (hh:mm or "now", default: "now")'),
+        startPoint: z
+            .string()
+            .optional()
+            .describe('Offset from start-of-day, e.g. "9.5h", "30m" (default: "9.5h")'),
+        duration: z
+            .string()
+            .optional()
+            .describe('Replay window duration, e.g. "6.5h", "30m" (default: "6.5h")'),
+    }, async ({ dataset, date, rateType, rate, startTime, startPoint, duration }) => {
+        return toolResult(await client().startBacktestReplay("stocks", "ticks", {
+            dataset,
+            date,
+            rateType,
+            rate,
+            startTime,
+            startPoint,
+            duration,
+        }));
+    });
+    server.tool("check_stocks_tick_replay", "Check whether a stocks tick history replay is currently running.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().checkBacktestReplay("stocks", "ticks", { dataset }));
+    });
+    server.tool("cancel_stocks_tick_replay", "Cancel a running stocks tick history replay.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().cancelBacktestReplay("stocks", "ticks", { dataset }));
+    });
+}
+//# sourceMappingURL=stocks-backtest.js.map

package/dist/tools/stocks-backtest.js.map

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

package/dist/tools/stocks.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { EnvironmentManager } from "../environment.js";
+export declare function registerStocksTools(server: McpServer, envManager: EnvironmentManager): void;

package/dist/tools/stocks.js

@@ -0,0 +1,150 @@
+import { z } from "zod";
+import { toolResult } from "../util.js";
+const datasetParam = z
+    .enum(["SIP", "Synthetic"])
+    .optional()
+    .describe("Dataset (default: SIP)");
+export function registerStocksTools(server, envManager) {
+    const client = () => envManager.getClient();
+    // ---------------------------------------------------------------------------
+    // Reference
+    // ---------------------------------------------------------------------------
+    server.tool("get_stocks_securities", "Get the securities master (symbol, name, exchange) for a stocks dataset.", {
+        dataset: datasetParam,
+        date: z
+            .string()
+            .optional()
+            .describe("Date (yyyy-MM-dd). Omit for current date."),
+        exchanges: z
+            .string()
+            .optional()
+            .describe("Comma-separated exchange filter"),
+    }, async ({ dataset, date, exchanges }) => {
+        return toolResult(await client().get("/stocks/reference/securities", {
+            dataset,
+            date,
+            exchanges,
+        }));
+    });
+    // ---------------------------------------------------------------------------
+    // Live — Tick Data
+    // ---------------------------------------------------------------------------
+    server.tool("get_stocks_latest_trade_time", "Get the timestamp of the last trade received by the live feed.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().get("/stocks/live/trades/latest-time", { dataset }));
+    });
+    server.tool("get_stocks_latest_trades", "Get the last trade for each requested symbol from the live feed.", {
+        dataset: datasetParam,
+        symbols: z
+            .string()
+            .describe("Comma-separated symbols (e.g. AAPL,MSFT)"),
+    }, async ({ dataset, symbols }) => {
+        return toolResult(await client().get("/stocks/live/trades/latest", { dataset, symbols }));
+    });
+    server.tool("get_stocks_latest_quote_time", "Get the timestamp of the last quote received by the live feed.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().get("/stocks/live/quotes/latest-time", { dataset }));
+    });
+    server.tool("get_stocks_top_of_book", "Get the current top-of-book bid/ask quote for each requested symbol.", {
+        dataset: datasetParam,
+        symbols: z
+            .string()
+            .describe("Comma-separated symbols (e.g. AAPL,MSFT)"),
+    }, async ({ dataset, symbols }) => {
+        return toolResult(await client().get("/stocks/live/quotes/top-of-book", {
+            dataset,
+            symbols,
+        }));
+    });
+    // ---------------------------------------------------------------------------
+    // Live — Aggregates
+    // ---------------------------------------------------------------------------
+    server.tool("get_stocks_live_agg_latest_time", "Get the timestamp of the last trade received by the live aggregates subsystem.", { dataset: datasetParam }, async ({ dataset }) => {
+        return toolResult(await client().get("/stocks/live/agg/trades/latest-time", { dataset }));
+    });
+    server.tool("get_stocks_live_ohlcs", "Get OHLC candles for the current trading day. Optionally include prior days with the history parameter.", {
+        dataset: datasetParam,
+        frequency: z
+            .enum(["Minute"])
+            .describe("Candle frequency (currently only Minute for live)"),
+        symbol: z.string().describe("Symbol to fetch (e.g. AAPL)"),
+        history: z
+            .number()
+            .int()
+            .optional()
+            .describe("Number of prior days to include (default: 0)"),
+    }, async ({ dataset, frequency, symbol, history }) => {
+        return toolResult(await client().get("/stocks/live/agg/ohlcs", {
+            dataset,
+            frequency,
+            symbol,
+            history,
+        }));
+    });
+    server.tool("get_stocks_live_smas", "Get Simple Moving Averages (SMAs) for the current trading day.", {
+        dataset: datasetParam,
+        frequency: z.enum(["Minute"]).describe("Frequency"),
+        symbol: z.string().describe("Symbol to fetch"),
+    }, async ({ dataset, frequency, symbol }) => {
+        return toolResult(await client().get("/stocks/live/agg/smas", {
+            dataset,
+            frequency,
+            symbol,
+        }));
+    });
+    server.tool("get_stocks_live_emas", "Get Exponential Moving Averages (EMAs) for the current trading day, including MACD values and crossover states.", {
+        dataset: datasetParam,
+        frequency: z.enum(["Minute"]).describe("Frequency"),
+        symbol: z.string().describe("Symbol to fetch"),
+    }, async ({ dataset, frequency, symbol }) => {
+        return toolResult(await client().get("/stocks/live/agg/emas", {
+            dataset,
+            frequency,
+            symbol,
+        }));
+    });
+    // ---------------------------------------------------------------------------
+    // History
+    // ---------------------------------------------------------------------------
+    server.tool("get_stocks_historical_ohlcs", "Get historical OHLC candles. For Second/Minute frequency, from and to must be within the same day.", {
+        dataset: datasetParam,
+        frequency: z
+            .enum(["Second", "Minute", "Hour", "Day"])
+            .describe("Candle frequency"),
+        symbols: z
+            .string()
+            .describe("Comma-separated symbols (e.g. AAPL,MSFT)"),
+        from: z
+            .string()
+            .describe("Start timestamp inclusive (yyyy-MM-DDThh:mm:ss)"),
+        to: z
+            .string()
+            .describe("End timestamp inclusive (yyyy-MM-DDThh:mm:ss)"),
+    }, async ({ dataset, frequency, symbols, from, to }) => {
+        return toolResult(await client().get("/stocks/history/ohlcs", {
+            dataset,
+            frequency,
+            symbols,
+            from,
+            to,
+        }));
+    });
+    server.tool("get_stocks_top_gainers", "Get stocks that gained at or above a threshold percentage compared to the prior trading day.", {
+        dataset: datasetParam,
+        date: z.string().describe("Date (yyyy-MM-dd)"),
+        gainThreshold: z
+            .number()
+            .describe("Minimum gain percentage (e.g. 2 = 2%)"),
+        maxCount: z
+            .number()
+            .int()
+            .optional()
+            .describe("Max results (0 or omit for all)"),
+    }, async ({ dataset, date, gainThreshold, maxCount }) => {
+        return toolResult(await client().get("/stocks/history/top-gainers", {
+            dataset,
+            date,
+            gainThreshold,
+            maxCount,
+        }));
+    });
+}
+//# sourceMappingURL=stocks.js.map

package/dist/tools/stocks.js.map

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

package/dist/util.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wrap an API response into the MCP ToolResultBlockParam format.
+ */
+export declare function toolResult(data: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/util.js

@@ -0,0 +1,14 @@
+/**
+ * Wrap an API response into the MCP ToolResultBlockParam format.
+ */
+export function toolResult(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=util.js.map