@oobe-protocol-labs/sap-mcp-server 0.9.38 → 0.9.50

package/dist/perps/chart-tools.js

@@ -0,0 +1,341 @@
+/**
+ * @name perps/chart-tools
+ * @description Chart tool registrations: OHLC, long-term price history, and volume profile.
+ *
+ * @module perps/chart-tools
+ */
+import { createTextResponse } from '../adapters/mcp/tool-response.js';
+import { registerTool } from '../adapters/mcp/sdk-compat.js';
+import { DEFAULT_VP_BUCKETS, DEXSCREENER_API_URL, DEFILAMA_API_URL, VALUE_AREA_PCT, timedFetch, } from './perp-constants.js';
+/* ═══════════════════════════════════════════════════════════════════
+ *  Tool 4: sap_chart_ohlc
+ * ═══════════════════════════════════════════════════════════════════ */
+/**
+ * @name registerChartOhlcTool
+ * @description Register the sap_chart_ohlc read-only tool.
+ *
+ * Fetches OHLC candlestick data for any Solana token from DexScreener's
+ * free REST API.
+ *
+ * @param server  — MCP server instance.
+ * @param context — Runtime context (unused — pure REST call).
+ *
+ * @internal
+ */
+export function registerChartOhlcTool(server, _context) {
+    const schema = {
+        type: 'object',
+        properties: {
+            mint: {
+                type: 'string',
+                description: 'Token mint address (base58) to fetch OHLC data for.',
+            },
+            resolution: {
+                type: 'string',
+                description: 'Chart resolution: "5m", "1h", "6h", "24h" (default "1h").',
+                enum: ['5m', '1h', '6h', '24h'],
+            },
+        },
+        required: ['mint'],
+        additionalProperties: false,
+    };
+    registerTool(server, 'sap_chart_ohlc', {
+        description: 'Fetch OHLC candlestick data for any Solana token from DexScreener. Returns open, high, low, close, volume, liquidity, and FDV. Read-only — uses free DexScreener REST API.',
+        inputSchema: schema,
+    }, async (args) => {
+        const mint = typeof args['mint'] === 'string' ? args['mint'] : '';
+        const resolution = typeof args['resolution'] === 'string' ? args['resolution'] : '1h';
+        if (!mint) {
+            return createTextResponse(JSON.stringify({ error: 'mint is required' }), { isError: true });
+        }
+        const url = `${DEXSCREENER_API_URL}/tokens/v1/solana/${encodeURIComponent(mint)}`;
+        const pairs = await timedFetch(url);
+        if (!pairs || pairs.length === 0) {
+            return createTextResponse(JSON.stringify({
+                error: 'No DexScreener pairs found for this mint',
+                mint,
+            }), { isError: true });
+        }
+        const pair = pairs[0];
+        const priceUsd = pair.priceUsd ? parseFloat(pair.priceUsd) : 0;
+        if (priceUsd <= 0) {
+            return createTextResponse(JSON.stringify({
+                error: 'No valid price data from DexScreener',
+                mint,
+            }), { isError: true });
+        }
+        const priceChange = pair.priceChange ?? {};
+        const volume = pair.volume ?? {};
+        const liquidity = pair.liquidity?.usd ?? 0;
+        const fdv = pair.fdv ?? 0;
+        // Derive OHLC from price change percentages for the requested resolution.
+        const changeMap = {
+            '5m': priceChange['m5'] ?? 0,
+            '1h': priceChange['h1'] ?? 0,
+            '6h': priceChange['h6'] ?? 0,
+            '24h': priceChange['h24'] ?? 0,
+        };
+        const changePct = changeMap[resolution] ?? changeMap['1h'];
+        const open = priceUsd / (1 + changePct / 100);
+        const close = priceUsd;
+        const high = Math.max(open, close) * 1.001;
+        const low = Math.min(open, close) * 0.999;
+        const volMap = {
+            '5m': (volume['m5'] ?? 0),
+            '1h': (volume['h1'] ?? 0),
+            '6h': (volume['h6'] ?? 0),
+            '24h': (volume['h24'] ?? 0),
+        };
+        const vol = volMap[resolution] ?? volMap['1h'];
+        const candle = {
+            timestamp: Date.now(),
+            open,
+            high,
+            low,
+            close,
+            volume: vol,
+        };
+        return createTextResponse(JSON.stringify({
+            mint,
+            symbol: pair.baseToken?.symbol ?? 'unknown',
+            resolution,
+            candle,
+            liquidityUsd: liquidity,
+            fdv,
+            priceUsd,
+        }));
+    });
+}
+/* ═══════════════════════════════════════════════════════════════════
+ *  Tool 5: sap_chart_long_term
+ * ═══════════════════════════════════════════════════════════════════ */
+/**
+ * @name registerChartLongTermTool
+ * @description Register the sap_chart_long_term read-only tool.
+ *
+ * Fetches long-term price history for a Solana token from DexScreener
+ * and optional protocol TVL data from DeFiLlama.
+ *
+ * @param server  — MCP server instance.
+ * @param context — Runtime context (unused — pure REST call).
+ *
+ * @internal
+ */
+export function registerChartLongTermTool(server, _context) {
+    const schema = {
+        type: 'object',
+        properties: {
+            mint: {
+                type: 'string',
+                description: 'Token mint address (base58) for price history.',
+            },
+            protocol: {
+                type: 'string',
+                description: 'Optional DeFiLlama protocol slug for TVL history (e.g. "jupiter", "raydium").',
+            },
+        },
+        required: ['mint'],
+        additionalProperties: false,
+    };
+    registerTool(server, 'sap_chart_long_term', {
+        description: 'Fetch long-term price history for a Solana token from DexScreener and optional protocol TVL data from DeFiLlama. Returns price changes, volume, liquidity, FDV, and TVL history. Read-only — uses free REST APIs.',
+        inputSchema: schema,
+    }, async (args) => {
+        const mint = typeof args['mint'] === 'string' ? args['mint'] : '';
+        const protocol = typeof args['protocol'] === 'string' ? args['protocol'] : '';
+        if (!mint) {
+            return createTextResponse(JSON.stringify({ error: 'mint is required' }), { isError: true });
+        }
+        // Fetch token price data from DexScreener.
+        const dexUrl = `${DEXSCREENER_API_URL}/tokens/v1/solana/${encodeURIComponent(mint)}`;
+        const pairs = await timedFetch(dexUrl);
+        let priceData = {};
+        if (pairs && pairs.length > 0) {
+            const pair = pairs[0];
+            priceData = {
+                symbol: pair.baseToken?.symbol ?? 'unknown',
+                priceUsd: pair.priceUsd ?? '0',
+                priceChange: pair.priceChange ?? {},
+                volume: pair.volume ?? {},
+                liquidityUsd: pair.liquidity?.usd ?? 0,
+                fdv: pair.fdv ?? 0,
+            };
+        }
+        // Fetch protocol TVL from DeFiLlama if requested.
+        let tvlData = {};
+        if (protocol) {
+            const llamaUrl = `${DEFILAMA_API_URL}/protocol/${encodeURIComponent(protocol)}`;
+            const protoData = await timedFetch(llamaUrl);
+            if (protoData) {
+                tvlData = {
+                    name: protoData.name,
+                    currentTvl: protoData.tvl,
+                    change1d: protoData.change_1d,
+                    change7d: protoData.change_7d,
+                    marketcap: protoData.marketcap,
+                    chain: protoData.chain,
+                };
+            }
+        }
+        if (Object.keys(priceData).length === 0 && Object.keys(tvlData).length === 0) {
+            return createTextResponse(JSON.stringify({
+                error: 'No data available from DexScreener or DeFiLlama',
+                mint,
+                protocol,
+            }), { isError: true });
+        }
+        return createTextResponse(JSON.stringify({
+            mint,
+            token: priceData,
+            protocolTvl: tvlData,
+        }));
+    });
+}
+/* ═══════════════════════════════════════════════════════════════════
+ *  Tool 6: sap_chart_volume_profile
+ * ═══════════════════════════════════════════════════════════════════ */
+/**
+ * @name computeVolumeProfile
+ * @description Compute volume profile (POC, VAH, VAL) from price and volume arrays.
+ *
+ * Pure TypeScript implementation — no external indicator library.
+ *
+ * @param prices       — Array of price points.
+ * @param volumes      — Array of volume values (same length as prices).
+ * @param bucketCount  — Number of price buckets (default 20).
+ * @returns Volume profile result with POC, VAH, VAL, and buckets.
+ *
+ * @internal
+ */
+function computeVolumeProfile(prices, volumes, bucketCount = DEFAULT_VP_BUCKETS) {
+    if (prices.length === 0 || volumes.length === 0) {
+        return { poc: 0, vah: 0, val: 0, buckets: [] };
+    }
+    const minPrice = Math.min(...prices);
+    const maxPrice = Math.max(...prices);
+    const range = maxPrice - minPrice;
+    if (range === 0) {
+        return { poc: minPrice, vah: minPrice, val: minPrice, buckets: [{ priceLow: minPrice, priceHigh: minPrice, volume: volumes.reduce((a, b) => a + b, 0), pctOfTotal: 1 }] };
+    }
+    const bucketSize = range / bucketCount;
+    const buckets = Array.from({ length: bucketCount }, (_, i) => ({
+        priceLow: minPrice + i * bucketSize,
+        priceHigh: minPrice + (i + 1) * bucketSize,
+        volume: 0,
+        pctOfTotal: 0,
+    }));
+    const totalVolume = volumes.reduce((a, b) => a + b, 0);
+    if (totalVolume === 0) {
+        return { poc: minPrice, vah: maxPrice, val: minPrice, buckets };
+    }
+    for (let i = 0; i < prices.length; i++) {
+        const bucketIdx = Math.min(Math.floor((prices[i] - minPrice) / bucketSize), bucketCount - 1);
+        buckets[bucketIdx].volume += volumes[i];
+    }
+    for (const b of buckets) {
+        b.pctOfTotal = b.volume / totalVolume;
+    }
+    // POC = bucket with highest volume.
+    let pocIdx = 0;
+    for (let i = 1; i < buckets.length; i++) {
+        if (buckets[i].volume > buckets[pocIdx].volume)
+            pocIdx = i;
+    }
+    const poc = (buckets[pocIdx].priceLow + buckets[pocIdx].priceHigh) / 2;
+    // Value area: 70% of volume around POC.
+    let volAccum = buckets[pocIdx].volume;
+    let lowIdx = pocIdx - 1;
+    let highIdx = pocIdx + 1;
+    while (volAccum / totalVolume < VALUE_AREA_PCT && (lowIdx >= 0 || highIdx < buckets.length)) {
+        const lowVol = lowIdx >= 0 ? buckets[lowIdx].volume : 0;
+        const highVol = highIdx < buckets.length ? buckets[highIdx].volume : 0;
+        if (lowVol >= highVol && lowIdx >= 0) {
+            volAccum += lowVol;
+            lowIdx--;
+        }
+        else if (highIdx < buckets.length) {
+            volAccum += highVol;
+            highIdx++;
+        }
+        else {
+            break;
+        }
+    }
+    const val = buckets[lowIdx + 1]?.priceLow ?? minPrice;
+    const vah = buckets[highIdx - 1]?.priceHigh ?? maxPrice;
+    return { poc, vah, val, buckets };
+}
+/**
+ * @name registerChartVolumeProfileTool
+ * @description Register the sap_chart_volume_profile read-only tool.
+ *
+ * @param server  — MCP server instance.
+ * @param context — Runtime context (unused — pure REST + local math).
+ *
+ * @internal
+ */
+export function registerChartVolumeProfileTool(server, _context) {
+    const schema = {
+        type: 'object',
+        properties: {
+            mint: {
+                type: 'string',
+                description: 'Token mint address (base58) to compute volume profile for.',
+            },
+            buckets: {
+                type: 'number',
+                description: 'Number of price buckets (default 20).',
+                minimum: 5,
+                maximum: 100,
+            },
+        },
+        required: ['mint'],
+        additionalProperties: false,
+    };
+    registerTool(server, 'sap_chart_volume_profile', {
+        description: 'Compute volume profile (POC, VAH, VAL) for any Solana token using DexScreener price and volume data. Returns point of control, value area high/low, and bucket distribution. Read-only — uses free DexScreener REST API + local computation.',
+        inputSchema: schema,
+    }, async (args) => {
+        const mint = typeof args['mint'] === 'string' ? args['mint'] : '';
+        const bucketCount = typeof args['buckets'] === 'number' ? args['buckets'] : DEFAULT_VP_BUCKETS;
+        if (!mint) {
+            return createTextResponse(JSON.stringify({ error: 'mint is required' }), { isError: true });
+        }
+        // Fetch token data from DexScreener.
+        const url = `${DEXSCREENER_API_URL}/tokens/v1/solana/${encodeURIComponent(mint)}`;
+        const pairs = await timedFetch(url);
+        if (!pairs || pairs.length === 0) {
+            return createTextResponse(JSON.stringify({ error: 'No DexScreener data for this mint' }), { isError: true });
+        }
+        const pair = pairs[0];
+        const priceUsd = pair.priceUsd ? parseFloat(pair.priceUsd) : 0;
+        if (priceUsd <= 0) {
+            return createTextResponse(JSON.stringify({ error: 'No valid price data' }), { isError: true });
+        }
+        // Derive price points from price change percentages.
+        const pc = pair.priceChange ?? {};
+        const vol = pair.volume ?? {};
+        const prices = [
+            priceUsd / (1 + (pc['m5'] ?? 0) / 100),
+            priceUsd / (1 + (pc['h1'] ?? 0) / 100),
+            priceUsd / (1 + (pc['h6'] ?? 0) / 100),
+            priceUsd / (1 + (pc['h24'] ?? 0) / 100),
+            priceUsd,
+        ];
+        const volumes = [
+            vol['m5'] ?? 0,
+            vol['h1'] ?? 0,
+            vol['h6'] ?? 0,
+            vol['h24'] ?? 0,
+            vol['h24'] ?? 0,
+        ];
+        const profile = computeVolumeProfile(prices, volumes, bucketCount);
+        return createTextResponse(JSON.stringify({
+            mint,
+            symbol: pair.baseToken?.symbol ?? 'unknown',
+            priceUsd,
+            volumeProfile: profile,
+        }));
+    });
+}
+//# sourceMappingURL=chart-tools.js.map

package/dist/perps/chart-tools.js.map

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

package/dist/perps/perp-analytics-tools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @name perps/perp-analytics-tools
+ * @description Perp analytics tool registrations: markets, position info, funding history,
+ *              liquidation zones, trade plan, builder status, and optional order builder.
+ *
+ * @module perps/perp-analytics-tools
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { SapMcpContext } from '../core/types.js';
+/**
+ * @name registerPerpTools
+ * @description Register perp trading analytics, planning, and optional execution-builder tools.
+ *
+ * @param server  — MCP server instance.
+ * @param context — Shared runtime context with SAP client, connection, and config.
+ *
+ * @usedBy `register-tools.ts`
+ */
+export declare function registerPerpTools(server: Server, context: SapMcpContext): void;
+//# sourceMappingURL=perp-analytics-tools.d.ts.map

package/dist/perps/perp-analytics-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perp-analytics-tools.d.ts","sourceRoot":"","sources":["../../src/perps/perp-analytics-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA84BtD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAiB9E"}