# Minigolf Hole Checker > Check a minigolf hole: playable, estimated par and how many putts a perfect caddie needs. Checks a Puttopia hole — built-in or made in the hole editor — for problems (start or cup off the course, cup unreachable, portal exits in the water), estimates its par from the route length and the hazards on it, counts surfaces and obstacles, and lets the caddie play it with the real physics to prove it can be holed. Part of usefulweb.app (https://usefulweb.app/). Part of [Puttopia](https://puttopia.usefulweb.app/) (ownerApp: puttopia). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows. ## Use it - Human interface: https://puttopiaholecheck.usefulweb.app/ (interactive tool at https://puttopiaholecheck.usefulweb.app/tool) - JSON API: POST https://puttopiaholecheck.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://puttopiaholecheck.usefulweb.app/api/v1/tool) - OpenAPI: https://puttopiaholecheck.usefulweb.app/openapi.json - MCP (Streamable HTTP): https://puttopiaholecheck.usefulweb.app/mcp - tool `puttopia_hole_check` ## Inputs - course (select): Course - hole (integer): Hole number (1–9) - customHole (textarea): Custom hole (JSON, only for “Custom hole”) - Tiles as text rows (. void, # block, g green, s sand, i ice, w water, B bridge, > < ^ v conveyor belts, E W N S slopes down toward east/west/north/south), start and cup as [x, y] in tiles, objects such as bumpers, windmills, portals and loops. - caddie (boolean): Let the caddie play the hole ## Method - Errors: the start or the cup is not on playable floor, they are closer than 1.5 tiles, a portal exit is not on playable floor, or no route leads from the start to the cup. The route search walks through floor tiles (8 directions, no corner cutting), over bridges and the water a raft covers, and takes portals and loops as short cuts. - Estimated par = 2, plus 1 for every 8 tiles of route beyond the first 6, plus 1 when the hole has two or more hazards (windmills, moving blocks, loops, rafts, gates, water, sand), between 2 and 6. - The caddie tries 72 directions × 10 power levels with the real physics for each putt and plays the one that ends nearest the cup along the route (holed first, water last). It knows the physics exactly, so it is better than any person — treat its strokes as the best case. ## Limits - Par is an estimate for fun play, not an official minigolf rating.