
tv-mount-planner
io.github.getmediawall/tv-mount-planner
TV mounting maths: screen size, seating distance, mount height, VESA fit, anchors and HDMI length.
Documentation
TV Mount Planner (MCP server)
An MCP server that gives AI assistants computed answers about mounting a TV, instead of numbers from memory: screen size, seating distance, mount height, VESA fit, wall anchors and HDMI cable length.

Ask your assistant things like "How high should I hang a 65-inch TV over a 24-inch console?", "Is 110 inches too far for a 65-inch TV?" or "Will a mount rated 100 lb with 200x200 to 400x400 patterns fit a 55 lb TV with a 400x300 pattern?". It calls these tools and explains the result.
Tools
| Tool | What it returns |
|---|---|
screen_size | Width and height from the diagonal (16:9 by default, any aspect ratio). |
viewing_distance | Seating range from a 40° (THX) to 30° (SMPTE) field of view. With your seat distance: your field of view, in range / too close / too far, and the TV sizes that suit that seat. |
mount_height | Screen centre, bottom and top edge heights; raises the TV just enough to clear a console or mantel by 3"; warns above a 50" centre; how far the TV front stands off the wall for fixed, tilting and full-motion mounts. |
vesa_check | Whether a mount fits the TV's VESA pattern (mm) and weight, the load margin, and what to check for screws. |
wall_anchor_notes | Fasteners for wood stud, metal stud, brick or concrete, plus the safety checks that always apply. No invented load numbers: the mount and anchor ratings decide. |
cable_length | HDMI length to buy (run + 24" slack, rounded up to 3–50 ft stock sizes), with notes for long 4K/HDR runs and in-wall ratings. |
All lengths are inches, weights pounds, VESA patterns millimetres. Results come back as JSON (structuredContent) plus readable text.
Example, viewing_distance with {"diagonal_in": 65, "seat_distance_in": 110}:
{
"closest_ft": 6.5,
"farthest_ft": 8.8,
"field_of_view_deg": 28.9,
"verdict": "too_far",
"ideal_diagonal_range_in": [68, 92]
}
Install
Claude Desktop: download tv-mount-planner.mcpb from the latest release and open it (Settings → Extensions also accepts it).
Any MCP client (stdio): needs Node.js 18 or newer; there are no dependencies to install.
{
"mcpServers": {
"tv-mount-planner": {
"command": "node",
"args": ["/path/to/tv-mount-planner-mcp/server/index.js"]
}
}
}
Remote endpoint (no install): https://getmediawall.com/mcp (Streamable HTTP, stateless, no sign-in). It runs the same server/ code, hosted by GetMediaWall on getmediawall.com. Each request is answered on its own; there are no sessions, nothing is stored and request bodies are not logged. Add it as a custom connector (URL only) in clients that support remote MCP servers, or:
{
"mcpServers": {
"tv-mount-planner": { "type": "streamableHttp", "url": "https://getmediawall.com/mcp" }
}
}
It is also listed in the official MCP Registry as io.github.getmediawall/tv-mount-planner.
How the numbers are made
- 16:9 screen: width = diagonal × 16/√337, height = diagonal × 9/√337.
- Seating: distance = width / (2·tan(fov/2)) for 40° (THX recommendation) and 30° (SMPTE EG-18 minimum).
- Height: screen centre at seated eye height (default 42"), the usual installer rule.
- Stand-off: TV depth + 1.5" (fixed), 2.5" (tilting) or 3.5" (full-motion, folded); typical values, check your mount.
- The formulas are the same as in GetMediaWall's other open tools (rust-mediawall CLI, Redmine, Craft and Frappe plugins), so they all give the same numbers.
For per-model VESA patterns and weights, a model lookup server such as com.whatmount/lookup in the registry complements this one.
Privacy and safety
The server runs locally, makes no network requests and stores nothing. Its answers are planning estimates: always follow the TV and mount manuals and local electrical and building codes, never run a standard power cord inside a wall, and hire a licensed electrician for new outlets.
Development
node test/run.js # 22 tests: the maths against reference values, and a JSON-RPC session over stdio
Tagging v* runs the release workflow: tests, builds the .mcpb bundle, attaches it to a GitHub release and publishes server.json to the MCP Registry using GitHub OIDC.
About
Made by GetMediaWall, a US directory of TV mounting installers and media wall builders with a free wall planner. Written with an AI assistant (Claude) and covered by the tests above. MIT License.
https://github.com/getmediawall/tv-mount-planner-mcp/releases/download/v1.0.1/tv-mount-planner.mcpb# mcpb: https://github.com/getmediawall/tv-mount-planner-mcp/releases/download/v1.0.1/tv-mount-planner.mcpb