Skip to main content

🎲 rollhub-dice

PyPI version npm version Python License: MIT MCP Compatible

The AI agent gambling API SDK for Python — provably fair dice & coinflip, crypto betting, and zero-trust verification for autonomous agents.

🎰 Agent Casino — The first provably fair crypto casino built for AI agents

What is this?

rollhub-dice is the core Python SDK for Agent Casino, the first provably fair crypto betting API built specifically for AI agents. Every dice roll is cryptographically verified using SHA3-384 + AES-256-CTR commit-reveal, giving autonomous gambling agents zero-trust guarantees. Supports 70+ cryptocurrency chains for deposits and withdrawals with 99% RTP.

Features

  • Provably fair dice & coinflip gambling for AI agents — every bet auto-verified client-side
  • Zero-trust gambling — SHA3-384 + AES-256-CTR commit-reveal cryptographic proof
  • 70+ cryptocurrency chains for deposits and withdrawals (SOL, ETH, BTC, USDT, USDC...)
  • 99% RTP, 1% house edge, transparent math
  • 30% affiliate earnings on every bet by agents you refer — instant credit
  • AI agent earn money — agents can gamble, verify, and earn affiliate revenue autonomously
  • Typed responses, async-ready, lightweight with zero heavy dependencies

Quick Start

pip install rollhub-dice
from rollhub_dice import DiceAgent

agent = DiceAgent(api_key="your-key")

# Dice bet
result = agent.bet(target=50, direction="over", amount=100)
print(f"Roll: {result.roll}, Won: {result.won}, Verified: {result.proof.verified}")

# Coinflip
flip = agent.coinflip(side="heads", amount=50)
print(f"Result: {flip.side}, Won: {flip.won}")

🤖 Claude Desktop / MCP Integration

Use Agent Casino directly from Claude Desktop with rollhub-dice-mcp:

{
  "mcpServers": {
    "rollhub-dice": {
      "command": "npx",
      "args": ["-y", "rollhub-dice-mcp"],
      "env": {
        "ROLLHUB_API_KEY": "your-api-key"
      }
    }
  }
}

🔗 LangChain Integration

pip install langchain-rollhub
from langchain_rollhub import RollhubDiceTool

tool = RollhubDiceTool(api_key="your-key")
# Use with any LangChain agent

💰 Affiliate Program — Earn Crypto with AI

Earn 30% of house edge on every bet by agents you refer. This is the agent affiliate program — instant credit, no minimums, designed for autonomous agents to earn money by referring other AI agents.

Use rollhub-affiliate-mcp for automated affiliate marketing via MCP.

Full Ecosystem

Package Registry Description
rollhub-dice PyPI Core Python SDK for AI agent gambling API
rollhub-dice npm Core JS/TS SDK for AI agent gambling API
rollhub-dice-mcp npm MCP server casino for Claude Desktop & Cursor
rollhub-affiliate-mcp npm Affiliate marketing MCP server
langchain-rollhub PyPI LangChain gambling tool
crewai-rollhub PyPI CrewAI gambling tool
rollhub-openai-tools npm OpenAI function calling gambling
rollhub-ai-tools npm Vercel AI SDK tools
eliza-rollhub npm ElizaOS plugin
autogpt-rollhub PyPI AutoGPT plugin

Keywords

AI agent gambling API, provably fair dice, crypto betting SDK, Python casino API, zero-trust verification, autonomous agent betting, Solana gambling, coinflip API, LangChain gambling, CrewAI casino, MCP server casino

Metadata

Release files for ai-gambling 0.7.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ai-gambling 0.7.0
File Size Uploaded Provenance Actions
ai_gambling-0.7.0.tar.gz 12.2 kB Without provenance Details for ai_gambling-0.7.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for ai-gambling 0.7.0
File Interpreter ABI Platform Actions
ai_gambling-0.7.0-py3-none-any.whl Python 3 none any Details for ai_gambling-0.7.0-py3-none-any.whl

Total release size: 24.6 kB

Release files / ai_gambling-0.7.0.tar.gz

Download URL ai_gambling-0.7.0.tar.gz
Size 12.2 kB
Tags Source
SHA-256 checksum
How to use checksums
68e3518199f5fa14f7787e1f829ed225d8bf86dfc8f6bd95a6d6a0c500fef97b
BLAKE2b-256 checksum
How to use checksums
c6f7e55d45ca316b2a47b2732c194a9c228f2970f178ca2dc031020aeef22401
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Release files / ai_gambling-0.7.0-py3-none-any.whl

Download URL ai_gambling-0.7.0-py3-none-any.whl
Size 12.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
120dfcc9ab969cebd9e25567b7df73f6d290662782c9a43eadb41010eaf833e4
BLAKE2b-256 checksum
How to use checksums
24b94bf8b9684bf9b456a069f171ad1290d186b4b0190866527c2eea19ddf418
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.9.6

Security for ai-gambling 0.7.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.7.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page