# Hand of the King

> Hand of the King (HOTK) is a browser-playable medieval kingdom simulation with a Go API, a Vue campaign console, and scoped MCP advisor grants for external LLMs.

This file is the canonical LLM entrypoint for HOTK. Use it to find compact, public-safe documentation. Do not treat it as an authentication secret or as a replacement for a player-approved advisor grant.

Important rules for agents:

- The public player site is `https://hotk.dev`.
- The human wiki is `https://wiki.hotk.dev`.
- The hosted MCP endpoint is `https://mcp.hotk.dev/mcp`.
- MCP clients authenticate with `Authorization: Bearer hotk_ag_...`.
- Advisor grants are read/list/propose only. They do not execute docket choices, royal actions, or ticks.
- Do not use Supabase browser/session tokens as MCP credentials.
- Do not ask for Supabase service keys, HOTK database access, or normal HOTK API tokens.
- Human players remain the authority for campaign identity, docket choices, royal actions, and tick advancement unless they explicitly enable a stronger mode.

## Core Docs

- [Start Here](https://wiki.hotk.dev/start-here.md): Overview of HOTK, the player role, and the hosted surfaces.
- [Campaign Setup](https://wiki.hotk.dev/campaign-setup.md): How campaigns, difficulty, king identity, origin, trait, path, and map generation fit together.
- [Turn Loop](https://wiki.hotk.dev/turn-loop.md): How docket items, royal actions, result cards, logs, and tick advancement work.
- [Kingdom Systems](https://wiki.hotk.dev/kingdom-systems.md): Treasury, legitimacy, resources, houses, nations, church, war, and collapse pressure.
- [Docket and Royal Actions](https://wiki.hotk.dev/docket-and-actions.md): The main decision surface and the proactive action budget.

## Game Reference

- [Council](https://wiki.hotk.dev/council.md): Advisor roles, counsel, relationship impact, vacancies, and why advisors are lenses rather than commanders.
- [Treasury, Trade, and Market](https://wiki.hotk.dev/treasury-trade-market.md): Gold, taxes, trade routes, tariffs, and barter-style market intent.
- [Map, Nations, and Church](https://wiki.hotk.dev/map-nations-church.md): Realm geography, houses, foreign nations, borders, faith, and diplomacy.
- [Skills, Dynasty, and Heirs](https://wiki.hotk.dev/skills-dynasty-heirs.md): KP, skill trees, succession, heirs, marriage, and lineage planning.
- [Troubleshooting and Glossary](https://wiki.hotk.dev/troubleshooting-glossary.md): Common terms, player mistakes, and agent debugging notes.

## MCP and APIs

- [Agent MCP Advisor](https://wiki.hotk.dev/agent-mcp-advisor.md): Public-safe connection model for external LLM advisors.
- [MCP API Calls](https://wiki.hotk.dev/mcp-api.md): MCP tools, grant handshake routes, delegated HOTK routes, scopes, and common errors.

## Optional

- [HOTK Web README](https://github.com/mentholmike/hotk-web): Hosted web shell and deployment notes.
- [HOTK API Repository](https://github.com/mentholmike/HOTK): Game engine, API, CLI, and campaign console source.