HTTP Toolkit Server [![Travis Build Status](]( [![Version](](
Last updated 8 days ago by pimterry .
AGPL-3.0-or-later · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install httptoolkit-server 
SYNC missed versions from official npm registry.

HTTP Toolkit Server Travis Build Status Version

This repo contains the backend for HTTP Toolkit, a beautiful, cross-platform & open-source HTTP(S) debugging proxy, analyzer & client.

Looking to file bugs, request features or send feedback? File an issue or vote on existing ones at

What is this?

HTTP Toolkit runs everything possible within the web UI, written as a standard single-page web application. There's a couple of necessary things you can't do in a web application though, especially:

  • Start a locally running proxy server (here using Mockttp)
  • Launch local applications preconfigured for interception

This server exposes an API that used by the web UI, exposing these actions and some other related information. The API itself is GraphQL, see src/httptoolkit-server.ts for the full details.

This server is runnable standalone as a CLI using oclif, or can be imported into other modules to be run programmatically. The available interceptors are defined in src/interceptors, and some of these also use other services in here, e.g. src/cert-check-server.ts automatically checks if a certificate is trusted by a browser client, and downloads or installs (depending on the client) the certificate if not.

Note that the set of interceptors available in HTTP Toolkit depends on both the interceptors available on your server and the interceptors defined in the UI - new interceptors will need to be added to both.

This server is typically used by users via httptoolkit-desktop, which builds the server and web UI into an electron application, and starts & stops the server in the background whenever that app is run. Each time the desktop app is built, a new electron app is created containing the latest release from this repo.

Once the server has installed it automatically updates in the background periodically, pulling new releases from the github releases of this repo.


If you want to add new interceptors, change/fix existing interceptor behaviour (but not their UI) or reconfigure how the underlying proxy server is set up, then you're in the right place :+1:.

To get started:

  • Clone this repo.
  • npm install
  • npm start
  • A Mockttp standalone server will start on port 45456, and a graphql management server on 45457.
  • Either make requests to the servers by hand, or start a UI using it by:

A few tips:

  • Setting playground: true at the bottom of src/httptoolkit-server.ts will give you a GraphQL playground on http://localhost:45457.
  • New interceptors need to be added to src/interceptors/index.ts. They will also need to be added to the UI.
  • The tests assume that the required applications are installed to run every interceptor. See .travis.yml for an example of how to set this up.

Current Tags

  • 0.1.8                                ...           latest (8 days ago)

17 Versions

  • 0.1.8                                ...           8 days ago
  • 0.1.7                                ...           a month ago
  • 0.1.6                                ...           2 months ago
  • 0.1.5                                ...           3 months ago
  • 0.1.4                                ...           3 months ago
  • 0.1.3                                ...           3 months ago
  • 0.1.2                                ...           3 months ago
  • 0.1.1                                ...           3 months ago
  • 0.1.0                                ...           4 months ago
  • 0.0.8                                ...           4 months ago
  • 0.0.7                                ...           5 months ago
  • 0.0.6                                ...           5 months ago
  • 0.0.5                                ...           5 months ago
  • 0.0.4                                ...           5 months ago
  • 0.0.3                                ...           5 months ago
  • 0.0.2                                ...           5 months ago
  • 0.0.1                                ...           5 months ago
Maintainers (1)
Today 0
This Week 0
This Month 34
Last Day 0
Last Week 18
Last Month 31
Dependencies (18)
Dev Dependencies (20)
Dependents (0)

Copyright 2014 - 2016 © |