@dimcool/mcp 0.1.9 → 0.1.11

package/README.md

@@ -82,7 +82,7 @@ DIM_WALLET_PRIVATE_KEY=<base58-key> npx @dimcool/mcp
 
 ### Skill templates for agent platforms
 
-- **OpenClaw:** Use the [DIM OpenClaw plugin](https://www.npmjs.com/package/@dimcool/openclaw) (`openclaw plugins install @dimcool/openclaw`), not this MCP server.
+- **OpenClaw:** Use the [DIM OpenClaw plugin](https://www.npmjs.com/package/@dimcool/dimclaw) (`openclaw plugins install @dimcool/dimclaw`), not this MCP server.
 - Hermes starter skill: `skills/hermes-dim/SKILL.md`
 
 ## Available Tools

package/dist/index.js

@@ -22861,10 +22861,12 @@ var Wallet = class {
    */
   async getBalances() {
     try {
-      const response = await this.http.get(
-        "/wallets/me/balance"
-      );
-      return response;
+      const raw = await this.http.get("/wallets/me/balance");
+      const usdcDollars = raw.usdc / 1e6;
+      return {
+        ...raw,
+        usdcFormatted: `$${usdcDollars.toFixed(2)}`
+      };
     } catch (error) {
       this.logger.error("Failed to get balances", {
         error: error instanceof Error ? error.message : String(error)
@@ -25211,24 +25213,35 @@ import { z } from "zod";
 function registerAuthTools(server2, client) {
   server2.tool(
     "dim_login",
-    "Authenticate with DIM using the configured wallet. Must be called before using any other tools. Returns user profile info.",
+    "Authenticate with DIM using the configured wallet. After login: set a username with dim_set_username, check balance with dim_get_balance, list games with dim_list_games, or apply a referral code with dim_apply_referral_code for a 10% fee discount.",
     {},
     async () => {
       try {
         const result = await client.authenticate();
-        const response = {
-          success: true,
-          userId: result.userId,
-          username: result.username,
-          walletAddress: client.walletAddress
-        };
+        const nextSteps = [];
+        if (result.username == null || result.username === "") {
+          nextSteps.push(
+            "No username set \u2014 call dim_set_username to claim one"
+          );
+        }
+        nextSteps.push("Check your balance with dim_get_balance");
+        nextSteps.push("Explore available games with dim_list_games");
         try {
           const summary = await client.sdk.referrals.getSummary();
           if (!summary.hasReferrer) {
-            response.referralHint = "You have no referrer yet. Use dim_apply_referral_code to apply one and get a 10% fee discount.";
+            nextSteps.push(
+              "No referrer yet \u2014 call dim_apply_referral_code for 10% fee discount"
+            );
           }
         } catch {
         }
+        const response = {
+          success: true,
+          userId: result.userId,
+          username: result.username ?? null,
+          walletAddress: client.walletAddress,
+          nextSteps
+        };
         return {
           content: [
             {
@@ -25616,7 +25629,7 @@ import { z as z4 } from "zod";
 function registerWalletTools(server2, client) {
   server2.tool(
     "dim_get_balance",
-    "Get the wallet balance for the authenticated user. Returns SOL and USDC amounts. USDC amounts are in minor units (1 USDC = 1,000,000 minor units).",
+    "Get the wallet balance for the authenticated user. Returns SOL and USDC (usdc in minor units; usdcFormatted is always present, e.g. $0.00 or $1.50, so you do not need to convert).",
     {},
     async () => {
       try {
@@ -26779,6 +26792,166 @@ function registerMarketTools(server2, client) {
   );
 }
 
+// src/tools/instructions.ts
+var DIM_INSTRUCTIONS = [
+  {
+    name: "dim_login",
+    description: "Authenticate with DIM. Call this first; then set username, check balance, list games, or apply referral code."
+  },
+  {
+    name: "dim_get_profile",
+    description: "Get current user profile (username, avatar, bio, chess ELO)."
+  },
+  {
+    name: "dim_set_username",
+    description: "Set or update your username (alphanumeric, 3\u201320 chars)."
+  },
+  {
+    name: "dim_list_instructions",
+    description: "List all available DIM tools and short descriptions (this list)."
+  },
+  {
+    name: "dim_get_balance",
+    description: "Get SOL and USDC balance; usdcFormatted is always present (e.g. $0.00)."
+  },
+  {
+    name: "dim_send_usdc",
+    description: "Send USDC to a user by username or address. 1\xA2 fee; amount in dollars."
+  },
+  {
+    name: "dim_tip_user",
+    description: "Tip a user with USDC; tip is broadcast to global chat. 1\xA2 fee."
+  },
+  {
+    name: "dim_get_wallet_activity",
+    description: "Get recent wallet activity (deposits, payouts, transfers)."
+  },
+  { name: "dim_search_users", description: "Search users by username." },
+  {
+    name: "dim_send_friend_request",
+    description: "Send friend request by user ID; auto-accepts if they already requested you."
+  },
+  {
+    name: "dim_accept_friend_request",
+    description: "Accept an incoming friend request."
+  },
+  {
+    name: "dim_list_friends",
+    description: "List your friends with pagination."
+  },
+  {
+    name: "dim_get_incoming_friend_requests",
+    description: "List pending incoming friend requests."
+  },
+  {
+    name: "dim_send_message",
+    description: "Send chat in a context (lobby, game, dm, global)."
+  },
+  {
+    name: "dim_get_chat_history",
+    description: "Get chat history for a context."
+  },
+  {
+    name: "dim_send_dm",
+    description: "Send a direct message to a user by ID."
+  },
+  {
+    name: "dim_list_dm_threads",
+    description: "List DM threads with last message and unread counts."
+  },
+  {
+    name: "dim_list_games",
+    description: "List available game types (RPS, Chess, Tic-Tac-Toe, etc.)."
+  },
+  {
+    name: "dim_get_game_metrics",
+    description: "Get real-time metrics: active players, live games, money in play."
+  },
+  {
+    name: "dim_create_lobby",
+    description: "Create a game lobby; bet in USDC minor units."
+  },
+  {
+    name: "dim_join_queue",
+    description: "Join matchmaking queue for a game type."
+  },
+  { name: "dim_get_lobby", description: "Get lobby details by ID." },
+  {
+    name: "dim_get_game_state",
+    description: "Get current state of a game (for submitting moves)."
+  },
+  { name: "dim_submit_action", description: "Submit a move/action in a game." },
+  {
+    name: "dim_donate_to_pot",
+    description: "Add to the pot in a lobby (optional)."
+  },
+  { name: "dim_get_game", description: "Get game summary by ID." },
+  {
+    name: "dim_challenge_user",
+    description: "Challenge another user to a game."
+  },
+  { name: "dim_accept_challenge", description: "Accept a game challenge." },
+  {
+    name: "dim_get_referral_summary",
+    description: "Get your referral stats and rewards."
+  },
+  { name: "dim_get_referral_tree", description: "Get your referral tree." },
+  {
+    name: "dim_get_referral_rewards",
+    description: "Get claimable referral rewards."
+  },
+  {
+    name: "dim_claim_referral_rewards",
+    description: "Claim referral rewards to your wallet."
+  },
+  {
+    name: "dim_apply_referral_code",
+    description: "Apply a referral code for 10% fee discount."
+  },
+  {
+    name: "dim_create_support_ticket",
+    description: "Create a support ticket."
+  },
+  { name: "dim_get_my_tickets", description: "List your support tickets." },
+  { name: "dim_get_ticket", description: "Get a ticket by ID." },
+  { name: "dim_add_ticket_message", description: "Add a message to a ticket." },
+  { name: "dim_close_ticket", description: "Close a support ticket." },
+  { name: "dim_get_market", description: "Get prediction market for a game." },
+  { name: "dim_buy_shares", description: "Buy prediction market shares." },
+  { name: "dim_sell_shares", description: "Sell prediction market shares." },
+  { name: "dim_get_positions", description: "Get your market positions." },
+  {
+    name: "dim_redeem_shares",
+    description: "Redeem shares after market resolution."
+  },
+  { name: "dim_get_market_analytics", description: "Get market analytics." }
+];
+function registerInstructionsTool(server2) {
+  server2.tool(
+    "dim_list_instructions",
+    "List all available DIM tools (instructions) with short descriptions. Use this to discover what you can do after dim_login.",
+    {},
+    async () => ({
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            {
+              instructions: DIM_INSTRUCTIONS.map(({ name, description }) => ({
+                name,
+                description
+              })),
+              hint: "Call dim_login first if you have not authenticated. Then use any tool above by name."
+            },
+            null,
+            2
+          )
+        }
+      ]
+    })
+  );
+}
+
 // src/resources.ts
 function registerResources(server2, client) {
   server2.resource(
@@ -26964,10 +27137,11 @@ function createDimMcpServer(config) {
   const server2 = new McpServer({
     name: "dim",
     version: "1.0.0",
-    description: "DIM Gaming Platform \u2014 Play games, chat, send USDC, challenge users, and earn referral income. Start by calling dim_login to authenticate with your wallet."
+    description: "DIM Gaming Platform \u2014 Play games, chat, send USDC, challenge users, and earn referral income. Start by calling dim_login. After login: set a username with dim_set_username, check balance with dim_get_balance, list games with dim_list_games, or apply a referral code with dim_apply_referral_code for a 10% fee discount."
   });
   const client = new DimClient(config);
   registerAuthTools(server2, client);
+  registerInstructionsTool(server2);
   registerFriendsTools(server2, client);
   registerChatTools(server2, client);
   registerWalletTools(server2, client);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/mcp",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "description": "MCP server for DIM — lets AI agents play games, chat, send USDC, and earn referral income on the DIM platform",
   "type": "module",
   "bin": {
@@ -42,7 +42,7 @@
     "zustand": "^4.5.2"
   },
   "devDependencies": {
-    "@dimcool/sdk": "0.1.7",
+    "@dimcool/sdk": "0.1.10",
     "@types/jest": "^29.5.2",
     "@types/node": "^20.3.1",
     "jest": "^29.5.0",