lotero-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
π° Lotero
A Provably Fair Casino for AI Agents
A provably fair, on-chain slot machine with Chainlink VRF 2.5. Designed for autonomous agents: clients pay in USDC via x402, execution is gasless.
Overview
Lotero lets users (or AI agents) bet USDC and win prizes when three matching symbols appear on the reels. The game uses Chainlink VRF 2.5 for provably fair randomness.
RTP ~93% β DOCS/RTP_MODEL.md
Max win: 30Γ β Bet 1 USDC, win up to 30 USDC (three BTC)
Symbols β DOGE 5Γ, BNB 14Γ, ETH 20Γ, BTC 30Γ
Referral β 1% commission on referred players' bets
Dev fee β 5% of each bet to the team
β οΈ Frontend in development β The web app in
packages/frontendis incomplete. The contracts and agent are production-ready.
Related MCP server: hyperd-mcp
Smart Contract
SlotMachineV2 (Base mainnet)
Item | Value |
Address |
|
Token | USDC. Bet 1 USDC, win up to 30 USDC. |
VRF | Chainlink VRF 2.5 |
Events |
|
Core functions
playFor(player, referringUserAddress, amountToPlay)β Pay on behalf of another address; theplayerreceives the round, wins, and stats.claimPlayerEarnings(userAddress)β Claim winnings and referral earnings.isResolved(requestId)β Check if a round has been resolved.
Agents
Lotero Agent
Stateless HTTP API that sells spins and claims as a service. Clients pay via x402 (1.1 USDC spin, 0.1 USDC claim); the agent relays playFor and claimPlayerEarnings onchain. Two-agent system: Lotero Agent (Express API) + Ops Agent (external cron calling GET /cron/health). See packages/agent/README.md.
POST /spinWith1USDCβ Paid (x402). Execute spin forplayer.POST /claimβ Paid (x402). Claim player earnings (gasless).GET /round?requestId=...,GET /player/:address/balances,GET /contract/healthβ Read-only.GET /cron/healthβ Ops Agent: system status, may execute transfers and Telegram alerts.
yarn agent # Start agent
yarn agent:dev # Dev with watchDocumentation: DOCS/AGENT_FLOWS.md | DOCS/AGENT_API.md
For AI agents:
MCP server (
lotero-mcpon npm, listed on the official Model Context Protocol registry asio.github.csacanam/lotero): exposes 5 MCP tools over stdio βspin(paid via x402),get_round,get_balances,claimandget_contract_healthβ built with the official MCP TypeScript SDK (@modelcontextprotocol/sdk), with an enforced session spin limit as a responsible-gambling guardrail. Install:claude mcp add lotero -- npx -y lotero-mcpSee
mcp/README.mdfor configuration and tool reference.Agent skill:
npx skills add csacanam/lotero-core(or read it at lotero.xyz/skill.md) β wallet setup, x402 spin/poll/claim flow, payouts, budget guardrails.LLM index: lotero.xyz/llms.txt.
Project Structure
packages/
βββ agent/ # Lotero Agent β x402 + onchain relay
βββ contracts/ # Smart contracts, tests, deploy scripts
β βββ contracts/ SlotMachine.sol, SlotMachineV2.sol
β βββ deploy/
β βββ test/
βββ frontend/ # Web app (in development)Documentation
Doc | Description |
Flow diagrams (cron health, spin, claim) | |
API reference, endpoints, env, constants | |
Deploy contracts to Base | |
RTP math and reel layout |
Requirements
Quick Start
1. Install dependencies
git clone https://github.com/csacanam/lotero-core.git
cd lotero-core
yarn install2. Run local chain
yarn chain3. Deploy contracts (new terminal)
yarn deploy4. Run tests
yarn contracts:test5. Start the frontend (optional, in development)
yarn startApp runs at http://localhost:3000.
Production
For Base mainnet: see DOCS/DEPLOY_BASE.md. Contract address above. Fund the VRF subscription with LINK.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
Related MCP Connectors
x402 gateway: AI agents pay USDC on Base to flip coins (Chainlink VRF, streaks win pots).
Pay-per-call onchain reads (Base, Ethereum, Gnosis), token verdicts and LLM chat over x402 USDC
Pay-per-call onchain reads (Base, Ethereum, Gnosis), token verdicts and LLM chat over x402 USDC
USDC/x402 agent marketplace. Verified Base mainnet pilot, testnet and public enrollment.
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceTrust infrastructure for AI agents on Base. DEX Spread Oracle (live Uniswap V3 prices), on-chain escrow, insurance pool, and collective knowledge base. 7 smart contracts. Pay-per-query via x402 micropayments in USDC.6-

hyperd-mcpofficial
AlicenseAqualityDmaintenancePre-trade DeFi intelligence for AI agents. 20 paid x402 endpoints, USDC on Base.2369 npm1MIT- FlicenseNot gradedqualityDmaintenancePay-per-use AI security and research tools for autonomous agents on Base, enabling honeypot detection, risk assessment, wallet analysis, and yield optimization via the x402 protocol.1-
- AlicenseNot gradedqualityBmaintenancex402 utilities for AI agents on Base: USDC payment verification, wallet risk scores and signed receipts. $0.01 USDC per call via x402.MIT