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
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.
74Compare - api_studio
In-app network inspector for Dio, http, and custom requests with redaction, edit & replay, and exports.
70Compare - ispect
In-app observability and QA diagnostics toolkit with logs, network tracing, and layout inspection.
84Compare - datadog_session_replay
Integrates Datadog Session Replay into Flutter apps via FFI.
78Compare
Works with
Packages commonly used together with interceptly: ones it builds on, ones built on it, and its own family.