Allows controlling AR lenses, face filters, Vtuber avatars, and effects in OBS Studio via Streamfog and Streamer.bot during live broadcasts.
Enables AI agents to trigger lens switches, avatar toggles, and effect clears on Twitch streams using chat events and channel points.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Streamfog MCP switch to the cyber helmet lens"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📖 Installation Guide — quick start, manual setup, and troubleshooting
AI-driven AR lens orchestrator for live OBS streams. Control Streamfog face filters, AR effects, and Vtuber avatars through MCP tools via the local Streamer.bot WebSocket bridge. Your AI assistant becomes a stream producer.
You might use this if… | You want your AI to switch AR lenses, toggle Vtuber avatars, or clear effects during live OBS broadcasts — controlled by Twitch chat events, channel points, or agentic automation. |
What it connects to | Streamfog desktop app → Streamer.bot WebSocket → this MCP server |
Ports | Backend 10994, Dashboard 10995 |
Start |
|
┌─────────────┐ MCP SSE ┌──────────────────┐ WebSocket ┌──────────────┐
│ LLM Agent │ ───────────────→ │ streamfog-mcp │ ────────────────→ │ Streamer.bot │
│ (Claude, │ ←─────────────── │ :10994 (FastMCP) │ ←──────────────── │ :8080 │
│ Gemini) │ JSON-RPC stdio │ :10995 (React) │ DoAction JSON │ │
└─────────────┘ └──────────────────┘ └──────┬────────┘
│ Native Hook
┌──────▼────────┐
│ Streamfog │
│ Desktop App │
└──────┬────────┘
│ Browser Source
┌──────▼────────┐
│ OBS Studio │
└───────────────┘Related MCP server: twitch-mcp
uv sync
# Edit lenses.json with your Streamer.bot action names
# Set STREAMFOG_MCP_STREAMERBOT_TOKEN in .env if using auth
.\start.ps1MCP-only via stdio (for Cursor, Claude Desktop):
uv run -m streamfog_mcp --stdioStreamfog installed and running
Streamer.bot installed and running
Streamfog → Streamer.bot integration enabled in Streamfog's Integrations panel
Streamer.bot WebSocket server enabled (Settings → WebSocket Server)
Actions created in Streamer.bot (e.g. SetLens_BeautySmooth, ClearEffects, ToggleAvatar)
lenses.json populated with your action→lens mappings
Variable | Default | Description |
|
| Streamer.bot WebSocket host |
|
| Streamer.bot WebSocket port |
| — | Streamer.bot auth token |
|
| Path to lens→action mapping file |
|
| Backend port |
lenses.json){
"beauty_smooth": "SetLens_BeautySmooth",
"cyber_helmet": "SetLens_CyberHelmet",
"vtuber_avatar": "SetLens_VTuberAvatar"
}Keys are human-readable lens identifiers used in MCP tool calls. Values are the corresponding Streamer.bot action names.
Tool | Description |
| Activate a specific AR lens or face filter |
| Strip all effects, return camera to baseline |
| Toggle Vtuber-style avatar on/off |
Tool | Description |
| List all configured lenses from lenses.json |
| Bridge connection health + lens count |
Endpoint | Method | Description |
| GET | Server + bridge health |
| GET | List all lenses |
| POST | Activate a lens ( |
| POST | Reload lens map from disk |
| POST | Clear all effects |
| POST | Toggle avatar |
Single-page dark dashboard at :10995:
Connection status indicator (Streamer.bot bridge health)
Lens grid with one-click activation
Quick action buttons (Clear Effects, Toggle Avatar)
Lens map reload
Auto-refresh every 5 seconds
streamfog-mcp/
├── src/streamfog_mcp/
│ ├── _mcp.py FastMCP singleton
│ ├── server.py Unified FastAPI + FastMCP gateway
│ ├── __main__.py CLI entry (--stdio / --serve)
│ ├── config.py Pydantic settings (STREAMFOG_MCP_ prefix)
│ ├── tools/
│ │ ├── __init__.py Portmanteau import
│ │ └── core_tools.py 5 @mcp.tool() decorators
│ └── services/
│ └── streamerbot.py Streamer.bot WebSocket client
├── webapp/ Vite + React 19 + Tailwind
│ └── src/
│ └── pages/Dashboard.tsx
├── lenses.json Lens → action mapping
├── pyproject.toml
├── start.ps1 / start.bat
├── justfile
└── tests/
└── test_basic.py 5 testsStreamfog does not expose a native CLI or local API — all control goes through Streamer.bot
Lens activation is fire-and-forget (Streamer.bot does not report success/failure for actions)
No lens preview or thumbnail retrieval (Streamfog desktop is a black box)
Lumia/Crowd Control bridge path is documented but not yet implemented as an alternative transport
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
MCP server for AI dialogue using various LLM models via AceDataCloud
AI Reasoning Cache & Consensus Layer with 11 MCP tools via Streamable HTTP.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/sandraschi/streamfog-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server