Play with your AI
Let your AI play Starfall from its own wallet: Claude, ChatGPT, Gemini, Grok, Cursor, OpenClaw, Hermes or an agent you built. On your computer, on the web or on your phone. About 10 minutes to set up.
You need: a Windows, Mac or Linux computer for your agent’s wallet. Your AI can be an app on that computer, or ChatGPT, Claude or Grok on the web or your phone: they reach your agent through a private link while the computer is on.
- Test money only. Starfall runs on Midnight’s Preprod test network. tNIGHT is free from a faucet and has no value.
- Your wallet stays with you. It’s a file on your computer. Lunardraw never sees it, even when your AI is on the web.
- You set the limits. Your AI can spend at most 25 tNIGHT a draw and 100 tNIGHT a day unless you change it. It can’t change the limits itself.
Using the Claude desktop app? The quickest way
- Download the Lunardraw extension and open the file: Claude installs it. Download the extension (opens in a new tab)
- When Claude asks for a Blockfrost project ID, get a free one: sign up, Add project, network “Midnight Preprod”, copy the Project ID, and paste it in. Blockfrost (opens in a new tab)
- Ask Claude: “Set me up for Starfall.” It shows your wallet’s address, the faucet for free test tNIGHT, and how far the first sync has got (a few hours, once). Then: “Buy me two QuickPick games.”
No Node.js or terminal needed. Another AI, or ChatGPT, Claude or Grok on the web or your phone? Follow the steps below.
-
Pick your AI
Already use one? Skip to step 2: ChatGPT, Claude or Grok on the web or your phone, or any app or agent from the list below. Starting fresh? The easiest is a desktop app (a free account is fine):
Download Claude (opens in a new tab) Download ChatGPT (opens in a new tab)
-
Install Node.js
A free program the Lunardraw kit runs on. Download the LTS version and install it like any app.
-
Run the setup
Open PowerShell (Windows: Start menu, type PowerShell) or Terminal (Mac), paste this line and press Enter:
npm install -g @lunardraw/agent; lunardraw-agent setupIt asks one thing at a time and opens the right pages for you:
- A free Blockfrost key: sign up, Add project, network “Midnight Preprod”, copy the Project ID. Blockfrost (opens in a new tab)
- Free test tNIGHT: paste the address it shows into the faucet. Faucet (opens in a new tab)
- Your AI apps: it finds Claude, ChatGPT, Codex, Gemini CLI, Cursor, VS Code, Windsurf, LM Studio, OpenClaw and Hermes on your computer and adds Lunardraw to them. Just say yes.
- On the web or your phone too? Say yes when it asks, and at the end it gives you a private link for ChatGPT, Claude or Grok.
- The first sync: a few hours the first time only. Leave the window open; if you close it, run lunardraw-agent setup again and it carries on.
“npm not found”? Close PowerShell and open a new one (it needs to see Node.js), then paste the line again.
-
Ask your AI
In an app on your computer
When the setup says All set, quit the app completely and open it again (Windows: right-click its icon by the clock, then Quit; Mac: its menu, Quit). Then ask in the app, not in PowerShell, in a new chat.
On the web or your phone
Add your private link (setup printed it; lunardraw-agent remote shows it again) as a custom connector:
- ChatGPT (Plus or Pro): turn on Developer mode in Settings, then add an app or connector with the link as its MCP server URL and No authentication.
- Claude (any plan): Customize, Connectors, Add custom connector, paste the link. It works in the Claude phone app too.
- Grok: grok.com/connectors, New Connector, Custom, paste the link.
Keep the link private: anyone with it can ask your agent to buy, within your limits. lunardraw-agent remote new-link makes a new one.
Then ask:
- “What’s on in Starfall right now?”
- “Buy me two QuickPick games.”
- “Pick 7 numbers you like and buy one game with Moonball 8.”
- “Did any of my tickets win?”
A purchase takes 2 to 3 minutes: your AI hears “buying” within a minute and it finishes by itself. Draws close every day at 8 pm Brisbane. Prizes are paid to the wallet automatically.
Not working? Paste this into PowerShell or Terminal: it checks everything and tells you what to fix.
lunardraw-agent doctor
Works with
Installed an app later? Run lunardraw-agent connect and it adds Lunardraw to it. Every app on a computer shares the same agent and wallet.
- Claudedesktop appSet up for you
- ChatGPTdesktop appSet up for you
- Claude CodeterminalSet up for you
- Codexterminal and appSet up for you
- Gemini CLIterminalSet up for you
- CursoreditorSet up for you
- VS Code (Copilot)editorSet up for you
- WindsurfeditorSet up for you
- LM Studiolocal modelsSet up for you
- OpenClawagentSet up for you
- Hermes AgentagentSet up for you
- ChatGPTwebPrivate link
- Claudeweb and phonePrivate link
- GrokwebPrivate link
- Cline, Zed, Goose…any MCP appOne line to add
- Your own agentany languageCommand line or local API
lunardraw-agent connectAny other app that uses MCP servers: add one called lunardraw with the command lunardraw-agent and the argument mcp (connect prints the full paths for your computer). Every tool answers within a minute, so the usual tool time limit is fine.
Build your own agent
The kit does the hard parts (the wallet, the zero-knowledge proofs, sending to Midnight); your agent decides what to play. Three ways in, from any language:
The command line
Every command takes –json, and then prints only the answer.
lunardraw-agent status --json
lunardraw-agent buy --games 2 --json
lunardraw-agent tickets --jsonThe local address
While the agent runs (lunardraw-agent serve, or any connected app), it answers on your computer with a small REST API and MCP over HTTP (/mcp). /openapi.json describes it. It needs the key in agent-token.secret, so other programs and web pages can’t use it.
KEY=$(cat ~/.lunardraw-agent/agent-token.secret)
curl -H "Authorization: Bearer $KEY" http://127.0.0.1:6338/api/draw
curl -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
-d '{"games": 2}' http://127.0.0.1:6338/api/buyA skill file
The rules and the commands as a SKILL.md, the format Claude, Codex, OpenClaw and Hermes read:
lunardraw-agent skill > SKILL.mdSpending limits
Out of the box your AI can spend up to 25 tNIGHT a draw and 100 tNIGHT in any 24 hours. To change that, edit the limits in config.json in the .lunardraw-agent folder in your home folder. Your AI can read the limits but can’t change them, and a purchase over them is refused, wherever your AI is.
If something’s not right
- Your AI searched the web for “Starfall”, or PowerShell said “not recognized”. Ask in your AI app after reopening it, not in PowerShell. If it still doesn’t know Starfall, run lunardraw-agent connect, then quit and reopen the app.
- ChatGPT, Claude or Grok on the web says the agent isn’t connected. Your computer is off or asleep, or the agent isn’t running there. Run lunardraw-agent remote: it starts the agent and keeps it starting when you sign in.
- Not sure what’s wrong. Run lunardraw-agent doctor: it checks the wallet, the Blockfrost key, the agent, the web link and which AI apps have Lunardraw, and says what to do next.
- npm or node “not found”. Close the terminal and open a new one after installing Node.js.
- Syncing for hours. That’s the first sync. Leave it running; it remembers where it got to.
- Your AI doesn’t show the Lunardraw tools. Run lunardraw-agent connect, then quit the app completely and reopen it (or reload its MCP servers).
- Your AI says “buying” but nothing more. A purchase takes 2 to 3 minutes and finishes by itself. Ask it a few minutes later what you bought, rather than buying again.
- “No DUST yet”. DUST pays the fees and builds up a few minutes after tNIGHT arrives. Try again shortly.
- “Over the owner’s limit”. The purchase would pass your spending limits (above).