California Lottery MCP server for AI agents
Let Claude, ChatGPT or your own agent read California Lottery: 5 typed functions through one MCP server. No California Lottery API key needed.
- Site
- calottery.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for California Lottery alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/calotteryOne MCP server for California Lottery and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
checkNumbersChecks five picked numbers and a bonus number against every past California Lottery draw of a game, returning the draws where they matched.Arguments
Name Type Required game"powerball" | "megamillions" | "superlotto" | "fantasy5" | numberYes numbersnumber[]Yes bonusnumberNo sincestringNo Returns
CalotteryMatchedDraw[]interface CalotteryMatchedDraw { drawDate: string; numbers: { number: number; matching: boolean }[]; bonus: { number: number; matching: boolean } | null; matches: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calottery/checkNumbersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calottery.checkNumbers({ game: "powerball", numbers: [5, 12, 23, 34, 45], bonus: 7 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calottery.checkNumbers({ "game": "powerball", "numbers": [5, 12, 23, 34, 45], "bonus": 7 }))curl -X POST https://api.bowmark.ai/v1/sites/calottery/checkNumbers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"game":"powerball","numbers":[5,12,23,34,45],"bonus":7}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calottery.checkNumbers({ game: "powerball", numbers: [5, 12, 23, 34, 45], bonus: 7 });drawsReads California Lottery winning numbers, prize payouts and the next jackpot for Powerball, Mega Millions, SuperLotto Plus, Fantasy 5 and the Daily…Arguments
Name Type Required gameCalotteryGameYes pagenumberNo sizenumberNo Returns
CalotteryDrawResultsinterface CalotteryNumber { number: string; special: boolean; name: string | null; } interface CalotteryPrize { tier: string; winners: number | null; amount: number | null; } interface CalotteryDraw { drawNumber: number; drawDate: string; numbers: CalotteryNumber[]; prizes: CalotteryPrize[]; } interface CalotteryDrawResults { gameId: number; game: string; nextDraw: { drawNumber: number; drawDate: string; jackpot: number | null; cashValue: number | null } | null; totalDraws: number | null; draws: CalotteryDraw[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calottery/drawsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calottery.draws({ game: "powerball", size: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calottery.draws({"game": "powerball", "size": 3}))curl -X POST https://api.bowmark.ai/v1/sites/calottery/draws \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"game":"powerball","size":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calottery.draws({ game: "powerball", size: 3 });retailersFinds California Lottery retailers near a latitude and longitude, with address and which games they sell.Arguments
Name Type Required latitudenumberYes longitudenumberYes limitnumberNo Returns
CalotteryRetailer[]interface CalotteryRetailer { id: string; name: string; displayName: string | null; address: string; city: string | null; state: string | null; zip: string | null; latitude: number | null; longitude: number | null; hasAllGames: boolean; hasHotSpot: boolean; onlyInstantGames: boolean; lucky: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calottery/retailersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calottery.retailers({ latitude: 34.05, longitude: -118.24, limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calottery.retailers({"latitude": 34.05, "longitude": -118.24, "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/calottery/retailers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"latitude":34.05,"longitude":-118.24,"limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calottery.retailers({ latitude: 34.05, longitude: -118.24, limit: 3 });scratchersLists California Lottery Scratchers games with price, top prize and odds, filtered by name, number, price, type or show.Arguments
Name Type Required querystringNo pricenumberNo gameTypestringNo showstringNo sortstringNo pagenumberNo sizenumberNo Returns
CalotteryScratchersinterface CalotteryScratcher { gameNumber: number; name: string; price: string | null; topPrize: string | null; overallOdds: string | null; gameType: string | null; shows: string[]; launched: string | null; imageUrl: string | null; url: string | null; } interface CalotteryScratchers { total: number; pages: number; page: number; games: CalotteryScratcher[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calottery/scratchersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calottery.scratchers({ size: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calottery.scratchers({"size": 5}))curl -X POST https://api.bowmark.ai/v1/sites/calottery/scratchers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"size":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calottery.scratchers({ size: 5 });searchSearches calottery.com's pages and documents, returning titles and URLs.Arguments
Name Type Required querystringYes limitnumberNo offsetnumberNo Returns
CalotterySearchinterface CalotterySearchHit { id: string; title: string; path: string; url: string; language: string | null; } interface CalotterySearch { total: number; results: CalotterySearchHit[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/calottery/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.calottery.search({ query: "powerball", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.calottery.search({"query": "powerball", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/calottery/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"powerball","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.calottery.search({ query: "powerball", limit: 5 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/calottery/<function> - OpenAPI
/v1/sites/calottery/openapi.json