Yes, Lotero Core is free to use.

How do I install Lotero Core?

Lotero Core is a local plugin. Install it using npm package: lotero-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Lotero Core safe to use?

Yes. Lotero Core passed MCP Marketplace's automated security scan with a score of 9.7/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Lotero Core need?

Lotero Core requires the following credentials or environment variables: LOTERO_WALLET_PRIVATE_KEY, LOTERO_PLAYER_ADDRESS, LOTERO_MAX_SPINS_PER_SESSION. You can find setup instructions on the server detail page.

What AI apps work with Lotero Core?

Lotero Core uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Lotero Core MCP Server

by Csacanam

Developer ToolsLow Risk9.7MCP RegistryLocal

Free

Server data from the Official MCP Registry

Provably fair on-chain slot machine for AI agents: x402 spins on Base, Chainlink VRF results.

About

Provably fair on-chain slot machine for AI agents: x402 spins on Base, Chainlink VRF results.

Security Report

9.7

Low Risk9.7Low Risk

Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. ⚠️ Package registry links to a different repository than scanned source. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

10 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

Dedicated wallet with USDC on Base — pays spins/claims via x402. Required only for spin/claim.Required

Environment variable: LOTERO_WALLET_PRIVATE_KEY

Default player — the human's wallet, where winnings accrue and get claimed.Optional

Environment variable: LOTERO_PLAYER_ADDRESS

Enforced responsible-gambling spin limit per session (default 10).Optional

Environment variable: LOTERO_MAX_SPINS_PER_SESSION

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-csacanam-lotero": {
      "env": {
        "LOTERO_PLAYER_ADDRESS": "your-lotero-player-address-here",
        "LOTERO_WALLET_PRIVATE_KEY": "your-lotero-wallet-private-key-here",
        "LOTERO_MAX_SPINS_PER_SESSION": "your-lotero-max-spins-per-session-here"
      },
      "args": [
        "-y",
        "lotero-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

🎰 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/frontend is incomplete. The contracts and agent are production-ready.

Smart Contract

SlotMachineV2 (Base mainnet)

Item	Value
Address	`0xC4b88e90a73fA9ec588E504255A43d4Ccb82edE9`
Token	USDC. Bet 1 USDC, win up to 30 USDC.
VRF	Chainlink VRF 2.5
Events	`SpinRequested`, `SpinResolved`

Core functions

playFor(player, referringUserAddress, amountToPlay) — Pay on behalf of another address; the player receives 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 for player.
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 watch

Documentation: DOCS/AGENT_FLOWS.md | DOCS/AGENT_API.md

For AI agents:

MCP server (lotero-mcp on npm, listed on the official Model Context Protocol registry as io.github.csacanam/lotero): exposes 5 MCP tools over stdio — spin (paid via x402), get_round, get_balances, claim and get_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-mcp
```
See mcp/README.md for 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
DOCS/AGENT_FLOWS.md	Flow diagrams (cron health, spin, claim)
DOCS/AGENT_API.md	API reference, endpoints, env, constants
DOCS/DEPLOY_BASE.md	Deploy contracts to Base
DOCS/RTP_MODEL.md	RTP math and reel layout

Requirements

Quick Start

1. Install dependencies

git clone https://github.com/csacanam/lotero-core.git
cd lotero-core
yarn install

2. Run local chain

yarn chain

3. Deploy contracts (new terminal)

yarn deploy

4. Run tests

yarn contracts:test

5. Start the frontend (optional, in development)

yarn start

App 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

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Lotero Core MCP Server

About

Security Report

Findings (1)

Permissions Required

What You'll Need

How to Install

Documentation

🎰 Lotero

Overview

Smart Contract

SlotMachineV2 (Base mainnet)

Agents

Lotero Agent

Project Structure

Documentation

Requirements

Quick Start

Production

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MCP Marketplace

MarkItDown