Skip to main content
Glama
TV Mount Planner

TV Mount Planner

by getmediawall

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

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]
}

Related MCP server: vibetv

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"]
    }
  }
}

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Gives AI coding agents eyes and hands on a TV: capture the screen as an image, press remote keys, type text, read console logs and JS errors, deploy projects, launch apps, and apply or revert system tweaks across Android TV, Google TV, Fire TV, Roku and LG webOS. This lets an agent design, live-check and iterate on a custom ad-free home screen directly on the big screen.
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to fetch live environmental telemetry, verify local Fire TV and smart-meter hardware over TCP sockets, calibrate display and audio settings, orchestrate smart-home scenes, calculate energy savings, and answer natural-language questions about its capabilities.
      MIT