Skip to main content
Glama
Lottery MCP Server

Lottery MCP Server

by stevezhouht

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

Related MCP server: lottery-mcp

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 中国福彩网:

License

MIT License

Disclaimer

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

Available Tools

4 tools
check_prizeA

检查指定号码在日期范围内的中奖情况

Args: lottery_type: 彩票类型,可选 'double_ball'(双色球) 或 'super_lotto'(大乐透) start_date: 开始日期,格式 YYYY-MM-DD end_date: 结束日期,格式 YYYY-MM-DD numbers: 号码列表 - 双色球: 7个数字,前6个为红球(1-33),最后1个为蓝球(1-16) - 大乐透: 7个数字,前5个为前区(1-35),后2个为后区(1-12)

Returns: 中奖结果,包含每期的匹配情况和中奖等级

Inputs: lottery_type (required), start_date (required), end_date (required), numbers (required).

get_latest_resultsB

获取最近几期的开奖结果

Args: lottery_type: 彩票类型,可选 'double_ball'(双色球) 或 'super_lotto'(大乐透) count: 获取的期数,默认5期

Returns: 最近几期的开奖结果

Inputs: lottery_type (required), count.

query_lotteryA

查询指定日期范围内的开奖结果

Args: lottery_type: 彩票类型,可选 'double_ball'(双色球) 或 'super_lotto'(大乐透) start_date: 开始日期,格式 YYYY-MM-DD end_date: 结束日期,格式 YYYY-MM-DD

Returns: 开奖结果列表

Inputs: lottery_type (required), start_date (required), end_date (required).

update_lotteryB

更新彩票开奖数据到本地数据库

Args: lottery_type: 彩票类型,可选 'double_ball'(双色球) 或 'super_lotto'(大乐透) start_date: 开始日期,格式 YYYY-MM-DD end_date: 结束日期,格式 YYYY-MM-DD

Returns: 更新结果,包含新增记录数和总记录数

Inputs: lottery_type (required), start_date (required), end_date (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: checking prizes for a number, getting recent results, querying historical results by date range, and updating the local database. No overlap.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (check_prize, get_latest_results, query_lottery, update_lottery), making them predictable and easy to understand.

    Tool Count5/5

    With 4 tools, the server is well-scoped for its purpose: prize checking, result retrieval (recent and historical), and data maintenance. This is a reasonable number for a focused lottery MCP server.

    Completeness4/5

    The tool set covers core operations: checking prizes, fetching latest results, querying historical results, and updating data. Minor gaps like a tool to retrieve a specific draw by issue number or list supported types are not critical.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables interaction with VibeDoge lottery system through comprehensive tools for user profile management, lottery participation, result checking, and activity statistics. Supports secure authentication and real-time lottery operations through natural language.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Enables retrieval of Taiwan lottery data for a specified month, supporting Super Lotto 638, Lotto 649, Daily Cash 539, and Lotto 4D.
      4
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Provides A-share (Chinese stock market) quantitative analysis through tools for stock screening, northbound capital flow tracking, dragon-tiger list analysis, margin trading, sector analysis, technical indicators, IPO info, and limit-up/down statistics using akshare data.
      11
      2
      MIT