Tactus

A content-agnostic MCP server that lets any AI agent control intimate hardware through a clean, safe tool interface.

Tactus is a thin, neutral control layer. It wraps Buttplug / Intiface — so a single integration reaches 750+ devices across ~26 brands — and exposes them to AI agents as Model Context Protocol (MCP) tools. It forwards hardware control commands only. It does not generate, host, or store any content of any kind.

• Safety first. Intensity clamping, an independent watchdog auto-stop, a one-call emergency stop, and fail-safe stop semantics are built in and on by default — this is the headline feature, not an afterthought.
• One-line install. npx -y tactus-mcp, no clone or build.
• OS-agnostic. Tactus never touches Bluetooth. Intiface owns the radio; we just talk to it over a local WebSocket.

⚠️ Adults only (18+, or the age of majority in your jurisdiction). For use only on devices you own and only with the consent of everyone involved.

How it works

  AI client / agent           Tactus (this server)            Intiface Central
  (Claude Desktop,    MCP      - MCP server          WebSocket - holds BLE/USB
   Claude Code, your  ───────▶ - Buttplug client     ────────▶   - 750+ device
   own AI product)            - SAFETY LAYER          :12345      protocols
                                                                     │ BLE/USB
                                                                     ▼
                                                                🔵 your device

Everything runs locally on your machine. Tactus is a Buttplug client that connects to a locally running Intiface Central/Engine at ws://127.0.0.1:12345.

Prerequisites

1. Install Intiface Central.
2. Open it and click Start Server.
3. Pair your device (or, for development, add a simulated device under Devices → Manage Simulated Devices).

Install & configure

Tactus runs over stdio via npx. Add it to your MCP client config.

Claude Desktop / Claude Code (claude_desktop_config.json):

{
  "mcpServers": {
    "tactus": {
      "command": "npx",
      "args": ["-y", "tactus-mcp"],
      "env": { "MAX_INTENSITY": "1.0" }
    }
  }
}

The same command/args work for any MCP client that launches stdio servers (Cursor, Cline, Continue, etc.).

Tools

All intensities are normalized to 0.0–1.0. Every tool returns both structured data and human-readable text.

Safety

The safety layer wraps every driving command and is on by default:

• Intensity clamp — requests are clamped to MAX_INTENSITY; the effective value is reported back, and out-of-range input is rejected with a clear error rather than silently coerced.
• Watchdog auto-stop — any continuous drive auto-stops after MAX_CONTINUOUS_MS (default 10 minutes) unless refreshed by a new command. This is an independent timer, not a check-on-next-call.
• **Stop on disconnec

... View full README on GitHub