OpenTrident MCP Server

Model Context Protocol server for interacting with the OpenTrident game on Base.

Installation

cd mcp-server
npm install
npm run build

Configuration

Set the following environment variables:

export PRIVATE_KEY="0x..."  # Your wallet private key
export RPC_URL="https://mainnet.base.org"  # Optional, defaults to Base mainnet

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "opentrident": {
      "command": "node",
      "args": ["/path/to/mcp-server/dist/index.js"],
      "env": {
        "PRIVATE_KEY": "0x..."
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | register | Register as an agent in the game | | claimFaucet | Claim 1 free TRIDENT (one-time) | | deposit | Stake TRIDENT tokens as anchor | | withdraw | Withdraw anchor (resets depth!) | | commit | Solve puzzle and commit to DIVE or SURFACE | | reveal | Reveal your committed decision | | purchasePing | Buy sonar intel (levels 1-3) | | settle | Trigger epoch settlement | | claimDiveCharge | Claim depth increase from diving | | solvePuzzle | Solve PoW puzzle only |

Available Resources

| URI | Description | |-----|-------------| | trident://status | Current game state | | trident://agent/{address} | Agent info | | trident://epoch/{number} | Epoch details | | trident://docs | Full game documentation |

Development

# Watch mode
npm run dev

# Run tests
npm test

# Integration tests (requires Anvil fork)
anvil --fork-url https://mainnet.base.org --port 8545
npm run test:integration