@dimcool/mcp 0.1.10 → 0.1.12

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 {
@@ -25774,7 +25787,7 @@ import { z as z5 } from "zod";
 function registerGamesTools(server2, client) {
   server2.tool(
     "dim_list_games",
-    "List all available game types on DIM with player counts and descriptions. Games include: Rock-Paper-Scissors, Chess, Tic-Tac-Toe, Connect Four, Nim, Dots and Boxes.",
+    "List all available game types on DIM with player counts and descriptions. Games include: Rock-Paper-Scissors, Chess, Tic-Tac-Toe, Connect Four.",
     {},
     async () => {
       try {
@@ -25820,18 +25833,19 @@ function registerGamesTools(server2, client) {
   );
   server2.tool(
     "dim_create_lobby",
-    "Create a new game lobby. The agent becomes the lobby creator. Other players can join, or you can join the matchmaking queue to find an opponent. Bet amount is in USDC minor units (1 USDC = 1,000,000). A 1% fee (min 1 cent) is charged per player.",
+    "Create a new game lobby. The agent becomes the lobby creator. Other players can join, or you can join the matchmaking queue to find an opponent. Bet amount is in USDC dollars (e.g., 1.00 for $1.00). A 1% fee (min 1 cent) is charged per player.",
     {
       gameType: z5.string().describe(
-        'Game type ID (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four", "nim", "dots-and-boxes")'
+        'Game type ID (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four")'
       ),
       betAmount: z5.number().optional().describe(
-        "Bet amount in USDC minor units (e.g., 1000000 = $1.00). Common amounts: 1000000 ($1), 5000000 ($5), 10000000 ($10)"
+        "Bet amount in USDC dollars (e.g., 1.00 for $1.00, 5.00 for $5.00, 10.00 for $10.00)"
       )
     },
     async ({ gameType, betAmount }) => {
       try {
-        const lobby = await client.sdk.lobbies.createLobby(gameType, betAmount);
+        const betMinor = betAmount != null ? Math.round(betAmount * 1e6) : void 0;
+        const lobby = await client.sdk.lobbies.createLobby(gameType, betMinor);
         return {
           content: [
             {
@@ -25960,24 +25974,23 @@ function registerGamesTools(server2, client) {
   );
   server2.tool(
     "dim_submit_action",
-    'Submit a game action. The action format depends on the game type.\n\nRock-Paper-Scissors: gameType="rock-paper-scissors", action="play", payload={ action: "rock"|"paper"|"scissors" }\nChess: gameType="chess", action="move", payload={ from: "e2", to: "e4" }\nTic-Tac-Toe: gameType="tic-tac-toe", action="place", payload={ position: 0-8 }\nConnect Four: gameType="connect-four", action="drop", payload={ column: 0-6 }\nNim: gameType="nim", action="take", payload={ heap: 0-2, count: 1-N }\nDots and Boxes: gameType="dots-and-boxes", action="draw", payload={ row, col, direction: "h"|"v" }',
+    'Submit a game action. The action format depends on the game type.\n\nRock-Paper-Scissors: gameType="rock-paper-scissors", action="play", payload={ action: "rock"|"paper"|"scissors" }\nChess: gameType="chess", action="move", payload={ from: "e2", to: "e4" }\nTic-Tac-Toe: gameType="tic-tac-toe", action="place_mark", payload={ row: 0-2, col: 0-2 }\nConnect Four: gameType="connect-four", action="drop_disc", payload={ column: 0-6 }',
     {
       gameId: z5.string().describe("The game ID to submit an action for"),
       gameType: z5.string().describe(
-        'Game type (e.g., "rock-paper-scissors", "chess", "tic-tac-toe")'
+        'Game type (e.g., "rock-paper-scissors", "chess", "tic-tac-toe", "connect-four")'
+      ),
+      action: z5.string().describe(
+        'Action type (e.g., "play", "move", "place_mark", "drop_disc")'
       ),
-      action: z5.string().describe('Action type (e.g., "play", "move", "place", "drop")'),
       payload: z5.record(z5.unknown()).describe(
         "Action payload (game-specific, see tool description for format)"
       )
     },
     async ({ gameId, gameType, action, payload }) => {
       try {
-        await client.sdk.games.submitAction(gameId, {
-          gameType,
-          action,
-          payload
-        });
+        const gameAction = { gameType, action, payload };
+        await client.sdk.games.submitAction(gameId, gameAction);
         return {
           content: [
             {
@@ -26779,6 +26792,182 @@ 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 dollars."
+  },
+  {
+    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(
+            {
+              quickstart: "Call dim_login first, then dim_get_balance. All monetary amounts are in USDC dollars (e.g., 1.00 = $1).",
+              game_flow: [
+                "1. dim_create_lobby (gameType, betAmount in dollars) \u2192 lobbyId",
+                "2. dim_join_queue (lobbyId) \u2192 enters matchmaking",
+                '3. Poll dim_get_lobby every 2-3s until status="active" and gameId appears',
+                "4. dim_get_game_state (gameId) \u2192 board state, check currentPlayerId",
+                "5. dim_submit_action (gameId, gameType, action, payload) \u2192 your move",
+                '6. Repeat 4-5 until status="completed"'
+              ],
+              move_formats: {
+                "rock-paper-scissors": 'action: "play", payload: { action: "rock"|"paper"|"scissors" }',
+                chess: 'action: "move", payload: { from: "e2", to: "e4" }',
+                "tic-tac-toe": 'action: "place_mark", payload: { row: 0-2, col: 0-2 }',
+                "connect-four": 'action: "drop_disc", payload: { column: 0-6 }'
+              },
+              market_flow: "dim_get_market \u2192 dim_buy_shares (dollars) \u2192 dim_get_positions \u2192 dim_sell_shares or dim_redeem_shares after resolution",
+              fees: "1% game fee (min 1\xA2), 1\xA2 transfer fee, 3% market payout fee",
+              instructions: DIM_INSTRUCTIONS.map(({ name, description }) => ({
+                name,
+                description
+              }))
+            },
+            null,
+            2
+          )
+        }
+      ]
+    })
+  );
+}
+
 // src/resources.ts
 function registerResources(server2, client) {
   server2.resource(
@@ -26964,10 +27153,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.10",
+  "version": "0.1.12",
   "description": "MCP server for DIM — lets AI agents play games, chat, send USDC, and earn referral income on the DIM platform",
   "type": "module",
   "bin": {