Number Guess

What Number Guess is for

A real, playable number-guessing game — not a rules reference. Classic mode: the engine picks a secret number and grades your guesses against optimal binary-search play. Reverse mode: you think of a number and the engine guesses it using real binary search.

What it does

new_game(mode, min_value, max_value) starts a round in one of two modes:

• you_guess — the engine secretly picks a number in your range. Call make_guess(state, guess) repeatedly; each response says higher/lower/correct and grades that guess against the optimal binary-search bisection of what's still possible, so you can tell how close to optimal play you were. get_hint(state) gives a hint (parity, which part of the range, digit sum) that never reveals the exact number.
• engine_guesses — you think of a number in the range. Call respond_to_guess(state, feedback) with "higher", "lower", or "correct" after each of the engine's guesses; the engine runs real binary search and finds your number within the mathematically-optimal number of guesses. Inconsistent feedback (answers that can't all be true at once) is detected and reported rather than silently mishandled.

render_game(state) renders the current game as readable text. game_rules() explains both modes and the optimal-strategy math without a live game.

Stateless architecture — and its one honest trade-off

Number Guess keeps no server-side session. Every tool call receives the full current game state as a plain JSON object and returns the new state; the calling assistant holds and passes it between turns. In you_guess mode, that means the returned state necessarily contains the actual secret number in plain form — there is no other place for a fully stateless server to keep it between calls. The assistant using this connector is trusted not to read that field back to the player before the round ends. This is a known, honestly-documented limitation of any stateless guessing-game API, the same trade-off every stateless word-guessing game in this catalog makes — not a bug, and not something a "hash the secret" trick actually fixes when the server has no memory at all between calls.

What it is not

Not a rules encyclopedia and not a random-number utility with no game logic — every response comes from a real, tested game engine, including genuine binary-search optimal-play grading. Fully local, zero upstream calls, nothing stored.

Number Guess — Privacy Policy

Effective 27 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Number Guess is. Number Guess is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf to run a real, playable, fully local number-guessing game. You interact with your assistant; the assistant sends us only the arguments needed for that one move — a game state object (which mode, range, and history so far) and your guess or feedback.

What we receive. The game state and move arguments for each tool call, the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is computed locally and nothing is stored server-side. There is no upstream call at all, live or otherwise, and no game state or query is logged in request bodies, recorded, or used to train anything. The entire game — including the secret number in "you_guess" mode — exists only inside the state object that travels between you and your assistant; our server never retains a copy after answering the request.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and each request is answered independently — nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire game engine is bundled with the server and runs locally. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Number Guess is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Number Guess — Terms of Service

Effective 27 September 2026. These terms govern use of the Number Guess connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Number Guess runs a real, playable number-guessing game with two modes (classic and reverse), each with genuine binary-search optimal-play logic, accessed through an AI assistant or directly over MCP or HTTP.
2. Stateless by design. The Service keeps no server-side game session. Each tool call must include the complete current game state; the calling assistant is responsible for holding and passing it faithfully. In "you_guess" mode the state necessarily contains the secret number in plain form, since a stateless server has no other place to keep it — see the Privacy Policy for the full explanation of this trade-off.
3. Just a game. Number Guess is a casual game utility, not a random-number-generation service for any other purpose (statistical sampling, cryptography, lotteries, or gambling of any kind) and must not be relied on as one.
4. Acceptable use. Automated use within the published rate limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: your move is answered from the game state you send us, and nothing is stored.
7. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
8. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service. Our total liability is limited to US $100.
9. Governing law. California law; venue in San Mateo County, California.
10. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/numberguess

Number Guess support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://numberguess.connectorbay.com/mcp
• REST API: https://numberguess.connectorbay.com/openapi.json
• Live status: https://numberguess.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Number Guess never asks for them.