@dritan/mcp 0.6.1 → 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 `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") {
@@ -558,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(),
@@ -988,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.",
@@ -1082,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": {
@@ -1092,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": {
@@ -1206,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);
             }
@@ -1433,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.1",
+  "version": "0.7.0",
   "license": "MIT",
   "type": "module",
   "description": "MCP server for Dritan SDK market data and local Solana wallet swap execution",