> For the complete documentation index, see [llms.txt](https://docs.luciq.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server.md). # Luciq MCP Server ### Your production data, in your IDE, in seconds. The **Luciq MCP Server** gives your AI coding assistant direct access to your mobile app's crash data, performance metrics, bug reports, app hangs, surveys, and user reviews. Query your production data using natural language, without leaving your editor. {% hint style="success" %} **Available on all plans.** MCP is enabled for every Luciq customer - no extra setup, no feature flags, no waiting. Just connect your IDE and start querying. {% endhint %} **18 tools across 9 areas.** Crashes, crash diagnostics, occurrences, app hangs, performance (APM), bug reports, app store reviews, surveys, and an aggregated app-health overview - all accessible through natural language prompts: > "Show me the top crashes in production this week"\ > "Help me fix crash #42 - give me the full diagnostics"\ > "List my worst app launches this release"\ > "Triage bug #51: set it to Major and close it"\ > "Show me 1-star reviews for the latest release" **Works with your IDE.** Cursor, Claude Code, Claude Desktop, VS Code / GitHub Copilot, Windsurf, JetBrains, and any MCP-compatible client. *** ### Demo {% embed url="" %} *** ### What is MCP? [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) is an open standard for connecting AI tools to external data sources. It lets your IDE's AI assistant fetch real data from services like Luciq using structured, secure API calls. Luciq's MCP Server is the **first and only MCP integration purpose-built for mobile observability**. While general-purpose observability tools retrofit MCP support for web and backend data, Luciq's server is designed from the ground up for mobile: crash frames, device state, session context, performance metrics, app hangs, surveys, and app store reviews. ### Why Luciq MCP? * **Mobile-native.** 18 tools designed for how mobile developers actually debug * **Standardized.** Works across all MCP-compatible IDEs with zero custom SDKs * **Secure.** OAuth 2.0, RBAC, audit logging, no source code required. Read-only by default, with one permissioned write tool for bug triage * **Simple.** One URL, one-click OAuth, done *** ### Tools at a Glance | Domain | Tool | What It Does | | ---------------- | ------------------------- | ------------------------------------------------------------------------------ | | **Applications** | `list_applications` | List all apps in your workspace | | **Crashes** | `list_crashes` | Query crash reports with filters (time, version, device, status, feature flag) | | **Crashes** | `crash_details` | Full crash info with stack trace and metadata | | **Crashes** | `crash_patterns` | Crash distribution by device, OS, app version | | **Crashes** | `crash_diagnostics` | Full debugging payload for one crash (stack, metrics, flows) | | **Occurrences** | `list_occurrences_tokens` | List individual crash instances | | **Occurrences** | `get_occurrence_details` | Deep-dive into a single crash session | | **App Hangs** | `list_app_hangs` | UI freeze and hang reports | | **Performance** | `apm_list_groups` | Rank APM groups worst-first (network, launch, screens, flows) | | **Performance** | `apm_group_view` | Panels for a single APM group (charts, tables, summary) | | **Performance** | `apm_occurrence` | Individual APM occurrences (worst, by token, or list) | | **Bugs** | `list_bugs` | User-reported bug reports via the Luciq SDK | | **Bugs** | `bug_details` | Full bug detail with logs and device context | | **Bugs** | `update_bug` | Triage a bug: status, priority, tags, or mark duplicate (write) | | **Reviews** | `list_reviews` | App store reviews and ratings | | **Surveys** | `list_surveys` | In-app surveys, NPS, and app-store prompts | | **Surveys** | `survey_details` | A survey's questions, stats, and individual responses | | **App Health** | `app_insights` | Aggregated cross-product health snapshot for one app | *** ### Get Started **New to MCP?** Start with the [Getting Started](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/getting-started.md) guide - you'll be connected in under two minutes. **Ready to connect your IDE?** Jump straight to [Setup by IDE](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/setup-by-ide.md) for Cursor, Claude Code, VS Code, and more. *** ### Explore * [**Getting Started**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/getting-started.md) - Connect in under 2 minutes * [**Setup by IDE**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/setup-by-ide.md) - Cursor, Claude Code, VS Code, Claude Desktop, Windsurf, JetBrains * [**Authentication & Security**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/authentication-and-security.md) - OAuth, tokens, permissions, and security details * [**Tools Reference**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/mcp-tools-reference.md) - All 18 tools with parameters, prompts, and response fields * [**Use Cases & Workflows**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/use-cases-and-workflows.md) - Real-world debugging workflows with prompt sequences * [**FAQ & Troubleshooting**](/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server/faq-and-troubleshooting.md) - Common issues and how to resolve them --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.luciq.ai/product-guides-and-integrations/product-guides/ai-features/luciq-mcp-server.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.