Skip to main content
Glama
TV Mount Planner

TV Mount Planner

by getmediawall
README.md
# TV Mount Planner (MCP server)

<!-- mcp-name: io.github.getmediawall/tv-mount-planner -->

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](images/diagram.png)

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}`:

```json
{
  "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](https://github.com/getmediawall/tv-mount-planner-mcp/releases/latest) and open it (Settings → Extensions also accepts it).

**Any MCP client (stdio):** needs Node.js 18 or newer; there are no dependencies to install.

```json
{
  "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](https://registry.modelcontextprotocol.io/) 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](https://github.com/getmediawall/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

```bash
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](https://getmediawall.com/), a US directory of TV mounting installers and media wall builders with a free [wall planner](https://getmediawall.com/design-your-wall). Written with an AI assistant (Claude) and covered by the tests above. MIT License.