Lets AI assistants look up South African lottery results, check winning numbers, view number statistics, and access horse racing data.
Also known as Stef1986/resultsza-sdk, mcp, resultsza-mcp
- Stars
- 1
- Tools
- 10
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Nov 12, 2026
- License
- MIT
What is ResultsZA MCP?
ResultsZA lets AI assistants look up South African lottery results, check winning numbers, view number statistics, and access horse racing data. It exposes 10 tools, such as check_balance, get_lottery_results, check_lottery_numbers.
Summary generated from the project's README
About ResultsZA MCP server
Accessing South African lottery results and horse racing data from within your AI assistant is what ResultsZA enables. Developers using Claude Desktop, Cursor, or VS Code can integrate this server to query specific game outcomes, check winning numbers, and analyze number statistics. It provides a bridge between your local development environment and the ResultsZA API, requiring a valid API key and Node.js 20 or newer to function.
The server includes specialized tools like get_lottery_results for various international and local games, check_lottery_numbers for verifying up to 10 lines, and bulk_check_lottery_numbers for larger sets. For racing enthusiasts, it offers tools to retrieve race meetings, race cards with dividends, and full runner tables. All operations are read-only and consume calls based on your specific ResultsZA plan. You can also use generate_lottery_numbers or lucky_numbers_from_text to create new entries based on random data or specific phrases.
What you can do with it
- 1Verify lottery ticket winsCheck if a specific set of numbers won a recent South African draw.
- 2Analyze number frequencyIdentify hot and cold numbers or common pairs for specific lottery games.
- 3Review horse racing schedulesFind out which race meetings occurred at a specific venue during a certain week.
- 4Retrieve detailed race resultsGet the full runner table and dividends for a specific horse race.
Written from the project's README. Every use case is checked against a quote from it.
How to install ResultsZA MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ResultsZA MCP in Claude Code
$ claude mcp add --env 'RESULTSZA_API_KEY=<YOUR_RESULTSZA_API_KEY>' mcp -- npx -y resultsza-mcpInstall ResultsZA MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"resultsza-mcp"
],
"env": {
"RESULTSZA_API_KEY": "<YOUR_RESULTSZA_API_KEY>"
}
}
}
}Install ResultsZA MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"resultsza-mcp"
],
"env": {
"RESULTSZA_API_KEY": "<YOUR_RESULTSZA_API_KEY>"
}
}
}
}Install ResultsZA MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","resultsza-mcp"],"env":{"RESULTSZA_API_KEY":"<YOUR_RESULTSZA_API_KEY>"}}'Install ResultsZA MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"resultsza-mcp"
],
"env": {
"RESULTSZA_API_KEY": "<YOUR_RESULTSZA_API_KEY>"
}
}
}
}Install ResultsZA MCP in Codex
$ codex mcp add mcp --env 'RESULTSZA_API_KEY=<YOUR_RESULTSZA_API_KEY>' -- npx -y resultsza-mcpInstall ResultsZA MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "resultsza-mcp"] [mcp_servers.mcp.env] RESULTSZA_API_KEY = "<YOUR_RESULTSZA_API_KEY>"
Install ResultsZA MCP in Gemini CLI
$ gemini mcp add -s user -e 'RESULTSZA_API_KEY=<YOUR_RESULTSZA_API_KEY>' mcp npx -- -y resultsza-mcpInstall ResultsZA MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"resultsza-mcp"
],
"env": {
"RESULTSZA_API_KEY": "<YOUR_RESULTSZA_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for resultsza-mcp 0.1.1 in an isolated container with no network and no keys. It answered and listed 10 tools.
ResultsZA MCP tools 10
Read from the server with tools/listcheck_balanceRead-onlyShow the user's ResultsZA plan, calls used this month and calls left, and the subscription end date. Free: does not use any API calls.
get_lottery_resultsRead-onlyOfficial draw results for one game: South African National Lottery games (with prize divisions, winners and jackpot), UK 49's, EuroMillions, Irish Lotto, US Powerball, Mega Millions, Kenya, Nigeria, Ghana and Gosloto. Omit date for the latest draw. Gosloto and Kenya with a date return every draw that day. Uses 1 API call from your ResultsZA plan.
check_lottery_numbersRead-onlyCheck up to 10 lines of numbers against one South African National Lottery draw. Returns matches and the prize division per line for that draw. Uses 1 API call per request (up to 10 lines).
bulk_check_lottery_numbersRead-onlyCheck up to 500 lines against one South African National Lottery draw. Returns matches and the prize division per line for that draw. Uses 1 API call PER LINE (up to 500). Only use this when the user explicitly has more than 10 lines; otherwise use check_lottery_numbers, which costs 1 call for up to 10 lines.
get_horse_racing_meetingsRead-onlySouth African horse racing meetings (date, venue, number of races) in a date range of at most 7 days. Defaults to the last 7 days. Use it to find the venue name for the other racing tools. Uses 1 API call from your ResultsZA plan.
get_horse_racing_cardRead-onlyAll races at one South African meeting with the top three finishers and tote dividends. Uses 1 API call from your ResultsZA plan.
get_horse_raceRead-onlyThe full runner table for one race at a South African meeting. Uses 1 API call from your ResultsZA plan.
generate_lottery_numbersRead-onlyRandom lines for a game using its correct number ranges. Uses 1 API call from your ResultsZA plan (regardless of the number of lines). Unknown games are rejected without using a call.
lucky_numbers_from_textRead-onlyPersonalised numbers for a game derived from a name, date or phrase (the same text always gives the same numbers). For fun only. Uses 1 API call from your ResultsZA plan.
get_number_statisticsRead-onlyHistorical number statistics for a game: hot and cold numbers, how often each number was drawn, or the most common pairs. Products include the South African games, "UK49s" (all four draws combined), "EuroMillions", "US Powerball", "Kenya Lotto" and "Gosloto 6/45". Unknown products are rejected without using a call. Uses 1 API call from your ResultsZA plan.
Configuration
RESULTSZA_API_KEYRequiredSecretYour ResultsZA API key (create an account at https://resultsza.co.za/signup)
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubResultsZA MCP server
The official ResultsZA MCP server. It lets AI assistants such as Claude Desktop, Cursor and VS Code look up South African lottery results, check numbers, read number statistics and get South African horse racing results, using your own ResultsZA API key.
Ask your assistant things like:
- "What were last night's Powerball numbers?"
- "Did 5 20 21 36 1 13 win anything in Lotto on Saturday?"
- "Show me the hot and cold numbers for Daily Lotto."
- "Which race meetings were on at Greyville this week?"
More details: resultsza.co.za/mcp
What you need
- Node.js 20 or newer.
- A ResultsZA API key: create a free account at resultsza.co.za/signup, then generate the key in My Dashboard.
- A plan: resultsza.co.za/api-pricing.
Set it up
Claude Desktop
Add this to claude_desktop_config.json (Settings, Developer, Edit Config), then restart Claude Desktop:
{
"mcpServers": {
"resultsza": {
"command": "npx",
"args": ["-y", "resultsza-mcp"],
"env": { "RESULTSZA_API_KEY": "YOUR_API_KEY" }
}
}
}
Cursor
Add the same block to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"resultsza": {
"command": "npx",
"args": ["-y", "resultsza-mcp"],
"env": { "RESULTSZA_API_KEY": "YOUR_API_KEY" }
}
}
}
VS Code
Add this to .vscode/mcp.json. VS Code asks for the key on first start and stores it securely:
{
"inputs": [
{
"type": "promptString",
"id": "resultsza-api-key",
"description": "ResultsZA API key",
"password": true
}
],
"servers": {
"resultsza": {
"type": "stdio",
"command": "npx",
"args": ["-y", "resultsza-mcp"],
"env": { "RESULTSZA_API_KEY": "${input:resultsza-api-key}" }
}
}
}
Tools
All tools are read-only.
| Tool | What it does | Cost |
|---|---|---|
get_lottery_results |
Results for South African games (with prize divisions and jackpot), UK 49's, EuroMillions, Irish Lotto, US Powerball, Mega Millions, Kenya, Nigeria, Ghana and Gosloto | 1 call |
check_lottery_numbers |
Check up to 10 lines against a South African draw | 1 call |
bulk_check_lottery_numbers |
Check up to 500 lines | 1 call per line |
get_horse_racing_meetings |
South African race meetings in a date range (up to 7 days) | 1 call |
get_horse_racing_card |
All races at a meeting with the top three and tote dividends | 1 call |
get_horse_race |
The full runner table for one race | 1 call |
generate_lottery_numbers |
Random lines for a game | 1 call |
lucky_numbers_from_text |
Numbers from a name or phrase | 1 call |
get_number_statistics |
Hot and cold numbers, frequencies or common pairs | 1 call |
check_balance |
Your plan, calls used and calls left | Free |
Calls come from your ResultsZA plan, exactly as if you called the API yourself. Badly formed requests (for example a date that is not YYYY-MM-DD, or an unknown game) are rejected before they use a call. A valid request that finds nothing, such as an unknown racecourse, still uses one.
Privacy and security
- Your API key stays on your machine. It is only ever sent to
https://resultsza.co.za; the address cannot be changed and redirects are refused. - The MCP server never writes your key to its logs or returns it in any tool result.
- ResultsZA never sees your conversations with your assistant.
- The server cannot run commands or read or write files on your computer.
Links
- API documentation: resultsza.co.za/api_docs
- Node and Python SDKs: github.com/Stef1986/resultsza-sdk
- Support: info@resultsza.co.za
ResultsZA is an independent service and is not affiliated with the South African National Lottery or any lottery or racing operator.
License
MIT
ResultsZA MCP questions
How do I add ResultsZA MCP to Claude Code?
Run claude mcp add --env 'RESULTSZA_API_KEY=<YOUR_RESULTSZA_API_KEY>' mcp -- npx -y resultsza-mcp in your terminal. Add --scope user to make it available in every project.
How do I add ResultsZA MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ResultsZA MCP provide?
It exposes 10 tools, including check_balance, get_lottery_results, check_lottery_numbers, bulk_check_lottery_numbers, get_horse_racing_meetings.
What kind of lottery results can I access?
You can access South African games, UK 49's, EuroMillions, Irish Lotto, US Powerball, Mega Millions, Kenya, Nigeria, Ghana, and Gosloto.
Can I check if my specific numbers won?
Yes, you can check up to 10 lines against a South African draw or use bulk checking for up to 500 lines.
Does the server provide horse racing information?
Yes, it provides South African race meetings, race cards with dividends, and full runner tables for specific races.
How is my API key handled?
Your API key stays on your machine and is only sent to the official ResultsZA website; it is never written to logs or returned in tool results.