Skip to content
pubscout

interceptly

2.3.2, released 3 weeks ago by stormx.dev

Client-agnostic network and WebSocket inspector for Flutter with overlay UI, replay, and MCP export

$ flutter pub add interceptly
Source repository

What it does

Intercepts and inspects HTTP and WebSocket traffic directly inside Flutter applications using an on-screen overlay UI. It offloads body parsing and serialization to background isolates and provides network simulation, HAR/cURL export, and Postman-style request replaying. It also exposes VM service extensions to connect with AI coding assistants via the Model Context Protocol (MCP).

AI-written summary of version 2.3.2, based on the package's README and metadata. Report an inaccuracy

Use it when

  • Debugging HTTP requests, GraphQL queries, or WebSocket frames directly on device or in simulators
  • Simulating offline or throttled network profiles (e.g., Slow 3G) inside your Flutter app
  • Inspecting app traffic using AI coding agents through Model Context Protocol (MCP)

Skip it when

  • Production builds where you do not want inspection overhead or potential data leakage
  • Apps looking for built-in HTTP client functionality without adding dedicated adapter packages

Strengths

  • Client-agnostic design with modular adapters for Dio, http, Chopper, and WebSocket packages
  • Uses background isolates and hybrid storage to avoid UI frame drops on large payloads
  • Supports live bidirectional WebSocket frame inspection with ring-buffering and throttling

Weaknesses

  • Requires installing and maintaining satellite adapter packages (e.g., interceptly_dio) to hook into client traffic
  • Documented platform support is currently limited to Android and iOS

Setup

Kind
Plugin (native code)
Effort
Low
Code generation
No
Direct dependencies
2

Requires passing the app's NavigatorState GlobalKey to Interceptly.init and attaching the relevant adapter to your HTTP or WebSocket client.

import 'package:flutter/material.dart';
import 'package:interceptly/interceptly.dart';

final _navKey = GlobalKey<NavigatorState>();

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  runApp(MaterialApp(navigatorKey: _navKey, home: const Scaffold()));

  Interceptly.init(
    navigatorKey: _navKey,
    showFloatingButton: true,
  );
}

Alternatives

Packages that do the same job and could replace interceptly.

  • thunder

    Flutter debug overlay for real-time inspection of HTTP requests and WebSockets.

  • api_studio

    In-app network inspector for Dio, http, and custom requests with redaction, edit & replay, and exports.

  • ispect

    In-app observability and QA diagnostics toolkit with logs, network tracing, and layout inspection.

  • datadog_session_replay

    Integrates Datadog Session Replay into Flutter apps via FFI.

Works with

Packages commonly used together with interceptly: ones it builds on, ones built on it, and its own family.