@dimcool/mcp 0.1.11 → 0.1.13

package/dist/index.js

@@ -25233,6 +25233,11 @@ function registerAuthTools(server2, client) {
               "No referrer yet \u2014 call dim_apply_referral_code for 10% fee discount"
             );
           }
+          if (result.username) {
+            nextSteps.push(
+              `Share your referral code "${result.username}" with other users/agents \u2014 you earn 30% of their game fees (https://dim.cool/?ref=${result.username})`
+            );
+          }
         } catch {
         }
         const response = {
@@ -25787,7 +25792,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 {
@@ -25833,18 +25838,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: [
             {
@@ -25881,7 +25887,7 @@ function registerGamesTools(server2, client) {
   );
   server2.tool(
     "dim_join_queue",
-    "Join the matchmaking queue for a lobby. If the lobby is full, the game starts immediately. Otherwise, waits for an opponent. Returns the lobby (and gameId if matched).",
+    'Join the matchmaking queue for a lobby. If matched immediately, returns gameId \u2014 start playing. If not matched, you MUST poll dim_get_lobby every 2-3 seconds until status becomes "active" and gameId appears.',
     {
       lobbyId: z5.string().describe("The lobby ID to join the queue for")
     },
@@ -25973,24 +25979,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: [
             {
@@ -26869,11 +26874,11 @@ var DIM_INSTRUCTIONS = [
   },
   {
     name: "dim_create_lobby",
-    description: "Create a game lobby; bet in USDC minor units."
+    description: "Create a game lobby; bet in USDC dollars."
   },
   {
     name: "dim_join_queue",
-    description: "Join matchmaking queue for a game type."
+    description: "Join matchmaking queue. If not matched immediately, poll dim_get_lobby until gameId appears."
   },
   { name: "dim_get_lobby", description: "Get lobby details by ID." },
   {
@@ -26937,11 +26942,19 @@ function registerInstructionsTool(server2) {
           type: "text",
           text: JSON.stringify(
             {
+              hint: "Game flow: dim_create_lobby \u2192 dim_join_queue \u2192 poll dim_get_lobby until gameId appears \u2192 dim_get_game_state \u2192 dim_submit_action \u2192 repeat until dim_get_game shows 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
-              })),
-              hint: "Call dim_login first if you have not authenticated. Then use any tool above by name."
+              }))
             },
             null,
             2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimcool/mcp",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "MCP server for DIM — lets AI agents play games, chat, send USDC, and earn referral income on the DIM platform",
   "type": "module",
   "bin": {