Repository avatar
Other Tools
v1.0.1
active

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.

A 65-inch TV over a 24-inch console: screen centre at eye level 42.9 inches, bottom edge 27.0, top 58.9, seating 6.5 to 8.8 feet

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

ToolWhat it returns
screen_sizeWidth and height from the diagonal (16:9 by default, any aspect ratio).
viewing_distanceSeating 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_heightScreen 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_checkWhether a mount fits the TV's VESA pattern (mm) and weight, the load margin, and what to check for screws.
wall_anchor_notesFasteners 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_lengthHDMI 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.

MCPB
https://github.com/getmediawall/tv-mount-planner-mcp/releases/download/v1.0.1/tv-mount-planner.mcpb
Install Command
# mcpb: https://github.com/getmediawall/tv-mount-planner-mcp/releases/download/v1.0.1/tv-mount-planner.mcpb