# 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, bug reports, app hangs, 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 %}

**10 tools across 5 domains.** Crashes, occurrences, app hangs, bug reports, and app store reviews - all accessible through natural language prompts:

> "Show me the top crashes in production this week"\
> "Get details for crash #42 - what's the stack trace?"\
> "Are there app hangs on Samsung devices?"\
> "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="<https://streamable.com/ekvoh8>" %}

***

### 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, app hangs, and app store reviews.

### Why Luciq MCP?

* **Mobile-native.** 10 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, read-only access, no source code required
* **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) |
| **Crashes**      | `crash_details`          | Full crash info with stack trace and metadata                    |
| **Crashes**      | `crash_patterns`         | Crash distribution by device, OS, app version                    |
| **Occurrences**  | `list_occurrence_tokens` | List individual crash instances                                  |
| **Occurrences**  | `get_occurrence_details` | Deep-dive into a single crash session                            |
| **App Hangs**    | `list_application_hangs` | UI freeze and hang reports                                       |
| **Bugs**         | `list_bugs`              | User-reported bug reports via the Luciq SDK                      |
| **Bugs**         | `bug_details`            | Full bug detail with logs and device context                     |
| **Reviews**      | `list_reviews`           | App store reviews and ratings                                    |

***

### 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 10 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: 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=<question>
```

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.
