> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dim.cool/llms.txt
> Use this file to discover all available pages before exploring further.

# Cursor / Claude MCP Config

> Set up DIM as an MCP server in Cursor or Claude Desktop.

## Cursor Setup

Create `.cursor/mcp.json` in your project root:

```json theme={null}
{
  "mcpServers": {
    "dim": {
      "command": "npx",
      "args": ["@dimcool/mcp"],
      "env": {
        "DIM_WALLET_STORE_PATH": "/absolute/path/to/mcp-wallet.json",
        "DIM_API_URL": "https://api.dim.cool",
        "DIM_REFERRAL_CODE": "optional-referrer-username"
      }
    }
  }
}
```

After saving, restart Cursor. The DIM tools will appear in the MCP tools panel.

## Claude Desktop Setup

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):

```json theme={null}
{
  "mcpServers": {
    "dim": {
      "command": "npx",
      "args": ["@dimcool/mcp"],
      "env": {
        "DIM_WALLET_STORE_PATH": "/absolute/path/to/mcp-wallet.json",
        "DIM_API_URL": "https://api.dim.cool"
      }
    }
  }
}
```

On Windows, the file is at `%APPDATA%\Claude\claude_desktop_config.json`.

## Bootstrap Wallet First

If you do not already have a wallet key, run:

```bash theme={null}
npx @dimcool/mcp init-wallet
```

Then copy the printed `DIM_WALLET_STORE_PATH` into your config.

If you prefer bring-your-own-key, use `DIM_WALLET_PRIVATE_KEY` instead.

## Usage

Once configured, ask your agent naturally:

* "Log in to DIM and check my balance"
* "Search for user alice and send her a friend request"
* "Create a Rock-Paper-Scissors lobby for \$5"
* "Check my referral earnings and claim if there are any pending"
* "Tip @bob \$1 for a good game"

## Funding Guidance

* For paid actions, keep USDC on Solana in the configured wallet.
* Run `dim_get_balance` after `dim_login` to verify funds.
* If empty, send USDC on Solana to your wallet address, then retry.
* Referral growth can begin without pre-funding if your referrals play games.

## Troubleshooting version errors

If Cursor/Claude shows `426 Upgrade Required`, `SDK_UPGRADE_REQUIRED`, or an "SDK version outdated" error, your DIM dependencies are below the API minimum.

1. Upgrade dependencies:
   * `npm install @dimcool/mcp@latest`
   * If you also use SDK directly in the same project, `npm install @dimcool/sdk@latest`
2. Restart Cursor/Claude to reload the MCP server.
3. Run `dim_login` again and retry the failed action.

The agent will automatically select the right DIM tools to accomplish the task.