Skip to main content
Glama
com.blocklottos/blocklottos

com.blocklottos/blocklottos

by scosemicolon

Block Lottos Agent Tools

A public, open-source MCP server and cross-agent skill for safely reading Block Lottos data and preparing one bounded Base Future Ledger ticket.

mcp-name: com.blocklottos/blocklottos

Truthful positioning

Block Lottos can be presented as a weekly probability challenge, but not as a solvable equation. Six winning numbers will be drawn, yet a random future draw has no known equation that agents can solve to reveal those numbers in advance. Agents may analyze history, simulate, select numbers, submit an eligible lottery entry, and verify the result, but must never claim certainty or conceal the lottery and ticket cost.

Related MCP server: Base Pulse

Canonical economics

  • One Base ticket costs exactly 1 USDC.

  • Official Base USDC is the payment token.

  • Base ETH is required only for gas.

  • Effective minimum winner payout: 100 USDC on Base.

  • Effective minimum winner payout: 100 POL on Polygon.

  • A higher live on-chain jackpot applies.

  • Lottery outcomes are uncertain and no ticket is guaranteed to win.

Included

  • MCP server with ten tools and two resources.

  • Cross-agent skill: skills/block-lottos-probability-challenge/SKILL.md.

  • Safety validation for chain, token, contract, price, calldata, approval, wallet, receipt, and payout policy.

  • Tests for MCP protocol discovery, hostile responses, payout floors, and skill truthfulness.

Install the skill

Canonical skill URL:

https://blocklottos.com/skills/block-lottos-probability-challenge/SKILL.md

Hermes

mkdir -p ~/.hermes/skills/block-lottos-probability-challenge
curl -fsSL https://blocklottos.com/skills/block-lottos-probability-challenge/SKILL.md \
  -o ~/.hermes/skills/block-lottos-probability-challenge/SKILL.md

Start a new Hermes session so the skill loader discovers it.

OpenClaw

Run from the OpenClaw workspace:

mkdir -p skills/block-lottos-probability-challenge
curl -fsSL https://blocklottos.com/skills/block-lottos-probability-challenge/SKILL.md \
  -o skills/block-lottos-probability-challenge/SKILL.md

Start a new OpenClaw session so it loads the workspace skill.

Claude Code, Codex, Cursor, and other Agent Skills-compatible runtimes

Download the canonical SKILL.md into that runtime's supported skill directory. The file follows the open Agent Skills SKILL.md format and contains no credentials or executable installer.

A versioned source archive is also available at:

https://blocklottos.com/downloads/blocklottos-agent-tools-v1.0.0.zip

Run the MCP

Install from the Python Package Index:

python -m pip install blocklottos-mcp

Or launch the standard-input/output MCP without a permanent installation:

uvx blocklottos-mcp

The public Block Lottos Git mirror remains available as a source fallback:

uvx --from git+https://blocklottos.com/git/blocklottos-agent-tools.git blocklottos-mcp

Hermes configuration

Add this to ~/.hermes/config.yaml, then restart Hermes:

mcp_servers:
  block_lottos:
    command: uvx
    args:
      - blocklottos-mcp
    timeout: 30
    connect_timeout: 60
    sampling:
      enabled: false

Hermes exposes the tools with names such as mcp_block_lottos_get_jackpot.

Generic MCP clients

Configure a standard-input/output server with:

  • Command: uvx

  • Arguments: blocklottos-mcp

No API key is required. Financial transactions remain unsigned and require the wallet owner's approval or an explicit, bounded, revocable spending policy.

MCP tools

  • get_capabilities

  • get_jackpot for Base or Polygon

  • get_stats

  • get_draw_history

  • get_draw_proof

  • get_wallet_tickets

  • check_wallet_prizes

  • get_or_create_referral — registers or securely manages the one shared human/agent affiliate profile. First request a challenge, sign it with the EVM identity wallet, and resubmit the signature. Cardano is supported as a payout wallet. Store the one-time management token securely; it is required for payout-wallet changes and private pending/paid balance monitoring.

  • prepare_ticket_purchase

  • confirm_ticket_purchase

Development

python3.12 -m venv .venv
.venv/bin/python -m pip install -e '.[test]'
.venv/bin/pytest -q

Safety and eligibility

Only participate when the wallet owner meets the legal age requirement and lottery participation is permitted in their jurisdiction. Never chase losses, silently increase limits, use unlimited approvals, imply guaranteed winnings, or represent a random draw as a solved mathematical equation.

Official information

License

MIT. See LICENSE.

Available Tools

10 tools
check_wallet_prizesC
Read-onlyIdempotent

Check whether a Base wallet has an outstanding failed automatic prize payout.

Inputs: wallet_address (required). Returns: object

confirm_ticket_purchaseB
Idempotent

Verify the Base receipt, sender, contract, method, and TicketPurchased event. This is the only completion check.

Inputs: tx_hash (required), wallet_address (required), agent_id, execution_id. Returns: object

get_capabilitiesA
Read-onlyIdempotent

Read the authoritative Base game, 1-USDC price, gas, workflow, payout, and safety details.

Inputs: no named parameters. Returns: object

get_draw_historyA
Read-onlyIdempotent

Read one to ten completed Base draws, or begin at a specified public draw ID.

Inputs: limit, draw_id. Returns: object

get_draw_proofA
Read-onlyIdempotent

Read the public proof for a Base draw. Omit draw_id for the current public proof when available.

Inputs: draw_id. Returns: object

get_jackpotA
Read-onlyIdempotent

Read the effective jackpot. Minimum: 100 USDC on Base or 100 POL on Polygon; higher live jackpot applies.

Inputs: chain. Returns: object

get_or_create_referralA
Idempotent

Begin or finish secure shared affiliate enrollment. First call returns a message the EVM identity wallet must sign; resubmit its challenge_id and signature. The returned one-time management token protects EVM, Solana, and Cardano payout wallets and private balances. No funds move.

Inputs: agent_id, signature, evm_wallet, challenge_id, +6 more. Returns: object

get_statsA
Read-onlyIdempotent

Read the current Base draw number, jackpot, next draw time, and contract metadata.

Inputs: no named parameters. Returns: object

get_wallet_ticketsB
Read-onlyIdempotent

Read a Base wallet's tickets for the active draw. This does not move funds.

Inputs: wallet_address (required). Returns: object

prepare_ticket_purchaseA
Destructive

Prepare exactly one unsigned 1-USDC Base ticket purchase. It never signs or broadcasts. Obtain owner approval or apply a narrow owner policy before submitting returned wallet transactions.

Inputs: numbers (required), wallet_address (required), idempotency_key (required), agent_id, +3 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have clearly distinct actions and resources, especially the prepare/confirm purchase pair and the draw history/proof tools. The main overlap is between get_stats and get_jackpot, since get_stats also returns the current jackpot, and get_capabilities adds broader game metadata that could be confused with general stats reads.

    Naming Consistency5/5

    All tool names use snake_case and follow a predictable action_object pattern, such as get_draw_history, prepare_ticket_purchase, and confirm_ticket_purchase. The few compound names like get_or_create_referral remain readable and consistent with the overall convention.

    Tool Count5/5

    Ten tools is well scoped for a lottery ticket purchasing and wallet-checking server. The set separates discovery, read-only queries, referral setup, purchase preparation, and purchase confirmation without excessive tool proliferation.

    Completeness3/5

    Core flows are covered: reading game state, checking tickets and prizes, referral enrollment, and preparing/confirming a ticket purchase. However, there is a notable gap around prize resolution: check_wallet_prizes can detect an outstanding failed automatic payout, but no tool appears to retry, claim, or otherwise resolve that payout.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables an autonomous agent wallet on Base to make payments, approve tokens, swap on Uniswap V3, Aerodrome, 0x and CoW Protocol, lend/borrow via Aave V3 and Morpho Blue, trade perps on Hyperliquid, and enforce risk policies via blacklists, caps, simulation, and audit logs.
      1
      Creative Commons Zero v1.0 Universal
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to run honeypot and owner-power safety checks on Base tokens and to read wallet ETH and USDC balances, with every answer sourced from real chain data and paid per call in USDC via x402.
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to read prediction markets on Base and prepare unsigned transactions for taking positions, claiming payouts, finalizing markets, and launching new markets, while signing and sending stay with the agent's own wallet.
      17
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to place and verify provably fair dice bets, manage shared bankroll vault liquidity positions, inspect incentives and positions, and read or send verified chat messages over HTTP or Stdio, including website-independent on-chain memo workflows.
      1
      MIT