Ask your AI assistant for lottery results

The official ResultsZA MCP server connects Claude, Cursor, VS Code and other AI assistants to the ResultsZA API, using your own API key.

resultsza.co.za / For developers

MCP (Model Context Protocol) is the standard way for AI assistants to use outside tools. Add the ResultsZA MCP server to your assistant and you can simply ask: "What were last night's Powerball numbers?", "Did my Lotto line win on Saturday?" or "Which race meetings were on at Greyville this week?" The assistant calls the ResultsZA API for you and answers from the official results.

What you need

Node.js 20 or newer on your computer.
A ResultsZA API key: create a free account, then generate the key in My Dashboard.
A plan from resultsza.co.za/api-pricing.

Set it up

Paste the block for your assistant, replace YOUR_API_KEY with your key, and restart the assistant. The package is resultsza-mcp on npm; npx downloads and runs it for you.

claude_desktop_config.json (Settings, Developer, Edit Config)

{
  "mcpServers": {
    "resultsza": {
      "command": "npx",
      "args": ["-y", "resultsza-mcp"],
      "env": { "RESULTSZA_API_KEY": "YOUR_API_KEY" }
    }
  }
}

~/.cursor/mcp.json

{
  "mcpServers": {
    "resultsza": {
      "command": "npx",
      "args": ["-y", "resultsza-mcp"],
      "env": { "RESULTSZA_API_KEY": "YOUR_API_KEY" }
    }
  }
}

.vscode/mcp.json (VS Code asks for the key 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}" }
    }
  }
}

What your assistant can do

All ten 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 against a South African draw	1 call per line
`get_horse_racing_meetings`	South African race meetings in a date range of 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

What it costs

The MCP server is free. Each tool call is a normal API call on your ResultsZA plan, exactly as if you called the API yourself, and checking your balance is free. Badly formed requests, such as 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 computer. It is only ever sent to resultsza.co.za; that address cannot be changed and redirects are refused.
The MCP server never writes your key to its logs or returns it to your assistant.
ResultsZA never sees your conversations with your assistant.
The server cannot run commands or read or write files on your computer.

Full endpoint reference: API documentation. Source code and the Node and Python SDKs: GitHub. Questions: 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.

What you need

Set it up

What your assistant can do

What it costs

Privacy and security

More