Repository avatar
AI Tools
v0.0.1-beta.0
active

mcp

io.github.SugarCasino/mcp

AI agent MCP server for Sugar casino game, SweetHouse, NFT, and referral transactions.

Documentation

Sugar TypeScript SDKs

Build Sugar transactions on Sui with the TypeScript SDK or MCP server, and render Suifrens with the React display library.

Documentation

Install the MCP server

Install Sugar MCP for all detected coding agents with add-mcp:

npx add-mcp @sugarcasino/mcp@latest --name sugar

Add -y to skip the installer prompts. Restart or reload your MCP client after installation.

To configure an MCP client manually, use:

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

Agent skills

Each public npm package includes an entry under skills/: sugar-sdk, sugar-mcp, or suifrens-display-system. Compatible agents discover these entries and fetch the full instructions and references they need from main in the skills repository. Agent skills are not versioned with the packages. Packing the entries needs no install hook or network access.

Sugar agent skills live in SugarCasino/agent-skills. The MCP skill explains how to install and configure @sugarcasino/mcp, read Sugar config, game metadata, NFTs and claimable referral amounts, and build and simulate unsigned transactions, including SweetHouse transactions.

Install all Sugar skills with:

npx skills add SugarCasino/agent-skills --global --yes

Install only the MCP skill with:

npx skills add SugarCasino/agent-skills --skill sugar-mcp --global --yes

Packages

The npm scope is @sugarcasino. Use it for package installation and all public imports, including subpaths. The client extension remains sugar() and client.sugar.

  • @sugarcasino/sdk in packages/sdk: ESM-only TypeScript SDK for transactions involving Sugar's provably fair casino games on Sui, SweetHouse, NFTs and referrals.
  • @sugarcasino/mcp in packages/mcp: MCP stdio server and MCP App for reading Sugar config, game metadata, NFTs, and referral claim amounts, plus building unsigned Sugar and SweetHouse transactions through the SDK.
  • @sugarcasino/suifrens-display-system in packages/suifrens-display-system: React components for rendering Suifrens.

Development

Run these commands from the repository root.

Use turbo when a task needs generated files or build output. It runs the prerequisite tasks first.

Setup

Use the Node.js version specified in .node-version. GitHub Actions reads the same file through the shared pnpm setup action.

pnpm install
pnpm run build

Dependency install scripts are disabled by default in pnpm-workspace.yaml. Review any new dependency's install or build script before approving it with pnpm approve-builds. Transitive dependencies cannot resolve untrusted git or tarball URLs.

Building

pnpm run build
# or
pnpm turbo run build

Unit tests

pnpm run test
# or
pnpm turbo run test

Type checking

Workspace packages inherit the strict checks in tsconfig.shared.json. It disables isolatedDeclarations because generated SDK bindings lack the required annotations and MCP relies on Zod to infer schema and handler types. SDK and MCP keep the other shared strict checks.

pnpm run typecheck
# or
pnpm turbo run typecheck

Linting

This repo uses Oxlint and Oxfmt for linting and formatting.

pnpm run lint

Apply automatic fixes with:

pnpm run lint:fix

To run Oxlint and Oxfmt individually, use:

pnpm run oxlint
pnpm run oxfmt
pnpm run oxlint:fix
pnpm run oxfmt:fix
NPM
@sugarcasino/mcp
Install Command
npm install @sugarcasino/mcp
Runtime: npx