A Rust MCP (Model Context Protocol) server that runs directly on the Flipper Zero's WiFi Dev Board v1 (ESP32-S2), enabling AI agents to control a Flipper Zero over the network.
What is this?
This project puts an MCP server on the Flipper itself. Any MCP-compatible AI client (Claude Desktop, Claude Code, etc.) can connect and use the Flipper's capabilities as tools — SubGHz, NFC, RFID, IR, GPIO, BadUSB, iButton, file storage, and more.
AI-powered MCP server for Flipper Zero. Control SubGHz, NFC, RFID, IR, BLE, GPIO, and more over WiFi using Claude or any MCP client.
Bintang
30
Tool
—
Uptime
—
Unlike other projects that require a USB-connected host computer, flipper-mcp runs on the ESP32-S2 WiFi module attached to the Flipper. The Flipper becomes a standalone, network-accessible tool.
Architecture
LOCAL (same network):
MCP Client ──HTTP──► flipper-mcp.local:8080 (ESP32-S2) ──UART──► Flipper Zero
REMOTE (cross-network):
MCP Client ──HTTP──► Relay Server ◄──WebSocket── ESP32-S2 ──UART──► Flipper Zero
The ESP32-S2 runs an HTTP server implementing the MCP protocol. It translates MCP tool calls into Flipper Zero CLI commands over UART at 115200 baud. A companion relay server enables remote access from any network.
Features
~30 built-in tools covering all default Flipper Zero applications
Or configure directly from the Flipper using the companion FAP (see Step 5):
Apps → Tools → Flipper MCP → Configure WiFi
On first boot without a config file, the ESP32 waits and writes status=needs_config to the status file. The Flipper FAP will display this on the Status screen.
4. Verify the server is working
Before configuring an AI client, confirm the server is reachable with curl:
# Quick health check
curl http://flipper-mcp.local:8080/health
# Full verification — initialize + list all available tools
./scripts/test-connection.sh
# If mDNS isn't resolving on your OS, pass the IP directly:
./scripts/test-connection.sh 192.168.x.xxx
Test MCP tools directly with curl
Get the Flipper's IP from the Flipper MCP → Status menu, then test:
BLE beacon broadcast (transmit spoofed BLE advertisement):
BLE HID keyboard (emulate a wireless keyboard and type):
# Start HID emulation
curl -X POST http://192.168.0.58:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ble_hid_start","arguments":{}}}'
# Type a message
curl -X POST http://192.168.0.58:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ble_hid_type","arguments":{"text":"Hello from Flipper!"}}}'
# Stop HID emulation
curl -X POST http://192.168.0.58:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"ble_hid_stop","arguments":{}}}'
IR transmit (send IR remote control codes):
# NEC protocol IR code (generic TV power button)
curl -X POST http://192.168.0.58:8080/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"ir_tx","arguments":{"protocol":"NEC","address":"00","command":"01","repeat":0}}}'
SubGHz receive (listen for wireless signals on 433.92 MHz):
Install the companion Flipper MCP app from flipper-app/ onto the Flipper Zero. Build with ufbt and copy the .fap to SD:/apps/Tools/:
cd flipper-app && ufbt # produces flipper_mcp.fap
# Copy flipper_mcp.fap to your Flipper SD card under apps/Tools/
The app appears in Apps → Tools → Flipper MCP and provides:
Screen
What it does
Status
Requests a fresh status update from the ESP32, shows IP, SSID, server state, version
Start / Stop / Restart
Controls the MCP HTTP server lifecycle
Reboot Board
Restarts the ESP32 WiFi Dev Board
Configure WiFi
On-screen keyboard to enter SSID + password; writes config.txt to SD card
View Logs
Scrollable diagnostic log written by the ESP32 every 30 s
Tools List
Scrollable list of all MCP tools currently registered on the ESP32
Refresh Modules
Triggers FAP discovery rescan + modules.toml reload on the ESP32
The app communicates via SD card files (no extra wiring beyond the GPIO header). Configure WiFi is the first-boot wizard — no phone, browser, or PC scripts required.
6. (Optional) Remote access via relay
Self-hosted (run the binary anywhere):
./scripts/build-relay.sh
./target/release/flipper-mcp-relay --listen 0.0.0.0:9090
# Then add relay_url to config.txt on the Flipper SD card:
# relay_url=ws://your-server:9090/tunnel
Cloud deployment (AWS or GCP, with TLS + DNS):
# Bootstrap state storage, then deploy
./infra/bootstrap/aws.sh # or ./infra/bootstrap/gcp.sh
cd infra/aws && cp terraform.tfvars.example terraform.tfvars
tofu init && tofu apply
# Outputs the relay URL and a ready-to-paste wifi-config.sh command
Bluetooth Low Energy (beacon broadcast + HID emulation)
Apps
app_launch_{name} (auto-discovered from SD card)
Application management
Custom tools can be added via TOML config files or by installing FAP apps on the SD card. See OPERATIONS.md for copy-paste curl commands for every tool.
Free Alternative: Open WebUI + Ollama
You don't need a Claude subscription to use flipper-mcp. Open WebUI is a free, self-hosted ChatGPT-style interface that natively supports MCP Streamable HTTP (v0.6.31+). Pair it with Ollama for fully local, offline AI-driven Flipper control.
1. Install Ollama and pull a tool-capable model
# Install Ollama
curl -fsSL https://ollama.com/install.sh | sh
# Pull a model with tool-calling support
ollama pull llama3.1 # 8B — good balance of speed and capability
# or: ollama pull qwen2.5 # strong tool-calling, good at structured output
# or: ollama pull mistral # lightweight, fast tool use
2. Start Open WebUI
# Docker (recommended) — connects to Ollama on localhost automatically
docker run -d -p 3000:8080 \
--add-host=host.docker.internal:host-gateway \
-e OLLAMA_BASE_URL=http://host.docker.internal:11434 \
-e WEBUI_AUTH=False \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main
# Or without Docker:
pip install open-webui
open-webui serve
From Docker: use http://host.docker.internal:8080/mcp if the Flipper is on the Docker host's network
Set Authentication to None (flipper-mcp has no auth)
Save
Tip: Under Workspace → Models → (your model) → Advanced Parameters, set Function Calling to Default for smaller models. Only switch to Native for models with strong built-in tool support (Llama 3.1 8B+, Qwen 2.5, Mistral).
4. Example prompts
Once connected, try these in the Open WebUI chat:
Prompt
What it does
"Scan for NFC tags near the Flipper"
Calls nfc_detect to read nearby tags
"List all files on the Flipper's SD card"
Calls storage_list on /ext
"Transmit this SubGHz signal on 433.92 MHz: ..."
Calls subghz_tx with the given frequency
"Read any RFID card that's presented to the Flipper"
Calls rfid_read and returns tag data
"What apps are installed on the Flipper?"
Calls app_list to enumerate installed FAPs
"Send this IR signal to turn off the TV"
Calls ir_tx with the specified protocol and data
"Show me the Flipper's system info and free memory"
Calls system_info + system_free
"Read the NFC tag, then save its data to /ext/nfc/captured.nfc"
Multi-step: nfc_read → storage_write
"Monitor 315 MHz for 10 seconds and decode anything you hear"
Calls subghz_rx with frequency and duration
Multi-step agentic tasks work best with larger models (Llama 3.1 70B, Qwen 2.5 72B, or cloud models via OpenAI-compatible APIs). Smaller models handle single-tool calls reliably.
DESIGN.md — Technical design and system architecture
For AI Agents
See AGENTS.md for complete project context, technical specifications, system architecture, and everything needed to continue development on this project.
License
MIT
F
Flipper
roostercoopllc·30 bintang·
AI-powered MCP server for Flipper Zero. Control SubGHz, NFC, RFID, IR, BLE, GPIO, and more over WiFi using Claude or any MCP client.
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Pertanyaan
Bagaimana cara menginstal Flipper?
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Apakah Flipper memerlukan kunci API?
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
Transport apa yang digunakan Flipper?
Flipper berjalan secara lokal melalui stdio.
Kapan Flipper terakhir diperiksa?
Terakhir diperiksa 2026-10-28. AI-powered MCP server for Flipper Zero. Control SubGHz, NFC, RFID, IR, BLE, GPIO, and more over WiFi using Claude or any MCP client.