WormaCeptor MCP server

WormaCeptor

Your AI agent can read your code. Now it can read your running Android app. WormaCeptor puts network traffic, crashes, logs, databases and preferences one tool call away for Claude Code, Cursor and other MCP clients, and on screen for you. No proxy, no certificates. Ships only in debug builds through Gradle's debugImplementation, so nothing reaches production. Set up the agent in two lines.

Demo

An agent finds and fixes a failing checkout by reading the app's network traffic through WormaCeptor:

Network inspection, system tools, and performance monitoring side by side:

Watch the demo video

Quick Start

Make sure mavenCentral() is declared in your settings.gradle.kts (it's in the default Android template):

dependencyResolutionManagement {
    repositories {
        mavenCentral()
    }
}

Add the dependencies in your app's build.gradle.kts:

<!-- x-release-please-start-version -->

dependencies {
    implementation("com.azikar24.wormaceptor:wormaceptor-client:3.4.2")
    debugImplementation("com.azikar24.wormaceptor:wormaceptor-persistence:3.4.2")
}

<!-- x-release-please-end -->

Initialize in your Application class:

import com.azikar24.wormaceptor.api.WormaCeptorApi

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        WormaCeptorApi.init(this)
    }
}

Add the interceptor to your OkHttp client:

import com.azikar24.wormaceptor.api.WormaCeptorInterceptor

val client = OkHttpClient.Builder()
    .addInterceptor(WormaCeptorInterceptor())
    .build()

Open WormaCeptor from anywhere:

startActivity(WormaCeptorApi.getLaunchIntent(context))

You can also enable the shake gesture with WormaCeptorApi.startActivityOnShake(activity). Using Ktor? See the Ktor guide.

Features

Network: Intercept HTTP/HTTPS via OkHttp or Ktor, monitor WebSocket connections and WebView requests, copy URLs or export as cURL, JSON and HAR, throttle with the rate limiter, and mock responses with Mock Rules (turn any captured request into a mock with Add to Mock)

Performance: Track FPS, memory, and CPU in real time with a live overlay, catch memory leaks and StrictMode thread violations, spot excessive Compose recompositions

Shortened. The full README is on GitHub.