
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
- Sugar SDK documentation
- Sugar MCP documentation
- Suifrens documentation
- Sui TypeScript SDK 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/sdkinpackages/sdk: ESM-only TypeScript SDK for transactions involving Sugar's provably fair casino games on Sui, SweetHouse, NFTs and referrals.@sugarcasino/mcpinpackages/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-systeminpackages/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
@sugarcasino/mcpnpm install @sugarcasino/mcp