Buttplug
Buttplug.io Model Context Protocol (MCP) Server
What is Buttplug?
Buttplug is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to buttplug.io model context protocol (mcp) server
Buttplug.io Model Context Protocol (MCP) Server
This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Buttplug.io Model Context Protocol (MCP) Server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx buttplugConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Buttplug
The Buttplug MCP Server is a Go-based bridge that connects the Buttplug.io device communication protocol to AI assistants via the Model Context Protocol, allowing LLMs to discover, monitor, and control intimate hardware devices through natural language. It communicates with the Intiface Central hub application over a local WebSocket connection and exposes MCP resources for listing connected devices and querying battery and signal levels, as well as a `device_vibrate` tool for controlling motor intensity. Developers and researchers building AI-driven interactive experiences or hardware control pipelines can use it to integrate Buttplug-compatible devices into any MCP-enabled AI workflow.
Prerequisites
- Intiface Central application installed and running on your machine (manages Bluetooth/USB device connections)
- At least one Buttplug.io compatible device paired to Intiface Central
- The buttplug-mcp binary installed via Homebrew or downloaded from GitHub releases
- An MCP-compatible client such as Claude Desktop
- macOS, Linux, or Windows (Homebrew tap available for macOS)
Install Intiface Central
Download and install Intiface Central from https://intiface.com/central/. This application manages Bluetooth, USB, and serial connections to your devices and runs a local WebSocket server that buttplug-mcp connects to. Start it and pair your devices before proceeding.
Install the buttplug-mcp binary
Install via Homebrew on macOS, or download the appropriate pre-built binary for your platform from the GitHub releases page.
# macOS via Homebrew
brew tap conacademy/homebrew-tap
brew install conacademy/tap/buttplug-mcpVerify Intiface Central is running on the default port
Buttplug-mcp connects to Intiface Central's WebSocket server on port 12345 by default. Confirm Intiface Central is running and the server is started within the app before configuring your MCP client.
Configure your MCP client
Add buttplug-mcp to your Claude Desktop configuration. Specify the WebSocket port that matches your Intiface Central configuration.
{
"mcpServers": {
"buttplug": {
"command": "/opt/homebrew/bin/buttplug-mcp",
"args": ["--ws-port", "12345"]
}
}
}Test device discovery
Restart your MCP client and ask it to list connected devices. The server will query Intiface Central and return information about any paired hardware.
Buttplug Examples
Client configuration
Claude Desktop configuration for the buttplug-mcp binary installed via Homebrew, connecting to Intiface Central on default port 12345.
{
"mcpServers": {
"buttplug": {
"command": "/opt/homebrew/bin/buttplug-mcp",
"args": ["--ws-port", "12345"]
}
}
}Prompts to try
Natural language prompts to interact with connected Buttplug devices through Claude.
- "List all connected devices and their capabilities"
- "What is the battery level of my connected device?"
- "Set the vibration on device 0 to 50% strength"
- "Vibrate the second motor on device 0 at 75% for 3 seconds"
- "Check the signal strength of all connected devices"
- "Stop all vibration on every connected device"Troubleshooting Buttplug
Server fails to connect with 'WebSocket connection refused' on port 12345
Open Intiface Central and ensure the WebSocket server is explicitly started (there is a Start Server button in the app). The server does not start automatically on launch in all versions. Also confirm the port in your --ws-port argument matches the port shown in Intiface Central settings.
Device list is empty even though devices are paired in Intiface Central
Devices must be actively connected (not just paired) in Intiface Central for them to appear. Click Scan for Devices in Intiface Central and ensure your device is powered on and in range. Bluetooth devices can take a few seconds to appear after a scan.
The binary is not found when Claude Desktop starts the server
Claude Desktop does not inherit your shell PATH. Use the full absolute path to the binary in the command field, for example /opt/homebrew/bin/buttplug-mcp on Apple Silicon Macs. Run `which buttplug-mcp` in your terminal to find the correct path.
Frequently Asked Questions about Buttplug
What is Buttplug?
Buttplug is a Model Context Protocol (MCP) server that buttplug.io model context protocol (mcp) server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Buttplug?
Follow the installation instructions on the Buttplug GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Buttplug?
Buttplug works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Buttplug free to use?
Yes, Buttplug is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Buttplug Alternatives โ Similar APIs Servers
Looking for alternatives to Buttplug? Here are other popular apis servers you can use with Claude, Cursor, and VS Code.
Kong
โ 43.4k๐ฆ The API and AI Gateway
API Mega List
โ 5.4kThis GitHub repo is a powerhouse collection of APIs you can start using immediately to build everything from simple automations to full-scale applications. One of the most valuable API lists on GitHubโperiod. ๐ช
Fetch
โ 5.4kFetch web content and convert to markdown for AI consumption
Fusio
โ 2.1kSelf-Hosted API Management for Builders
Korean Law
โ 1.8k๊ตญ๊ฐ๋ฒ๋ น์ ๋ณดMCP v4.0 | ๋ฒ์ ์ฒ 41๊ฐ API โ 17๊ฐ MCP ๋๊ตฌ. ๋ฒ๋ นยทํ๋กยท์กฐ๋ก ๊ฒ์ + LLM ํ๊ฐ ๋ฐฉ์ง ์ธ์ฉ๊ฒ์ฆ + ์กฐ๋ฌธ ์ํฅ ๊ทธ๋ํ(impact_map) + ์์ ๋น๊ต ์๋ diff(time_travel) + ์๋ฏผ 5๋จ๊ณ ์คํ ๊ฐ์ด๋(action_plan) | 41 Korean legal APIs โ 17 MCP tools
RuleGo
โ 1.5kโ๏ธRuleGo is a lightweight, high-performance, embedded, next-generation component orchestration rule engine framework for Go.
Browse More APIs MCP Servers
Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Buttplug in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Buttplug?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.