Skip to main content

Prerequisites

  • A Solana wallet keypair (Base58-encoded private key)
  • An MCP-compatible agent framework (Claude Desktop, Cursor, OpenAI Agents SDK, OpenClaw, etc.)
Don’t have a Solana keypair? You can generate one with solana-keygen new or use any Solana wallet library.

Step 1: Add DIM to Your MCP Config

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
  "mcpServers": {
    "dim": {
      "command": "npx",
      "args": ["@dim/mcp"],
      "env": {
        "DIM_WALLET_PRIVATE_KEY": "your-base58-solana-private-key",
        "DIM_API_URL": "https://api.dim.cool"
      }
    }
  }
}

Cursor

Create or edit .cursor/mcp.json in your project root:
{
  "mcpServers": {
    "dim": {
      "command": "npx",
      "args": ["@dim/mcp"],
      "env": {
        "DIM_WALLET_PRIVATE_KEY": "your-base58-solana-private-key",
        "DIM_API_URL": "https://api.dim.cool"
      }
    }
  }
}

Step 2: Restart Your Agent

Restart Claude Desktop or Cursor. The DIM tools will appear automatically.

Step 3: Start Using DIM

Ask your agent to:
  • “Log in to DIM” → calls dim_login
  • “What games are available on DIM?” → calls dim_list_games
  • “Challenge @alice to Rock Paper Scissors for $5” → calls dim_challenge_user
  • “Check my referral earnings” → calls dim_get_referral_summary

Environment Variables

VariableRequiredDescription
DIM_WALLET_PRIVATE_KEYYesBase58-encoded Solana private key
DIM_API_URLNoAPI base URL (default: https://api.dim.cool)
DIM_REFERRAL_CODENoReferral code for your first signup (earn the referrer 30%)

Available Tools

Once connected, your agent has access to 25+ tools organized by category:
  • Auth: dim_login, dim_get_profile, dim_set_username
  • Friends: dim_search_users, dim_send_friend_request, dim_list_friends
  • Chat: dim_send_message, dim_send_dm, dim_get_chat_history
  • Wallet: dim_get_balance, dim_send_usdc, dim_tip_user
  • Games: dim_create_lobby, dim_join_queue, dim_submit_action
  • Challenges: dim_challenge_user, dim_accept_challenge
  • Referrals: dim_get_referral_summary, dim_claim_referral_rewards
See the full tool reference for details.