JADX-AI-MCP

https://github.com/zinja-coder/jadx-ai-mcp
Admin
JADX-AI-MCP is an MCP server and JADX plugin that enables LLMs like Claude to analyze Android APKs...
Tokens:77,897
Snippets:709
Trust Score:9.1
License:Apache-2.0
Update:3 weeks ago
Show doc for...
Tokens:
Raw
### Quick start commands

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/index.md

Commands to install the plugin and run the MCP server in stdio mode. The server is started from the jadx-mcp-server directory using uv.

```bash
# Install plugin
jadx plugins --install "github:zinja-coder:jadx-ai-mcp"

# Run MCP server (stdio mode)
cd jadx-mcp-server
uv run jadx_mcp_server.py
```

--------------------------------

### Install as a tool with uv

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/installation.md

Optional installation as a tool.

```bash
uv tool install git+https://github.com/zinja-coder/jadx-mcp-server
```

--------------------------------

### Package tree response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Example JSON response from the GET /package-tree endpoint. Shows the structure with total_classes, total_packages, and a packages array containing name, class_count, and is_likely_library fields.

```json
{
  "total_classes": 1200,
  "total_packages": 45,
  "packages": [
    { "name": "com.example.app", "class_count": 310, "is_likely_library": false },
    { "name": "androidx.core", "class_count": 88, "is_likely_library": true }
  ]
}
```

--------------------------------

### Response for GET /main-application-classes-names

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Example JSON response for GET /main-application-classes-names. Contains an array of class objects with name fields.

```json
{
  "classes": [ { "name": "com.example.app.Main" }, ... ]
}
```

--------------------------------

### Clone repository and install jadx jar with mvn install:install-file

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/CONTRIBUTING.md

Clone the repository, create a feature branch, and install the jadx jar into the local Maven repository using the mvn install:install-file command. The example shows both a generic path and a concrete version (jadx-1.5.1-all.jar).

```bash
git clone https://github.com/your-username/jadx-ai-mcp.git
# or
git clone https://github.com/your-username/jadx-mcp-server.git

# Create a new branch
git checkout -b your-feature-branch

# Add jadx jar file as dependecy in your local maven repository
mvn install:install-file -Dfile=path/to/jadx-<version>-all.jar \
                      -DgroupId=io.github.skylot \
                      -DartifactId=jadx-all \
                      -Dversion=<version> \
                      -Dpackaging=jar

# For example
mvn install:install-file -Dfile=lib/jadx-1.5.1-all.jar \
                      -DgroupId=io.github.skylot \
                      -DartifactId=jadx-all \
                      -Dversion=1.5.1 \
                      -Dpackaging=jar

```

--------------------------------

### Response for GET /main-activity

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Example JSON response for GET /main-activity. Contains the main activity class name, type, and decompiled source content.

```json
{
  "name": "com.example.MainActivity",
  "type": "code/java",
  "content": "package com.example;..."
}
```

--------------------------------

### Install JADX plugin via CLI

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/installation.md

Recommended command to install the plugin from GitHub.

```bash
jadx plugins --install "github:zinja-coder:jadx-ai-mcp"
```

--------------------------------

### Start and stop PluginServer on port 8650

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/pluginserver.md

Shows how to create and run a PluginServer from any code holding a MainWindow. start() binds http://127.0.0.1:8650/, isRunning() returns true after a successful start, getPort() returns 8650, and stop() shuts it down.

```java
MainWindow window = ...;                       // from JadxPluginContext
PluginServer server = new PluginServer(window, 8650);
server.start();                                // binds http://127.0.0.1:8650/

boolean up = server.isRunning();               // true after successful start
int p = server.getPort();                      // 8650

server.stop();
```

--------------------------------

### Example xrefs-to-class JSON response

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/xrefsroutes.md

Example JSON response from GET /xrefs-to-class with offset=0 and count=2. Shows the references array and pagination metadata.

```json
// GET /xrefs-to-class?class_name=com.example.CryptoHelper&offset=0&count=2
{
  "type": "xrefs",
  "references": [
    { "class": "com.example.MainActivity", "method": "onCreate" },
    { "class": "com.example.ApiClient", "method": "" }
  ],
  "requested_count": 2,
  "pagination": {
    "total": 7, "offset": 0, "limit": 2, "count": 2, "has_more": true,
    "next_offset": 2, "current_page": 1, "total_pages": 4, "page_size": 2
  }
}
```

--------------------------------

### Configure MCP client for tool install

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/installation.md

JSON configuration when installed as a tool.

```json
{
  "mcpServers": {
    "jadx-mcp-server": {
      "command": "jadx_mcp_server"
    }
  }
}
```

--------------------------------

### Usage examples for /method-by-name and /search-method

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/methodroutes.md

Usage examples for the two endpoints: fetching a method by name, disambiguating an overload with a descriptor, and performing a global method search.

```bash
# Fetch a method, including search in all classes when the class is unknown
curl "http://127.0.0.1:8650/method-by-name?method_name=onCreate&class_name=com.example.MainActivity"

# Disambiguate an overload by descriptor
curl "http://127.0.0.1:8650/method-by-name?method_name=load&class_name=com.example.Parser&method_signature=%28Landroid/content/Context;%29V"

# Global method search (returns class names as text)
curl "http://127.0.0.1:8650/search-method?method_name=encrypt"
```

--------------------------------

### Example cache-stats JSON

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/decompilationcache.md

Example JSON output from GET /cache-stats. Shows the statistics fields and their format.

```json
{
  "cached_classes": 320,
  "hits": 4100,
  "misses": 640,
  "hit_rate": "86.5%",
  "compressed_bytes": 1234567,
  "compressed_mb": "1.2",
  "original_bytes": 9876543,
  "original_mb": "9.4",
  "compression_ratio": "8.0x"
}
```

--------------------------------

### Set up jadx-mcp-server with uv

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/README.md

Sets up the jadx-mcp-server: navigates into the directory, installs uv, optionally creates a virtual environment, and installs the required dependencies (httpx and fastmcp).

```bash
# 3. Navigate to jadx-mcp-server directory
cd jadx-mcp-server

# 4. This project uses uv - https://github.com/astral-sh/uv instead of pip for dependency management.
    ## a. Install uv (if you dont have it yet)
curl -LsSf https://astral.sh/uv/install.sh | sh
    ## b. OPTIONAL, if for any reasons, you get dependecy errors in jadx-mcp-server, Set up the environment
uv venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
    ## c. OPTIONAL Install dependencies
uv pip install httpx fastmcp
```

--------------------------------

### GUI method for installing jadx-ai-mcp plugin

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/README.md

Placeholder comment for the GUI installation method; the actual steps are shown in the images that follow.

```bash
## 3. GUI method, download the .jar file and follow below steps shown in images
```

--------------------------------

### Main application class code item example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Example item returned by the GET /main-application-classes-code endpoint. Each item contains the class name, type "code/java", and the decompiled source content. The content may be a placeholder if decompilation fails.

```json
{ "name": "com.example.app.Main", "type": "code/java", "content": "package com.example.app;..." }
```

--------------------------------

### Download and install jadx-ai-mcp plugin

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/README.md

Downloads the release files, unzips the server archive, and installs the jadx-ai-mcp plugin either via the one-liner `jadx plugins --install` command or through JADX-GUI (images referenced).

```bash
# 0. Download the jadx-ai-mcp-<version>.jar and jadx-mcp-server-<version>.zip
https://github.com/zinja-coder/jadx-ai-mcp/releases

# 1. 
unzip jadx-ai-mcp-<version>.zip

├jadx-mcp-server/
  ├── jadx_mcp.py
  ├── requirements.txt
  ├── README.md
  ├── LICENSE

├jadx-ai-mcp-<version>.jar

# 2. Install the plugin

# For this you can follow two approaches:

## 1. One liner - execute below command in your shell
jadx plugins --install "github:zinja-coder:jadx-ai-mcp"

## The above one line code will install the latest version of the plugin directly into the jadx, no need to download the jadx-ai-mcp's .jar file.
## 2. Or you can use JADX-GUI to install it by following images as shown below:
```

--------------------------------

### Install dependencies with uv pip install

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/troubleshooting.md

Install Python dependencies using uv to resolve 'ModuleNotFoundError: No module named 'fastmcp''. Recommended over manual installation.

```bash
uv pip install -r requirements.txt
```

--------------------------------

### start() method signature

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/pluginserver.md

Starts the embedded Javalin server, closes any existing server socket, and registers routes.

```java
public void start()
```

--------------------------------

### Example response body for /search-method

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/methodroutes.md

Example response body for /search-method: a newline-delimited list of class names.

```text
com.example.A
com.example.B
androidx.core.internal.InternalA
```

--------------------------------

### Rename package response JSON example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/refactoringroutes.md

Example JSON response for the /rename-package endpoint, showing the count of renamed classes, total classes, and any errors encountered.

```json
{ "renamed": 3, "total": 5, "errors": [ "Failed to rename com.a.B: ..." ] }
```

--------------------------------

### Search usage examples

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/user-guide.md

Examples of using search_classes_by_keyword with different search terms and scopes. The default search_in is 'code'.

```text
search_classes_by_keyword(search_term="password", search_in="code")
```

```text
search_classes_by_keyword(search_term="retrofit", search_in="class,method")
```

```text
search_classes_by_keyword(search_term="token", package="com.example.auth", search_in="field,code")
```

--------------------------------

### Example response for /method-by-name

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/methodroutes.md

Example JSON response for /method-by-name. decl is String.valueOf(method.getCodeNodeRef()); code is method.getCodeStr() or an error message when decompilation fails.

```json
{
  "class_name": "com.example.App",
  "method_name": "foo",
  "decl": "nodeRef(...)",
  "code": "public void foo() { ... }"
}
```

--------------------------------

### Sample JSON response for /manifest

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/resourceroutes.md

Example response returned with HTTP 200 for the /manifest endpoint.

```json
{
  "name": "AndroidManifest.xml",
  "type": "manifest/xml",
  "content": "<?xml version=\"1.0\" ...>"
}
```

--------------------------------

### Cache clear response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Example JSON response from the POST /cache-clear endpoint. Contains a status field set to "cleared" and a stats object with the fresh cache statistics.

```json
{ "status": "cleared", "stats": { ... } }
```

--------------------------------

### Text resource response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/resourceroutes.md

Shows the JSON structure when the requested resource is text-decodable.

```json
{
  "type": "resource/text",
  "file": { "file_name": "res/layout/activity_main.xml", "content": "...xml..." }
}
```

--------------------------------

### Xrefs response item example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/xrefsroutes.md

Example item shape returned by the cross-reference handlers. For class-level references, the method field is an empty string.

```json
{ "class": "com.example.Caller", "method": "run" }
```

--------------------------------

### Start JADX MCP server with --jadx-port and --jadx-host

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/troubleshooting.md

Start the Python MCP server for local or remote JADX connections. Use the local command when JADX runs on the same machine; use the remote command with the JADX host IP address for remote instances. Ensure the port matches the plugin configuration.

```bash
uv run jadx_mcp_server.py --jadx-port 8650
```

```bash
uv run jadx_mcp_server.py --jadx-host IP_ADDRESS --jadx-port 8650
```

--------------------------------

### getProgress() JSON response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/searchprogresstracker.md

Example JSON response from getProgress(). Additional fields include "error" (only when state is failed) and "stale": true (only when state is running and elapsed exceeds 15 minutes). State values are lowercase enum names; search_id is empty when there is no search.

```json
{
  "search_id": "d2f8...",
  "state": "running",
  "operation_type": "code",
  "scanned": 512,
  "total": 2048,
  "matches": 3,
  "elapsed_ms": 1450
}
```

--------------------------------

### Validate server startup with help flag

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/installation.md

Run the server with --help to verify it starts correctly.

```bash
uv run jadx_mcp_server.py --help
```

--------------------------------

### Set Up Python Server Development Environment

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/contributing.md

Creates a virtual environment with uv, activates it, and installs the server package in editable mode. Requires Python 3.10+ and uv.

```bash
cd jadx-mcp-server

# Create venv
uv venv
source .venv/bin/activate

# Install editable
uv pip install -e .
```

--------------------------------

### Handle PluginServer.start() RuntimeException

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/pluginserver.md

Demonstrates handling startup failures from start(). It rethrows RuntimeException when the port is already bound or route registration fails; e.getCause() carries the original exception.

```java
// start() rethrows startup failures so callers can react:
PluginServer server = new PluginServer(window, 8650);
try {
    server.start();
} catch (RuntimeException e) {
    // port already bound, or route registration failed
    // e.getCause() carries the original exception
}
```

--------------------------------

### Response for GET /current-class

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Example JSON response for GET /current-class. The name is the active tab title with .java stripped, or "unknown" when no tab is selected; content is the JTextArea text (blank when none).

```json
{
  "name": "com.example.MainActivity",
  "type": "code/java",
  "content": "package com.example;\n...full source..."
}
```

--------------------------------

### GET /rename-package

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/refactoringroutes.md

Renames a package and all classes within it. For each class whose full name starts with the old package name, a NodeRenamedByUser event is sent with the new fully qualified name. Per-class failures are collected and reported.

```APIDOC
## GET /rename-package

### Description
Renames a package and all classes within it. For each class whose full name starts with the old package name, a NodeRenamedByUser event is sent with the new fully qualified name. Per-class failures are collected and reported.

### Method
GET

### Endpoint
/rename-package

### Parameters
#### Query Parameters
- **old_package_name** (string) - Required - The current package name.
- **new_package_name** (string) - Required - The new package name.

### Response
#### Success Response (200)
- **renamed** (integer) - Number of classes successfully renamed.
- **total** (integer) - Total number of classes processed.
- **errors** (array of strings) - List of per-class failure messages.

#### Response Example
{
  "renamed": 3,
  "total": 5,
  "errors": [
    "Failed to rename com.a.B: ..."
  ]
}

#### Error Responses
- **400** - Missing required parameters.
- **500** - Internal error.
```

--------------------------------

### init(JadxPluginContext) method signature

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/jadxaimcp.md

Initializes the plugin with the given context. Handles headless mode, cleans up previous instances, loads port preferences, creates the menu, and schedules server start.

```java
@Override
public void init(JadxPluginContext context)
```

--------------------------------

### Wiring up PluginMenu in JadxAIMCP.init()

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/pluginmenu.md

Shows how the menu is created and populated inside JadxAIMCP.init(). Creates a new PluginMenu with the main window and the plugin instance, then calls addMenuItems().

```java
// Inside JadxAIMCP.init(JadxPluginContext context):
this.pluginMenu = new PluginMenu(mainWindow, this);
this.pluginMenu.addMenuItems();
```

--------------------------------

### Clone and prepare MCP server

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/installation.md

Clone the repository and check UV version.

```bash
git clone https://github.com/zinja-coder/jadx-ai-mcp.git
cd jadx-ai-mcp/jadx-mcp-server
uv --version
```

--------------------------------

### Variables JSON response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/debugroutes.md

Example HTTP 200 JSON response for the variables endpoint.

```json
{
  "registers": [
    { "name": "r0", "value": "...", "type": "...", "typeId": 1, "updated": true, "children": [ ... ] }
  ],
  "thisObject": [ ... ]
}
```

--------------------------------

### Initial triage prompt

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/user-guide.md

Use this prompt to get package tree, main activity, and main application class names, then summarize likely entry points and sensitive modules.

```text
Get package tree, main activity, and main application class names.
Then summarize likely entry points and sensitive modules.
```

--------------------------------

### Threads JSON response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/debugroutes.md

Example HTTP 200 JSON response for the threads endpoint.

```json
{
  "threads": [ "main", "JIT compiled code", "..." ],
  "selectedThread": "main",
  "count": 5
}
```

--------------------------------

### Stack frames JSON response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/debugroutes.md

Example HTTP 200 JSON response for the stack-frames endpoint.

```json
{
  "stackFrames": [ "com.example.MainActivity.onCreate(MainActivity.java:42)", "..." ],
  "count": 12
}
```

--------------------------------

### Binary resource response example

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/resourceroutes.md

Returns an empty content string with a note when the resource is binary or not text-decodable.

```json
{
  "type": "resource/binary",
  "file": {
    "file_name": "res/drawable/logo.png",
    "content": "",
    "note": "Matched resource is not text-decodable by JADX"
  }
}
```

--------------------------------

### Map entry-points

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/examples.md

Retrieves the package tree, main activity class, and main application class names to identify entry points.

```python
pkg_tree = await get_package_tree()
main = await get_main_activity_class()
app_classes = await get_main_application_classes_names()
```

--------------------------------

### Clone and Build Java Plugin

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/contributing.md

Clones the repository, builds the plugin with Gradle, and installs the resulting JAR to the local JADX plugins directory. Requires JDK 11+ and Gradle.

```bash
git clone https://github.com/zinja-coder/jadx-ai-mcp.git
cd jadx-ai-mcp

# Build plugin
./gradlew build

# Install locally
cp build/libs/jadx-ai-mcp-*.jar ~/.jadx/plugins/
```

--------------------------------

### GET /cache-stats

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Returns the decompilation cache statistics.

```APIDOC
## GET /cache-stats

### Description
Returns the decompilation cache statistics.

### Method
GET

### Endpoint
/cache-stats

### Response
#### Success Response (200)
- **stats** (object) - The decompilation cache stats map. See DecompilationCache for the shape.

#### Response Example
```json
{
  "stats": { }
}
```
```

--------------------------------

### get_smali_of_class(class_name: str)

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/api-reference.md

Gets smali for a class.

```APIDOC
## get_smali_of_class(class_name: str)

### Description
Gets smali for a class.

### Method
MCP Tool

### Endpoint
get_smali_of_class

### Parameters
#### Query Parameters
- **class_name** (string) - Required - The fully qualified class name.

### Response
#### Success Response
- **response** (string) - The smali code.

#### Response Example
{
  "response": ".class public Lcom/example/MainActivity;\n..."
}
```

--------------------------------

### Run MCP server in stdio mode

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/docs/installation.md

Recommended for desktop MCP clients.

```bash
uv run jadx_mcp_server.py
```

--------------------------------

### GET /list-comments

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/commentroutes.md

Lists all comments in a specified Java class.

```APIDOC
## GET /list-comments

### Description
Lists all comments in a specified Java class.

### Method
GET

### Endpoint
/list-comments

### Parameters
#### Query Parameters
- **class_name** (string) - Required - The fully qualified class name (e.g., com.example.MainActivity).

### Request Example
```
curl "http://127.0.0.1:8650/list-comments?class_name=com.example.MainActivity"
```

### Response
#### Success Response (200)
No response body documented.
```

--------------------------------

### Cherry Studio MCP arguments

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/README.md

Arguments for configuring the jadx-mcp-server MCP tool in Cherry Studio. Replace path/to/jadx-mcp-server with the absolute path to where you cloned this repository. The type is stdio and the command is uv.

```bash
--directory
path/to/jadx-mcp-server
run
jadx_mcp_server.py
```

--------------------------------

### GET /search-progress

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Returns the current search progress snapshot from the SearchProgressTracker.

```APIDOC
## GET /search-progress

### Description
Returns the current search progress snapshot from the SearchProgressTracker.

### Method
GET

### Endpoint
/search-progress

### Response
#### Success Response (200)
- **progress** (object) - The current search progress snapshot. See SearchProgressTracker for the JSON shape.

#### Response Example
```json
{
  "progress": { }
}
```
```

--------------------------------

### handleMainActivity method

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Handles GET /main-activity. Returns HTTP 200 JSON with name, type, and content. Parses AndroidManifest.xml with AndroidManifestParser (EnumSet.of(AppAttribute.MAIN_ACTIVITY), using wrapper.getArgs().getSecurity()), then resolves and decompiles the main activity class (cached). Errors: 404 when manifest missing / MAIN_ACTIVITY missing / activity class cannot be resolved; 500 otherwise.

```java
public void handleMainActivity(Context ctx)
```

--------------------------------

### GET /smali-of-class

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Returns the raw smali code for a specified class.

```APIDOC
## GET /smali-of-class

### Description
Returns the raw smali code for a specified class.

### Method
GET

### Endpoint
/smali-of-class

### Parameters
#### Query Parameters
- **class_name** (string) - Required - The full name of the class.

### Response
#### Success Response (200)
Raw smali text from `cls.getSmali()`.

#### Error Responses
- **400** - Missing `class_name`.
- **404** - `{"error": "Class <name> not found."}` via `JadxAIMCPPluginError`.
- **500** - Internal error.
```

--------------------------------

### GET /selected-text

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/endpoints.md

Returns the currently selected text in the active editor tab.

```APIDOC
## GET /selected-text

### Description
Returns the currently selected text in the active editor tab.

### Method
GET

### Endpoint
/selected-text

### Parameters
None.

### Response
#### Success Response (200)
- **selectedText** (string) - The selected text; empty string if nothing selected.

#### Error Response (500)
- **error** (string) - Error message.

#### Response Example
```json
{"selectedText":"<selection>"}
```
```

--------------------------------

### handleMainApplicationClassesNames method

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Handles GET /main-application-classes-names. Returns HTTP 200 JSON with a list of classes. Parses the manifest package attribute and filters wrapper.getDecompiler().getClassesWithInners() by cls.getFullName().startsWith(packageName). Errors: 404 (AndroidManifest.xml not found. / Package name not found in AndroiManifest.xml), 500 otherwise.

```java
public void handleMainApplicationClassesNames(Context ctx)
```

--------------------------------

### GET /current-class

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/endpoints.md

Retrieves the source code of the currently active class in the editor.

```APIDOC
## GET /current-class

### Description
Returns the source code of the currently active class in the editor.

### Method
GET

### Endpoint
/current-class

### Parameters
None.

### Response
#### Success Response (200)
- **name** (string) - Active tab title with `.java` stripped.
- **type** (string) - Always `code/java`.
- **content** (string) - Full text of the active tab's `JTextArea`.

If no tab is selected, returns `{"name":"unknown","type":"code/java","content":""}`.

#### Error Response (500)
- **error** (string) - Error message.

#### Response Example
```json
{"name":"com.example.MainActivity","type":"code/java","content":"<source>"}
```
```

--------------------------------

### Method signature for handleListAllResourceFilesNames

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/resourceroutes.md

Handler for GET /list-all-resource-files-names endpoint. Returns a paginated list of resource file names.

```java
public void handleListAllResourceFilesNames(Context ctx)
```

--------------------------------

### GET /package-tree

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Returns a tree of packages with class counts and library detection.

```APIDOC
## GET /package-tree

### Description
Returns a tree of packages with class counts and library detection.

### Method
GET

### Endpoint
/package-tree

### Response
#### Success Response (200)
- **total_classes** (integer) - Total number of classes.
- **total_packages** (integer) - Total number of packages.
- **packages** (array) - List of package objects:
  - **name** (string) - Package name. Default package reported as `(default)`.
  - **class_count** (integer) - Number of classes in the package.
  - **is_likely_library** (boolean) - Whether the package is likely a library based on prefix matching against `LIBRARY_PREFIXES`.

#### Response Example
```json
{
  "total_classes": 1200,
  "total_packages": 45,
  "packages": [
    { "name": "com.example.app", "class_count": 310, "is_likely_library": false },
    { "name": "androidx.core", "class_count": 88, "is_likely_library": true }
  ]
}
```
```

--------------------------------

### GET /main-application-classes-names

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Returns the names of all classes belonging to the main application package.

```APIDOC
## GET /main-application-classes-names

### Description
Returns the names of all classes belonging to the main application package.

### Method
GET

### Endpoint
/main-application-classes-names

### Response
#### Success Response (200)
- **classes** (array of objects) - Each object has a `name` property with the full class name.

#### Response Example
```json
{
  "classes": [ { "name": "com.example.app.Main" } ]
}
```

#### Error Responses
- **404** - `"AndroidManifest.xml not found."` or `"Package name not found in AndroiManifest.xml"`.
- **500** - Other errors.
```

--------------------------------

### Configure jadx-mcp-server in Claude Desktop

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/README.md

Adds the jadx-mcp-server MCP server configuration to Claude Desktop. Replace path/to/uv with the actual path to your uv executable and path/to/jadx-mcp-server with the absolute path to where you cloned this repository.

```json
{
    "mcpServers": {
        "jadx-mcp-server": {
            "command": "/<path>/<to>/uv", 
            "args": [
                "--directory",
                "</PATH/TO/>jadx-mcp-server/",
                "run",
                "jadx_mcp_server.py"
            ]
        }
    }
}
```

--------------------------------

### GET /all-classes

Source: https://github.com/zinja-coder/jadx-ai-mcp/blob/jadx-ai/_autodocs/api-reference/classroutes.md

Returns a paginated list of all classes included in the decompiled project.

```APIDOC
## GET /all-classes

### Description
Returns a paginated list of all classes included in the decompiled project.

### Method
GET

### Endpoint
/all-classes

### Response
#### Success Response (200)
Paginated response built from `wrapper.getIncludedClassesWithInners()`, using `JavaClass::getFullName` as the transformer, `dataType = "class-list"`, and `itemsKey = "classes"`.

#### Error Responses
- **500** - `"Pagination Error: ..."` when a `PaginationException` occurs.
- **500** - `"Failed to load class list: ..."` for other exceptions.
```
Tokens:
Raw