English Français العربية

io.github.Suigar-Gaming/mcp

Official registry Games, sports and entertainment

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @suigar/mcp
Claude Code 
claude mcp add io-github-suigar-gaming-mcp -e 'SUIGAR_MCP_BRIDGE_WEB_URL=<SUIGAR_MCP_BRIDGE_WEB_URL>' -e 'SUIGAR_MCP_BRIDGE_TIMEOUT_MS=<SUIGAR_MCP_BRIDGE_TIMEOUT_MS>' -e 'SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES=<SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES>' -e 'SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS=<SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS>' -- npx -y @suigar/mcp@1.0.0-beta.31
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-suigar-gaming-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@suigar/mcp@1.0.0-beta.31"
            ],
            "env": {
                "SUIGAR_MCP_BRIDGE_WEB_URL": "<SUIGAR_MCP_BRIDGE_WEB_URL>",
                "SUIGAR_MCP_BRIDGE_TIMEOUT_MS": "<SUIGAR_MCP_BRIDGE_TIMEOUT_MS>",
                "SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES": "<SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES>",
                "SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS": "<SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS>"
            }
        }
    }
}

Environment variables

  • SUIGAR_MCP_BRIDGE_WEB_URL Custom Suigar MCP browser app origin for wallet pairing and approval pages.
  • SUIGAR_MCP_BRIDGE_TIMEOUT_MS Milliseconds before local browser login, logout, and approval bridges expire.
  • SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES Maximum JSON callback body size in bytes for local browser bridges.
  • SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS Milliseconds before local session-wallet setup pages expire.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Suigar TypeScript SDKs
  2. Documentation
  3. Install the MCP server
  4. Agent Skills
  5. Packages
  6. Development

Suigar TypeScript SDKs

A collection of TypeScript SDKs and MCP tooling for interacting with the Suigar contracts.

Documentation

For SDK documentation, visit suigar.com/docs/sdk.

For MCP documentation, visit suigar.com/docs/mcp.

See also the local SDK and MCP guides.

For Sui TypeScript SDK documentation, visit sdk.mystenlabs.com.

Install the MCP server

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

npx add-mcp @suigar/mcp@latest --name suigar

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

To configure an MCP client manually, use:

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

Agent Skills

Suigar agent skills live in the separate Suigar-Gaming/agent-skills repository. The MCP-focused skill teaches agents how to install, configure, and operate @suigar/mcp for Suigar config reads, game metadata, NFT lookups, referral claim reads, SweetHouse transaction builders, unsigned transaction builders, and dry-runs.

Install all Suigar skills with:

npx skills add Suigar-Gaming/agent-skills --global --yes

Install only the MCP skill with:

npx skills add Suigar-Gaming/agent-skills --skill suigar-mcp --global --yes

Packages

  • @suigar/sdk in packages/sdk: ESM-only TypeScript SDK for Suigar provably fair on-chain Sui casino game, SweetHouse, NFT, and referral transactions.
  • @suigar/mcp in packages/mcp: MCP stdio server and MCP App for reading Suigar config, game metadata, NFTs, and referral claim amounts, plus building unsigned Suigar and SweetHouse transactions through the SDK.

Public packages are published to both npm and JSR.

Development

Any of the following commands can be run at the root of the project.

When running a task that depends on generated or built artifacts, use turbo to ensure task dependencies are run first.

Setup
pnpm install
pnpm run build

Dependency install scripts are disabled by default in pnpm-workspace.yaml. If a new dependency needs an install or build script, explicitly review it before approving it with pnpm approve-builds. Transitive dependencies are also blocked from resolving untrusted git or tarball URLs.

Building
pnpm run build
# or
pnpm turbo run build
Unit Tests

For unit tests:

pnpm run test
# or
pnpm turbo run test
Type Checking
pnpm run typecheck
# or
pnpm turbo run typecheck
Linting

This repo uses Oxlint and Oxfmt for linting and formatting.

pnpm run lint

You can automatically fix many lint issues by running:

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

Frequently asked questions

What is io.github.Suigar-Gaming/mcp?

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

How do I install io.github.Suigar-Gaming/mcp?

It runs on your machine. In Claude Code: claude mcp add io-github-suigar-gaming-mcp -e 'SUIGAR_MCP_BRIDGE_WEB_URL=<SUIGAR_MCP_BRIDGE_WEB_URL>' -e 'SUIGAR_MCP_BRIDGE_TIMEOUT_MS=<SUIGAR_MCP_BRIDGE_TIMEOUT_MS>' -e 'SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES=<SUIGAR_MCP_BRIDGE_MAX_BODY_BYTES>' -e 'SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS=<SUIGAR_MCP_SESSION_SETUP_TIMEOUT_MS>' -- npx -y @suigar/mcp@1.0.0-beta.31. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Suigar-Gaming/mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Suigar-Gaming/mcp open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.Suigar-Gaming/mcp?

It is published by Suigar-Gaming. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.