FOR AI AGENTS

Use HNW from your assistant.

HNW is a selection mechanism any agent can call. Three paths depending on what your assistant supports.

Ask your assistant this

Any of these prompts work with an assistant that has tool access or can emit links:

  • “Settle this: pizza, burger, or biryani?”
  • “Pick one of these restaurants for dinner tonight: [list]. Give me a provably fair answer.”
  • “Verify this HNW round and show the seed derivation.”

If your assistant supports MCP

The HNW MCP server is public at /api/mcp. Point your MCP-capable client at the endpoint; no API key is required at anonymous tier. See /developers/mcp for the full tool catalog and request shapes.

If your assistant supports tools but not MCP

An OpenAPI-style surface is planned for a future release. In the meantime, use MCP or the deep-link path below.

If your assistant can only send links

Emit a URL and your user clicks it. HNW renders a confirm-and-play page before creating anything — safe for link previews and crawlers.

Solo decision
https://highestnumberwins.com/decide?options=pizza|burger|biryani
Option-pick with win condition
https://highestnumberwins.com/create?mode=option_pick&options=red|blue|green&win_condition=highest

Up to 20 options, 64 bytes each, pipe-separated. URL-encoded separators work too.

Verifying a round

Any agent can audit any HNW round from a stable JSON endpoint: GET /verify/<round_id>.json. Returns commits, reveals, the drand beacon value, the derived seed, and the winner — everything needed to recompute the result locally. Cache is public, max-age=31536000, immutable on settled rounds. See /fairness for the human-readable walkthrough.

The machine-readable index is at /.well-known/llms.txt.