Lottery MCP Server
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., "@Lottery MCP Server check double ball prize for numbers 3,11,14,19,29,30,15"
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.
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 requestsMCP Tools
Tool | Description |
| Update lottery data to local database |
| Query lottery results by date range |
| Check winning status for given numbers |
| 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 |
| Directory to store 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 Color Ball | 6 red (1-33) + 1 blue (1-16) |
| 大乐透 | 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 toolscheck_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
Scored across 4 tools
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.
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.
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.
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
China-focused validation tools: ID card, bank card, phone, plate, USCC, VIN, lunar calendar & more
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
13 pay-per-use Chinese tools (diagnosis, PLC, copywriting, divination), 0.05 CNY/call via A2M 402.
China holidays and lunar calendar lookup, solar-to-lunar conversion and yearly schedule.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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
- AlicenseBqualityDmaintenanceEnables retrieval of Taiwan lottery data for a specified month, supporting Super Lotto 638, Lotto 649, Daily Cash 539, and Lotto 4D.4MIT
- AlicenseNot gradedqualityDmaintenanceProvides weather queries for major Chinese cities, hot news and news search, and text processing tools using free public APIs.MIT
- AlicenseBqualityCmaintenanceProvides 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.112MIT