SnappySnag
OfficialProvides tools for accessing and managing SnappySnag bug reports from Flutter apps, including visual pin annotations, screenshots, widget tree/device diagnostics, and feedback ticket status updates.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
SnappySnag Model Context Protocol (MCP) Server
The official Model Context Protocol (MCP) integration for SnappySnag — seamlessly bridge Flutter in-app bug reports, pin annotations, screen diagnostics, and device logs directly into Cursor, Windsurf, Claude Desktop, and other AI coding assistants.
⚡ What is SnappySnag MCP?
When testing Flutter applications, QA testers and end-users pinpoint visual bugs or unexpected behaviors directly on the mobile screen. SnappySnag captures:
Exact visual pin coordinates and feedback comments
Annotated high-resolution screenshot
Active screen class & widget tree hierarchy
Real-time device logs (OS, platform, version, device metadata)
AI-generated root-cause insights and resolution prompts
With the SnappySnag MCP Server, your AI coding agent (in Cursor, Windsurf, Claude, etc.) can inspect these bug reports directly, jump straight to the relevant Flutter widget code, implement fixes, and mark tickets as resolved without ever switching context away from your editor.
Related MCP server: MCP Server Example
🛠️ Available MCP Tools
Tool | Description | Key Parameters |
| Fetches the most recent bug report or user feedback with full details (active pins, screenshot, metadata, device info). |
|
| Searches and lists feedback tickets matching filter criteria (status, severity, keyword). Returns lightweight summaries. |
|
| Retrieves complete details for a specific feedback ID, including screenshot image, active pins, and discussion notes. |
|
| Updates ticket status ( |
|
🚀 Quick Start / Configuration
SnappySnag supports two connection options:
Option A (Command / stdio with Demo Mode): Runs locally via standard MCP stdio. If no key is provided, an interactive Demo Mode with mock Flutter bug tickets is activated!
Option B (Remote SSE / Streamable HTTP): Connects directly to SnappySnag's hosted endpoint without any local dependencies.
1. Get your MCP Secret Key (Optional for Demo)
Sign in to your SnappySnag Dashboard.
Open Project Settings (gear icon) -> Integrations or MCP tab.
Click Generate MCP Secret Key and copy your key (
snag_mcp_...).
2. Configure Your AI Editor
🔹 Option A: Command / stdio (npx or local build)
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"snappysnag": {
"command": "node",
"args": ["path/to/snappy-snag-mcp/dist/index.js", "--key=YOUR_MCP_SECRET_KEY"]
}
}
}(Tip: Omit --key or set --key=demo to test with demo data!)
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"snappysnag": {
"command": "node",
"args": ["path/to/snappy-snag-mcp/dist/index.js", "--key=YOUR_MCP_SECRET_KEY"]
}
}
}🔹 Option B: Streamable HTTP (Remote SSE)
Cursor (.cursor/mcp.json)
{
"mcpServers": {
"snappysnag": {
"url": "https://snappysnag.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_SECRET_KEY"
}
}
}
}Windsurf (~/.codeium/windsurf/mcp_config.json)
{
"mcpServers": {
"snappysnag": {
"serverUrl": "https://snappysnag.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_SECRET_KEY"
}
}
}
}💡 Example Prompt Workflow
Once connected, you can instruct your AI assistant naturally:
"Check the latest open bug report from SnappySnag and fix the issue."
The AI agent will:
Call
get_latest_feedback(status: "open")to inspect the reported screen, pin position, and device specs.Read the referenced Flutter widget file in your repository.
Apply the necessary code fix or layout adjustment.
Call
update_feedback_status(feedback_id: "...", status: "resolved", comment: "Fixed overflow in ProductCard layout").
🔒 Security & Privacy
Per-Project Scoped Keys: Each MCP Secret Key is strictly scoped to its designated project.
Instant Revocation: If compromised, keys can be regenerated or revoked with a single click in the dashboard.
Encrypted Transmission: All data and screenshot assets are delivered via HTTPS with short-lived signed URLs.
📚 Resources & Links
SnappySnag Official Site: https://snappysnag.com
Flutter SDK (
snappy_snag): pub.dev/packages/snappy_snagModel Context Protocol (Anthropic): modelcontextprotocol.io
📄 License
This repository is licensed under the MIT License.
Available Tools
4 toolsget_feedback_detailAInspect
Fetch the full details of a specific feedback item by its ID, including active pin annotations, Flutter widget hierarchy, developer notes, AI fix prompt, and screenshot image.
Inputs: feedback_id (required), include_screenshot.
get_latest_feedbackAInspect
Fetch the most recent in-app bug report or user feedback from SnappySnag, including screenshot, visual pin annotations, screen name, device metadata, and AI fix prompts.
Inputs: status, include_screenshot.
list_feedbacksAInspect
List and search feedback / bug reports in the SnappySnag project. Returns lightweight summaries (ID, title, status, severity, active pin count, screen category, created_at).
Inputs: limit, source, status, keyword, +1 more.
update_feedback_statusAInspect
Update the status of a feedback ticket (e.g., mark as 'resolved' after fixing the bug in your codebase, or 'ignored'), and optionally attach an internal developer resolution note.
Inputs: status (required), feedback_id (required), comment.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct retrieval/update mode: latest item, searchable list, ID-based detail, and status update. There is slight overlap because get_latest_feedback returns rich detail similar to get_feedback_detail, but the lack of an ID requirement makes the latest tool's purpose clear.
All names follow a readable verb_noun snake_case pattern (get/list/update + feedback noun). Minor pluralization inconsistency appears between 'feedbacks' and 'feedback', but the pattern remains predictable.
Four tools is well-scoped for a focused feedback triage server. Each tool covers a meaningful part of the read/update workflow without redundant operations.
The surface covers listing/searching, retrieving latest and detailed feedback, and updating status with notes, which supports the core bug-report triage lifecycle. Minor gaps like bulk status updates, assignment, or editing severity/title are not present but can be worked around.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Enable secure connectivity between Sentry issues and debugging data, and LLM clients, using a Model Context Protocol (MCP) server.
A Model Context Protocol server for Wix AI tools
MCP server for Sentry - error monitoring, issue tracking, and debugging for AI assistants
Related MCP Servers
- AlicenseCqualityDmaintenanceA distributable Model Context Protocol (MCP) server that exposes Dart SDK commands for AI-powered development. This server bridges the gap between AI coding assistants and Dart/Flutter development workflows by implementing the Model Context Protocol (MCP).106MIT
- AlicenseBqualityDmaintenanceAn educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.1162MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server designed to easily dump your codebase context into Large Language Models (LLMs).18 npm3Apache 2.0
- AlicenseDqualityDmaintenanceA foundation for building custom local Model Context Protocol (MCP) servers that provide tools accessible to AI assistants like Cursor or Claude Desktop.137MIT