Lottery MCP Server

A Model Context Protocol (MCP) server for Chinese lottery data query and prize checking. Supports 双色球 (Double Color Ball) and 大乐透 (Super Lotto).

Features

• 🔄 Update lottery data - Fetch latest lottery results from official sources
• 🔍 Query results - Search lottery results by date range
• 🎯 Check prizes - Check if your numbers won any prizes
• 📊 Get latest results - Quick access to recent lottery draws

Installation

pip install mcp requests

MCP Tools

Tool	Description
update_lottery	Update lottery data to local database
query_lottery	Query lottery results by date range
check_prize	Check winning status for given numbers
get_latest_results	Get recent lottery results

Configuration

Add to your MCP config (e.g., .kiro/settings/mcp.json):

{
  "mcpServers": {
    "lottery": {
      "command": "python",
      "args": ["/path/to/lottery_mcp_server.py"],
      "env": {
        "LOTTERY_DATA_DIR": "/path/to/data"
      },
      "disabled": false,
      "autoApprove": ["update_lottery", "query_lottery", "check_prize", "get_latest_results"]
    }
  }
}

Environment Variables

Variable	Description	Default
LOTTERY_DATA_DIR	Directory to store lottery data	~/lottery_data

Usage Examples

Update lottery data

update_lottery("double_ball", "2025-12-01", "2026-01-18")
update_lottery("super_lotto", "2025-12-01", "2026-01-18")

Query results

query_lottery("double_ball", "2025-12-01", "2026-01-18")

Check prize (Double Color Ball: 6 red + 1 blue)

check_prize("double_ball", "2025-12-01", "2026-01-18", [3, 11, 14, 19, 29, 30, 15])

Check prize (Super Lotto: 5 front + 2 back)

check_prize("super_lotto", "2025-12-01", "2026-01-18", [8, 13, 27, 30, 32, 2, 3])

Get latest results

get_latest_results("double_ball", 5)
get_latest_results("super_lotto", 10)

Lottery Types

Type	ID	Description	Numbers
double_ball	双色球	Double Color Ball	6 red (1-33) + 1 blue (1-16)
super_lotto	大乐透	Super Lotto	5 front (1-35) + 2 back (1-12)

Prize Levels

Double Color Ball (双色球)

Level	Red Match	Blue Match
一等奖	6	✓
二等奖	6	✗
三等奖	5	✓
四等奖	5 or 4+blue	-
五等奖	4 or 3+blue	-
六等奖	0-2	✓

Super Lotto (大乐透)

Level	Front Match	Back Match
一等奖	5	2
二等奖	5	1
三等奖	5	0
四等奖	4	2
五等奖	4	1
六等奖	3	2
七等奖	4+0 or 3+1	-
八等奖	Various combinations	-

Data Source

Data is fetched from 中国福彩网:

• 双色球: https://www.zhcw.com/kjxx/ssq/
• 大乐透: https://www.zhcw.com/kjxx/dlt/

License

MIT License

Disclaimer

This tool is for educational and entertainment purposes only. Please gamble responsibly.