Dice Roll

Diceroll — connector documentation

• MCP endpoint: https://diceroll.connectorbay.com/mcp
• REST API: POST https://diceroll.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://diceroll.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://diceroll.connectorbay.com/health · Tool schemas: https://diceroll.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/diceroll · agent@connectorbay.com

What Diceroll is for

A hand-curated dice-game reference — rules, real scoring math, odds and beginner tips.

What it does

Diceroll is a fully local, hand-curated dice-game reference. game_rules gives one game's full detail: category, player count, duration, equipment, setup, numbered step-by-step play, scoring notes, winning condition and variants. scoring_summary computes a real score for games with calculable scoring — every Yacht/Yahtzee-family category (or all of them) for 5 dice, a full Farkle roll's breakdown, a Cee-lo roll's outcome, a Bunco roll's points against a round target, a Ship-Captain-Crew cargo total, or a Pig turn's running total and bust status — or returns the textual rules for games without a numeric score. term_glossary defines dice-game terms. games_by_player_count and find_game_for_group suggest games by player count and duration. probability_note computes real odds for a simple single-die or two-dice outcome. category_list lists every category, and beginner_tips gives a curated shortlist for learning a specific game. Keyless; fully local; zero upstream calls; nothing stored.

What it is not

Not an official product of, or affiliated with, any brand, league, publisher, or organization it may factually mention. Diceroll is a hand-curated reference and design tool, not a substitute for an official rulebook, certified instruction, or professional advice. Fully local, zero upstream calls, nothing stored.

Tools

Look Up a Game

game_rules — Full detail for one dice game: category, player count, duration, equipment, setup, numbered step-by-step play, scoring notes, winning condition, and known variants. Use for "how do I play Farkle", "what are the rules of Ship Captain Crew". Args: name.

category_list — Every dice-game category covered (Push Your Luck, Category Scoring, Bluffing & Deduction, Casino-Style Social, Party & Pure Luck, Pub & Folk, Speed & Reflex) with how many games are in each. Use for "what kinds of dice games do you cover".

term_glossary — Definitions of common dice-game terms — bust, hot dice, push your luck, point, natural, snake eyes, boxcars, cargo, wild, bid/raise, house rule, and more. Use for "what does hot dice mean", "what's a natural in Craps". Args: term.

Calculate

scoring_summary — Computes a REAL score, not a lookup, when dice are given for a game with calculable scoring: every Yacht/Yahtzee-family category (or one named category) for 5 dice, a full Farkle roll's breakdown, a Cee-lo roll's outcome, a Bunco roll's points against a round target, a Ship-Captain-Crew cargo total, or a Pig turn's running total and bust status. Without dice, returns the game's textual scoring/winning rules instead (used for Liar's Dice and Roll & Pass, which have no numeric score). Use for "score this Yacht roll: 3 3 3 5 5", "what's the Farkle value of 1 1 1 5 2 6", "is 4 4 2 a good Cee-lo roll". Args: name, dice, category, target.

probability_note — Real combinatorial probability for a simple single-die or two-dice outcome — exact fraction, decimal, percent, and a short note tying it to the named game when relevant (e.g. a Pig bust chance, a Craps natural). Use for "odds of rolling a 7 with two dice", "chance of snake eyes", "how likely is a bust in Pig". Args: game, dice_count, outcome.

Get Recommendations

games_by_player_count — Every dice game in this reference that fits a given number of players. Use for "what dice games work for 5 people", "dice games for just two of us". Args: count.

find_game_for_group — Suggests dice games that fit a player count and, optionally, a rough duration, with games whose ideal player range matches listed first. Use for "what dice game works for 8 people in under 20 minutes", "quick dice game for 3 players". Args: player_count, duration.

beginner_tips — A curated shortlist of tips for learning a specific dice game. Use for "any tips for playing Farkle", "how do I get better at Pig". Args: name.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/diceroll/support

Diceroll — Privacy Policy

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

What Diceroll is. Diceroll is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a hand-curated dice-game reference — rules, real scoring math, odds and beginner tips. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup.

What we receive. The arguments of 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 answered from a bundled, hand-curated reference file and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and 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 dataset is bundled with the server and answered 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. Diceroll is a general-audience service operated by the adult using the assistant.

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

Diceroll — Terms of Service

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

1. The Service. Diceroll is a fully local, hand-curated dice-game reference.
2. A reference, not professional advice. Diceroll is an independent reference and hobby/game-design tool, not affiliated with or endorsed by any brand, organization, league, or publisher it may factually mention. It does not provide legal, financial, medical, or safety-certification advice, and is not a substitute for supervised instruction where real physical risk is involved.
3. Content varies. Rules, terminology and conventions described here reflect commonly-cited general practice; local house rules, regional variants, and official governing-body rulebooks may differ.
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 query is answered from a bundled reference file, 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/diceroll

Dice Roll support

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

• MCP endpoint: https://diceroll.connectorbay.com/mcp
• REST API: https://diceroll.connectorbay.com/openapi.json
• Live status: https://diceroll.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. Dice Roll never asks for them.