# MCP

> MCP is an open-source MCP server for crypto and web3. MCP server letting AI agents read and build transactions for Sugar casino games on Sui. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/sugarcasino/ts-sdks/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.SugarCasino/mcp
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3), [gaming information](https://ai-powered.com/categories/gaming-information)
- **Listing updated:** 2026-11-19

## About

The README describes this as an MCP server that gives agents access to Sugar's provably fair casino games on the Sui blockchain, along with SweetHouse pools, NFT minting and referral claims. Its tools read game configuration and live game metadata, check referral claimable amounts, and construct unsigned transactions for standard games, PvP Coinflip and SweetHouse actions.

Transactions are unsigned by default and can be dry-run for simulation. For signing, the server supports either a paired Sugar browser wallet, where the user approves each transaction, or a local session wallet whose key is kept in the operating-system keychain. The README advises using a dedicated wallet with a small balance.

The package targets developers and power users who want an AI client to inspect or prepare Sugar game and wallet actions. It requires Node.js 24 or 26 and is installed through npm or plugin manifests for Codex, Claude Code and Cursor.

## Features

- **Unsigned transaction builders:** Builds unsigned transaction bytes for standard Sugar games, PvP Coinflip and SweetHouse actions.
- **Dry-run simulation:** Simulates transactions and returns a summary with balance changes, gas and decoded events.
- **Paired wallet approval:** Sends execute-mode transactions to a paired Sugar browser wallet for the user to approve.
- **Local session wallet:** Signs game transactions with a keychain-stored session key for immediate submission.
- **Referral and NFT reads:** Reads referral claimable amounts, NFT catalog entries and wallet balances.
- **Read-only inspection mode:** Shows the Move target, inputs and requirements of a tool without building a transaction.

## Good for

- Prototyping a Sugar casino game bet through an AI agent before signing
- Checking referral rewards and claimable amounts for a Sui address
- Simulating a SweetHouse deposit or redeem request before submitting it
- Reviewing wallet balances and owned NFTs in an MCP-capable host
- Building unsigned PvP Coinflip create or join transactions for review

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @sugarcasino/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sugarcasino/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sugarcasino/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sugarcasino/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sugarcasino/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@sugarcasino/mcp"
      ]
    }
  }
}
```

## Tools

- `read_config`: Reads Sugar SDK configuration for the selected network.
- `read_game_metadata`: Reads live parameters for a specified Sugar game.
- `list_nfts`: Lists the NFT catalog and an owner's NFTs.
- `get_wallet_balances`: Reads aggregate wallet balances for an address.
- `list_wallet_coins`: Lists paginated coin objects for an address.
- `get_execution_status`: Checks the browser approval result of an execute-mode transaction.
- `get_referral_commission`: Reads referral commission claimable amounts.
- `get_referral_level_up_usd_rewards`: Reads referral level-up USD rewards claimable amounts.
- `build_coinflip_transaction`: Builds an unsigned Coinflip bet transaction.
- `build_keno_transaction`: Builds an unsigned Keno bet transaction.
- `build_sweethouse_deposit_transaction`: Builds an unsigned SweetHouse deposit transaction.
- `build_pvp_coinflip_create_transaction`: Builds an unsigned PvP Coinflip create transaction.

## FAQ

### Are transactions signed automatically?

No. Transactions are unsigned by default. Execute mode either asks a paired Sugar browser wallet for approval or, with the session wallet option, signs with the local session key.

### Which networks are supported?

The README says the server supports mainnet and testnet, with testnet as the default.

### How is the session wallet key stored?

The README says the signing key is stored in the operating-system keychain without a separate application passphrase, and advises using a dedicated wallet with a small balance.

### How do I install it?

The README gives an npx add-mcp command and a manual MCP client configuration that runs npx -y @sugarcasino/mcp@latest over stdio.

### Is MCP free?

Yes. MCP is open source, so you can use and self-host it for free.

### How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @sugarcasino/mcp

### What are the best alternatives to MCP?

The closest alternatives to MCP are MCP Agentic Wallet — open-source session management for x402, Oagent Units, Solana Rent & Rug Shield MCP Gateway, Mandate and NullClear Arbiter.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP Agentic Wallet — open-source session management for x402](https://ai-powered.com/mcp/mcp-agentic-wallet-open-source-session-management-for-x402): MCP Agentic Wallet — open-source session management for x402 is an open-source MCP server for finance and payments.
- [Oagent Units](https://ai-powered.com/mcp/oagent-units): Oagent Units is an open-source MCP server for crypto and web3.
- [Solana Rent & Rug Shield MCP Gateway](https://ai-powered.com/mcp/solana-rent-and-rug-shield-mcp-gateway-2): Solana Rent & Rug Shield MCP Gateway is a freemium MCP server for security.
- [Mandate](https://ai-powered.com/mcp/mandate): Mandate is an open-source MCP server for crypto and web3.
- [NullClear Arbiter](https://ai-powered.com/mcp/nullclear-arbiter-2): NullClear Arbiter is a freemium MCP server for crypto and web3.
- [Chain](https://ai-powered.com/mcp/chain): Chain is an open-source MCP server for crypto and web3.
- [Prove It Onchain](https://ai-powered.com/mcp/prove-it-onchain): Prove It Onchain is a freemium MCP server for agent identity.

---
Source: https://ai-powered.com/mcp/mcp-mwmse76g
