Deduction

Deduction — connector documentation

• MCP endpoint: https://deduction.connectorbay.com/mcp
• REST API: POST https://deduction.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://deduction.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://deduction.connectorbay.com/health · Tool schemas: https://deduction.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/deduction · agent@connectorbay.com

What Deduction is for

How elimination-deduction games work — mechanics, logic-grid puzzles, and how to design your own.

What it does

Deduction is a fully local, hand-curated reference on elimination-deduction games — the genre Clue/Cluedo popularized, described here in original, generic terms. mechanic_info explains one named mechanic in full: suggestion/disprove, process of elimination, accusations, notesheet tracking, board movement, card-counting, bluffing, cooperative and real-time variants, and more. term_glossary defines genre and logic-puzzle vocabulary. logic_grid_puzzle_howto explains how to solve (and design) a pure logic-grid puzzle, with clue types and a fully worked 3x3 example. category_list gives 10 abstract category archetypes (culprit, method, location, motive, time window, and more) with invented example items you can use to build your own game. difficulty_tuning_tip explains how design levers like category count, item count, hand size, and red herrings change difficulty. find_game_for_group suggests a format for any player count, from a solo logic puzzle to party-scale team play. beginner_tips gives an ordered shortlist of practical play tips. design_your_own computes concrete setup guidance — deck math, deal sizes, a difficulty estimate, and build steps — for a custom deduction game with however many categories and items you specify. 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. Deduction 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

Mechanics & Vocabulary

mechanic_info — Full explanation of one elimination-deduction mechanic: how it works step by step, and why it matters for a designer. Covers suggestion/disprove, process of elimination, accusations, notesheet tracking, movement, card-counting, bluffing, and more. Use for "how does disproving a suggestion work", "what is process of elimination in these games". Args: name.

term_glossary — Definitions of elimination-deduction and logic-grid-puzzle vocabulary — suggestion, accusation, solution set, disprove, notesheet, cross off, red herring, direct/negative/conditional/comparative clue, and more. Use for "what does disprove mean", "what's a negative clue". Args: term.

Logic Puzzles

logic_grid_puzzle_howto — Explains what a logic-grid puzzle is, how to solve one step by step, the four common clue types (direct, negative, conditional, comparative) with examples, a fully worked 3x3 example solved from clues to answer, and tips for designing your own logic-grid puzzle with a guaranteed unique solution. Use for "how do I solve a logic grid puzzle", "how do I write my own logic puzzle clues".

Build Your Own

category_list — Ten abstract category archetypes you can mix and match to build your own elimination-deduction game — a culprit/suspect role, a method, a location, a motive, a time window, and more — each with a short description and invented example items. None of these are drawn from any specific trademarked game's actual card set. Use for "what categories should my mystery game use", "give me ideas beyond suspects, weapons and rooms".

design_your_own — Computes concrete setup guidance for a custom deduction game with the given number of categories and items per category: total/solution/dealt card counts, deal sizes for common player counts, a qualitative difficulty estimate, step-by-step build instructions, and any warnings if the numbers are unusually small or large. Use for "help me design my own deduction game with 4 categories of 6 items each". Args: category_count, item_count.

difficulty_tuning_tip — How one specific design lever changes difficulty — category count, item count, hand size, red herrings, time limits, disprove visibility, notesheet complexity, solution uniqueness, or clue wording — with which direction makes the game easier vs harder. Use for "how do red herrings affect difficulty", "how many categories should a hard deduction game use". Args: topic.

Play It Well

find_game_for_group — Suggests a suitable elimination-deduction format for a given player count, from a solo logic-grid puzzle through the classic 4-6 player sweet spot to party-scale team variants, with specific adjustments for that group size. Use for "what deduction game format works for 8 players", "can this genre work solo". Args: player_count.

beginner_tips — An ordered shortlist of practical tips for playing (and designing) elimination-deduction games well — what to track, when to accuse, how to read logic-grid clues. Use for "what should a beginner know about these games", "tips for solving a whodunit puzzle faster". Args: count.

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/deduction/support

Deduction — Privacy Policy

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

What Deduction is. Deduction is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for how elimination-deduction games work — mechanics, logic-grid puzzles, and how to design your own. 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. Deduction is a general-audience service operated by the adult using the assistant.

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

Deduction — Terms of Service

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

1. The Service. Deduction is a fully local, hand-curated reference on elimination-deduction games — the genre Clue/Cluedo popularized, described here in original, generic terms.
2. A reference, not professional advice. Deduction 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/deduction

Deduction support

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

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