com.blocklottos/blocklottos
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@com.blocklottos/blocklottos What's the current jackpot on Base?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.mdStart 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.mdStart 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-mcpOr launch the standard-input/output MCP without a permanent installation:
uvx blocklottos-mcpThe public Block Lottos Git mirror remains available as a source fallback:
uvx --from git+https://blocklottos.com/git/blocklottos-agent-tools.git blocklottos-mcpHermes 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: falseHermes exposes the tools with names such as mcp_block_lottos_get_jackpot.
Generic MCP clients
Configure a standard-input/output server with:
Command:
uvxArguments:
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_capabilitiesget_jackpotfor Base or Polygonget_statsget_draw_historyget_draw_proofget_wallet_ticketscheck_wallet_prizesget_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_purchaseconfirm_ticket_purchase
Development
python3.12 -m venv .venv
.venv/bin/python -m pip install -e '.[test]'
.venv/bin/pytest -qSafety 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
Distribution page: https://blocklottos.com/agent-tools/
Website: https://blocklottos.com
Agent guide: https://blocklottos.com/agents.txt
LLM context: https://blocklottos.com/llms.txt
OpenAPI: https://blocklottos.com/openapi.json
License
MIT. See LICENSE.
Available Tools
10 toolscheck_wallet_prizesCRead-onlyIdempotent
Check whether a Base wallet has an outstanding failed automatic prize payout.
Inputs: wallet_address (required). Returns: object
confirm_ticket_purchaseBIdempotent
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_capabilitiesARead-onlyIdempotent
Read the authoritative Base game, 1-USDC price, gas, workflow, payout, and safety details.
Inputs: no named parameters. Returns: object
get_draw_historyARead-onlyIdempotent
Read one to ten completed Base draws, or begin at a specified public draw ID.
Inputs: limit, draw_id. Returns: object
get_draw_proofARead-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_jackpotARead-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_referralAIdempotent
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_statsARead-onlyIdempotent
Read the current Base draw number, jackpot, next draw time, and contract metadata.
Inputs: no named parameters. Returns: object
get_wallet_ticketsBRead-onlyIdempotent
Read a Base wallet's tickets for the active draw. This does not move funds.
Inputs: wallet_address (required). Returns: object
prepare_ticket_purchaseADestructive
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
Scored across 10 tools
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.
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.
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.
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
Agents-only token launchpad on Base: quotes, tokens and unsigned launch/buy/sell/claim/vote txs.
Base on-chain data for agents: balances, prices, transfers, Basenames, contracts. x402 pay-per-call.
Pay-per-call agent tools via x402 (USDC on Base): chat, prices, funding, RNG. No account or keys.
Agent-to-agent escrow on Base. Post quests with ETH/USDC bounties and settle on-chain.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables 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.1Creative Commons Zero v1.0 Universal
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseAqualityCmaintenanceEnables 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.17MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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.1MIT