@dritan/mcp 0.6.0 → 0.7.0

package/README.md

@@ -72,6 +72,7 @@ npm run build && npm start
 - `ths_get_score`
 - `ths_get_score_tokens_get`
 - `ths_get_score_tokens_post`
+- `ths_get_top_wallets`
 - `swap_build`
 - `swap_sign_and_broadcast`
 - `swap_build_sign_and_broadcast`
@@ -82,12 +83,14 @@ npm run build && npm start
 - Private keys never leave local files; only public address/signature are returned.
 - `swap_sign_and_broadcast` signs locally, then broadcasts via Dritan.
 - `auth_set_api_key` activates a key for the running MCP process without restart.
+- `auth_set_api_key` and successful `x402_create_api_key` responses include a capability summary so agents can immediately guide users to next actions.
 - Agent onboarding without `DRITAN_API_KEY` should present two options:
   - Option 1: paid x402 flow (`x402_get_pricing` -> `x402_create_api_key_quote` -> user funds agent wallet -> `wallet_transfer_sol` -> `x402_create_api_key`).
   - Option 2: user gets a free key at `https://dritan.dev`.
 - `x402_create_api_key` auto-activates returned keys for the current MCP session.
 - `token_get_ohlcv_chart` returns a shareable chart URL plus a ready-to-send markdown image snippet.
-- `token_get_ohlcv_chart` supports `chartType: "line-volume" | "candlestick"` (default is `line-volume`).
+- `token_get_ohlcv_chart` supports `chartType: "line-volume" | "candlestick"` (default is `candlestick`).
+- `ths_get_top_wallets` returns a paginated leaderboard of THS-ranked wallets (`page`, `limit`) for smart-wallet discovery workflows.
 - Ticker workflow for chart requests: `token_search` -> extract mint -> `token_get_ohlcv` or `token_get_ohlcv_chart`.
 - If users ask for `$WIF` style symbols, always resolve mint with `token_search` first.
 - If Solana CLI is missing, run `system_check_prereqs` and follow returned install steps.

package/dist/index.js

@@ -86,6 +86,19 @@ function missingApiKeyError() {
         "You can activate a key immediately with auth_set_api_key without restarting MCP.",
     ].join(" "));
 }
+const postAuthCapabilities = [
+    "Token intelligence: token search, price, metadata, risk, first buyers, deployer stats.",
+    "Charts: OHLCV data and shareable line-volume/candlestick chart URLs.",
+    "Wallet analytics: summary, holdings, trade history, performance, and portfolio charts.",
+    "Trader discovery: Meteora THS wallet score lookups plus top-wallet leaderboard.",
+    "Execution: build/sign/broadcast swaps and monitor wallet/DEX streams.",
+];
+function buildPostAuthGuidance() {
+    return {
+        capabilities: postAuthCapabilities,
+        suggestedNextPrompt: "Tell me your goal and I can proceed: token research, smart-wallet discovery, chart generation, or swap execution.",
+    };
+}
 function getDritanClient() {
     const apiKey = getActiveApiKey();
     if (!apiKey) {
@@ -112,6 +125,24 @@ function getThsClient() {
         baseUrl: process.env.METEORA_THS_BASE_URL,
     });
 }
+async function getThsTopWallets(ths, options = {}) {
+    const sdkMethod = ths.getTopWalletsByScore;
+    if (typeof sdkMethod === "function") {
+        return await sdkMethod.call(ths, options);
+    }
+    const baseUrl = ths.baseUrl ?? "https://ths.dritan.dev";
+    const url = new URL("/ths/top-wallets", baseUrl);
+    if (options.page !== undefined)
+        url.searchParams.set("page", String(options.page));
+    if (options.limit !== undefined)
+        url.searchParams.set("limit", String(options.limit));
+    const res = await fetch(url.toString(), { method: "GET" });
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new Error(`Meteora THS request failed (${res.status}): ${text || res.statusText}`);
+    }
+    return (await res.json());
+}
 async function searchTokens(client, query, options) {
     const sdkSearch = client.searchTokens;
     if (typeof sdkSearch === "function") {
@@ -296,27 +327,35 @@ function buildCandlestickOhlcvChartUrl(mint, timeframe, bars, width, height) {
     const volumeSeries = bars.map((bar) => Number(bar.volume.toFixed(12)));
     const volumeColors = bars.map((bar) => bar.close >= bar.open ? "rgba(16,185,129,0.25)" : "rgba(239,68,68,0.25)");
     const config = {
-        type: "candlestick",
+        type: "bar",
         data: {
             labels,
             datasets: [
                 {
+                    type: "bar",
+                    label: "Volume",
+                    data: volumeSeries,
+                    backgroundColor: volumeColors,
+                    borderWidth: 0,
+                    yAxisID: "volume",
+                    barPercentage: 0.9,
+                    categoryPercentage: 1,
+                    maxBarThickness: 14,
+                    order: 1,
+                },
+                {
+                    type: "candlestick",
                     label: "OHLC",
                     data: candles,
+                    yAxisID: "price",
+                    parsing: false,
+                    order: 2,
                     color: {
                         up: "#10b981",
                         down: "#ef4444",
                         unchanged: "#94a3b8",
                     },
                 },
-                {
-                    type: "bar",
-                    label: "Volume",
-                    data: volumeSeries,
-                    backgroundColor: volumeColors,
-                    borderWidth: 0,
-                    yAxisID: "volume",
-                },
             ],
         },
         options: {
@@ -329,8 +368,13 @@ function buildCandlestickOhlcvChartUrl(mint, timeframe, bars, width, height) {
             },
             scales: {
                 x: { type: "category" },
-                y: { type: "linear", position: "left" },
-                volume: { type: "linear", position: "right", grid: { drawOnChartArea: false } },
+                price: { type: "linear", position: "left" },
+                volume: {
+                    type: "linear",
+                    position: "right",
+                    beginAtZero: true,
+                    grid: { drawOnChartArea: false },
+                },
             },
         },
     };
@@ -506,7 +550,7 @@ const tokenOhlcvSchema = z.object({
     timeTo: z.number().int().positive().optional(),
 });
 const tokenOhlcvChartSchema = tokenOhlcvSchema.extend({
-    chartType: z.enum(["line-volume", "candlestick"]).default("line-volume"),
+    chartType: z.enum(["line-volume", "candlestick"]).default("candlestick"),
     includeActive: z.boolean().default(true),
     maxPoints: z.number().int().min(10).max(500).default(120),
     width: z.number().int().min(300).max(2000).default(1200),
@@ -545,6 +589,10 @@ const thsScoreSchema = z.object({
 const thsScoreTokensSchema = thsScoreSchema.extend({
     tokenMints: z.array(z.string().min(1)).min(1).max(200),
 });
+const thsTopWalletsSchema = z.object({
+    page: z.number().int().min(1).optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+});
 const swapBuildSchema = z.object({
     walletPath: z.string().min(1).optional(),
     userPublicKey: z.string().min(1).optional(),
@@ -804,7 +852,7 @@ const tools = [
                 chartType: {
                     type: "string",
                     enum: ["line-volume", "candlestick"],
-                    description: "Chart style. Default line-volume.",
+                    description: "Chart style. Default candlestick.",
                 },
                 includeActive: { type: "boolean" },
                 maxPoints: { type: "number" },
@@ -975,6 +1023,17 @@ const tools = [
             },
         },
     },
+    {
+        name: "ths_get_top_wallets",
+        description: "Fetch paginated top wallets ranked by THS score.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                page: { type: "number" },
+                limit: { type: "number" },
+            },
+        },
+    },
     {
         name: "swap_build",
         description: "Build an unsigned swap transaction with Dritan.",
@@ -1069,6 +1128,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         "Option 1 (paid x402): create wallet -> receive user SOL -> x402 quote -> transfer -> claim key.",
                         "Option 2 (free): create key at https://dritan.dev and set it with auth_set_api_key.",
                     ],
+                    ...(activeApiKey ? buildPostAuthGuidance() : {}),
                 });
             }
             case "auth_set_api_key": {
@@ -1079,6 +1139,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     message: "API key activated for this MCP session without restart.",
                     source: runtimeApiKeySource,
                     preview: apiKeyPreview(activated),
+                    ...buildPostAuthGuidance(),
                 });
             }
             case "dritan_health": {
@@ -1193,6 +1254,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                         preview: apiKeyPreview(activated),
                         message: "x402-created API key is active for this MCP session (no restart needed).",
                     };
+                    Object.assign(payload, buildPostAuthGuidance());
                 }
                 return ok(payload);
             }
@@ -1420,6 +1482,11 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     breakdown: input.breakdown,
                 }));
             }
+            case "ths_get_top_wallets": {
+                const input = thsTopWalletsSchema.parse(args);
+                const ths = getThsClient();
+                return ok(await getThsTopWallets(ths, input));
+            }
             case "swap_build": {
                 const input = swapBuildSchema.parse(args);
                 const client = getDritanClient();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dritan/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "type": "module",
   "description": "MCP server for Dritan SDK market data and local Solana wallet swap execution",