Ht MCP Server

A high-performance Rust implementation of a Model Context Protocol (MCP) server for headless terminal [ht](https://github.com/andyk/ht).

Local serverstdioTypeScript

What is the Ht MCP MCP server?

A high-performance Rust implementation of a Model Context Protocol (MCP) server for headless terminal ht. That is what the ht mcp mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

  • 🚀 Pure Rust: Single binary MCP server, no external dependencies
  • 🔗 Direct Integration: Embed excellent ht headless terminal library for optimal performance
  • 🖥️ Multi-Session: Concurrent terminal session management
  • 🌐 Web Interface: Optional live terminal preview

The tools it exposes

The server publishes 6 tools. What each one is for:

  • ht_create_session — Create new terminal session
  • ht_send_keys — Send keystrokes to session
  • ht_take_snapshot — Capture terminal state
  • ht_execute_command — Execute command and get output
  • ht_list_sessions — List all active sessions
  • ht_close_session — Close terminal session

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

What it needs from you

  • Rust: 1.75+ (install via rustup) - Supported OS: Linux, macOS, Windows (experimental)

How it compares

Among the browser automation options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Ht MCP's toolset — ht_create_session, ht_send_keys, ht_take_snapshot and 3 more — is a fair guide to whether it matches your workflow. It is maintained by memextech; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Ht MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
ht_create_sessionCreate new terminal session
ht_send_keysSend keystrokes to session
ht_take_snapshotCapture terminal state
ht_execute_commandExecute command and get output
ht_list_sessionsList all active sessions
ht_close_sessionClose terminal session

How to install the Ht MCP MCP server

For custom installation paths:

```json
{
  "mcpServers": {
    "ht-mcp": {
      "command": "/path/to/ht-mcp",
      "args": []
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Rust: 1.75+ (install via rustup) - Supported OS: Linux, macOS, Windows (experimental)

Example prompts to try

  • Use Ht MCP to ht create session.
  • Use Ht MCP to ht send keys.
  • Use Ht MCP to ht take snapshot.

Frequently asked questions

It connects Ht MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 6 tools (ht_create_session, ht_send_keys, ht_take_snapshot, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Ht MCP directly.