Skip to content
Back to search

powhttp-mcp

MCP server enabling agents to debug HTTP requests better (using powhttp)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/usestring--powhttp-mcp/badge.svg)](/listings/usestring--powhttp-mcp)

HTML

<a href="/listings/usestring--powhttp-mcp"><img src="/api/listings/usestring--powhttp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install via `go install`:

go install github.com/usestring/powhttp-mcp/cmd/powhttp-mcp@latest

Or install a specific version:

go install github.com/usestring/powhttp-mcp/cmd/powhttp-mcp@v1.0.0

<details> <summary><strong>Don't have Go installed?</strong></summary>

Download and install Go from the official website: [https://go.dev/doc/install](https://go.dev/doc/install)

</details>

<details> <summary><strong>Adding Go binaries to your PATH</strong></summary>

If you get `command not found: powhttp-mcp` after installation, you need to add Go's bin directory to your PATH.

**Find your Go bin directory:**

go env GOPATH

This returns your Go workspace directory, typically `~/go` (macOS/Linux) or `C:\Users\yourname\go` (Windows). The binaries are installed in the `bin` subdirectory.

macOS / Linux

For **bash** (`~/.bashrc` or `~/.bash_profile`):

export PATH="$PATH:$(go env GOPATH)/bin"

For **zsh** (`~/.zshrc`):

export PATH="$PATH:$(go env GOPATH)/bin"

For **fish** (`~/.config/fish/config.fish`):

fish_add_path (go env GOPATH)/bin

Then reload your shell:

source ~/.zshrc  # or ~/.bashrc, etc.

Windows

**PowerShell (current session):**

$env:PATH += ";$(go env GOPATH)\bin"

**Permanently via PowerShell:**

[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$(go env GOPATH)\bin", "User")

**Or via System Settings:** 1. Press `Win + R`, type `sysdm.cpl`, press Enter 2. Go to **Advanced** → **Environment Variables** 3. Under "User variables", select **Path** and click **Edit** 4. Click **New** and add `%USERPROFILE%\go\bin` 5. Click **OK** to save, then restart your terminal

</details>

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 370 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # powhttp-mcp
  2. <p align="center">
  3. <img src="assets/hero.png" alt="powhttp-mcp" width="600">
  4. </p>
  5. <p align="center">
  6. <a href="https://pkg.go.dev/github.com/usestring/powhttp-mcp"><img src="https://pkg.go.dev/badge/github.com/usestring/powhttp-mcp.svg" alt="Go Reference"></a>
  7. <a href="https://github.com/usestring/powhttp-mcp/releases"><img src="https://img.shields.io/github/v/release/usestring/powhttp-mcp" alt="GitHub Release"></a>
  8. <a href="LICENSE"><img src="https://img.shields.io/badge/License-AGPL%20v3-blue.svg" alt="License: AGPL v3"></a>
  9. </p>
  10. <p align="center">
  11. An MCP server that gives AI assistants X-ray vision into HTTP traffic captured by <a href="https://powhttp.com">powhttp</a>.
  12. </p>
  13. ---
  14. ## See it in action
  15. Using `/generate_scraper` to build a BMW car listing monitor:
  16. https://github.com/user-attachments/assets/be098e9d-d700-491c-ae7f-5afb12732728
  17. ---
  18. ## Features
  19. - **HTTP Traffic Analysis** - Search, inspect, and analyze captured HTTP requests/responses
  20. - **Anti-Bot Detection** - Compare browser vs program traffic to identify detection vectors
  21. - **Fingerprinting** - Generate TLS (JA3/JA4) and HTTP/2 fingerprints
  22. - **API Mapping** - Cluster and catalog API endpoints from captured traffic
  23. - **GraphQL Analysis** - Cluster operations, inspect schemas, and extract errors from GraphQL APIs
  24. - **Schema Inference** - Infer merged schemas from multiple response bodies with field statistics
  25. - **Flow Tracing** - Trace related requests (redirects, dependent calls)
  26. - **Schema Validation** - Validate response bodies against Go structs, Zod, or JSON Schema
  27. - **Scraper Generation** - Generate PoC Go scrapers from captured traffic
  28. Schema validation in action - correcting data structures for edge cases:
  29. https://github.com/user-attachments/assets/1156c537-70ab-4179-ad4a-c148988ac503
  30. ---
  31. ## Installation
  32. Install via `go install`:
  33. ```bash
  34. go install github.com/usestring/powhttp-mcp/cmd/powhttp-mcp@latest
  35. ```
  36. Or install a specific version:
  37. ```bash
  38. go install github.com/usestring/powhttp-mcp/cmd/powhttp-mcp@v1.0.0
  39. ```
  40. <details>
  41. <summary><strong>Don't have Go installed?</strong></summary>
  42. Download and install Go from the official website: [https://go.dev/doc/install](https://go.dev/doc/install)
  43. </details>
  44. <details>
  45. <summary><strong>Adding Go binaries to your PATH</strong></summary>
  46. If you get `command not found: powhttp-mcp` after installation, you need to add Go's bin directory to your PATH.
  47. **Find your Go bin directory:**
  48. ```bash
  49. go env GOPATH
  50. ```
  51. This returns your Go workspace directory, typically `~/go` (macOS/Linux) or `C:\Users\yourname\go` (Windows). The binaries are installed in the `bin` subdirectory.
  52. ### macOS / Linux
  53. For **bash** (`~/.bashrc` or `~/.bash_profile`):
  54. ```bash
  55. export PATH="$PATH:$(go env GOPATH)/bin"
  56. ```
  57. For **zsh** (`~/.zshrc`):
  58. ```bash
  59. export PATH="$PATH:$(go env GOPATH)/bin"
  60. ```
  61. For **fish** (`~/.config/fish/config.fish`):
  62. ```fish
  63. fish_add_path (go env GOPATH)/bin
  64. ```
  65. Then reload your shell:
  66. ```bash
  67. source ~/.zshrc # or ~/.bashrc, etc.
  68. ```
  69. ### Windows
  70. **PowerShell (current session):**
  71. ```powershell
  72. $env:PATH += ";$(go env GOPATH)\bin"
  73. ```
  74. **Permanently via PowerShell:**
  75. ```powershell
  76. [Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";$(go env GOPATH)\bin", "User")
  77. ```
  78. **Or via System Settings:**
  79. 1. Press `Win + R`, type `sysdm.cpl`, press Enter
  80. 2. Go to **Advanced** → **Environment Variables**
  81. 3. Under "User variables", select **Path** and click **Edit**
  82. 4. Click **New** and add `%USERPROFILE%\go\bin`
  83. 5. Click **OK** to save, then restart your terminal
  84. </details>
  85. ---
  86. ## Enabling the Data API
  87. Before using powhttp-mcp, you need to enable the Data API in powhttp:
  88. 1. Open **Powhttp Settings** > **Data API**
  89. 2. Make sure the Data API is **running**
  90. 3. (Recommended) Enable **Auto start on app launch** for convenience
  91. 4. Note the **port number** — you'll need this for `POWHTTP_BASE_URL` in your MCP configuration
  92. <p align="center">
  93. <img src="assets/data-api-settings.png" alt="Powhttp Data API Settings" width="600">
  94. </p>
  95. ---
  96. ## Usage
  97. ### Connecting to Cursor
  98. Add to your `.cursor/mcp.json`:
  99. ```json
  100. {
  101. "mcpServers": {
  102. "powhttp": {
  103. "command": "powhttp-mcp",
  104. "env": {
  105. "POWHTTP_BASE_URL": "http://localhost:7777",
  106. "POWHTTP_PROXY_URL": "http://localhost:8888"
  107. }
  108. }
  109. }
  110. }
  111. ```
  112. ### Connecting to Claude Desktop
  113. Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
  114. ```json
  115. {
  116. "mcpServers": {
  117. "powhttp": {
  118. "command": "powhttp-mcp",
  119. "env": {
  120. "POWHTTP_BASE_URL": "http://localhost:7777",
  121. "POWHTTP_PROXY_URL": "http://localhost:8888"
  122. }
  123. }
  124. }
  125. }
  126. ```
  127. ### Connecting to Claude Code
  128. Add using the CLI:
  129. ```bash
  130. claude mcp add powhttp -e POWHTTP_BASE_URL=http://localhost:7777 -e POWHTTP_PROXY_URL=http://localhost:8888 -- powhttp-mcp
  131. ```
  132. The generated scraper running successfully:
  133. https://github.com/user-attachments/assets/52b30cbf-7c66-40b1-a3fe-9c12d37ece11
  134. ---
  135. ## MCP Prompts
  136. powhttp-mcp provides 4 prompts for guided workflows:
  137. | Prompt | Description |
  138. |--------|-------------|
  139. | `base_prompt` | START HERE: Essential guide for efficient tool usage and token optimization |
  140. | `compare_browser_program` | Compare browser vs program traffic to find anti-bot detection differences |
  141. | `build_api_map` | Build an API endpoint catalog from captured traffic |
  142. | `generate_scraper` | Generate PoC Go scrapers from captured traffic |
  143. ---
  144. ## MCP Tools
  145. powhttp-mcp provides 17 tools for HTTP traffic analysis:
  146. | Tool | Description |
  147. |------|-------------|
  148. | `powhttp_sessions_list` | List all sessions with entry counts |
  149. | `powhttp_session_active` | Get the currently active session |
  150. | `powhttp_search_entries` | Search entries with filters and free text |
  151. | `powhttp_get_entry` | Get full details of a specific entry |
  152. | `powhttp_get_tls` | Get TLS handshake events for a connection |
  153. | `powhttp_get_http2_stream` | Get HTTP/2 frame details for a stream |
  154. | `powhttp_fingerprint` | Generate HTTP, TLS, and HTTP/2 fingerprints |
  155. | `powhttp_diff_entries` | Compare two entries to find detection differences |
  156. | `powhttp_extract_endpoints` | Cluster entries into endpoint groups |
  157. | `powhttp_describe_endpoint` | Generate detailed endpoint description |
  158. | `powhttp_trace_flow` | Trace related requests around a seed entry |
  159. | `powhttp_validate_schema` | Validate entry bodies against a schema |
  160. | `powhttp_query_body` | Extract specific fields from bodies using JQ expressions |
  161. | `powhttp_infer_schema` | Infer merged schema from multiple entry bodies with field statistics |
  162. | `powhttp_graphql_operations` | Cluster GraphQL traffic by operation name and type |
  163. | `powhttp_graphql_inspect` | Parse and inspect individual GraphQL operations |
  164. | `powhttp_graphql_errors` | Extract and categorize GraphQL errors from responses |
  165. See [internal/mcp/README.md](internal/mcp/README.md) for detailed tool documentation.
  166. ---
  167. ## Environment Variables
  168. <details>
  169. <summary><strong>Basic Configuration</strong></summary>
  170. | Variable | Description | Default |
  171. |----------|-------------|---------|
  172. | `POWHTTP_BASE_URL` | Where to find the powhttp API server | `http://localhost:7777` |
  173. | `POWHTTP_PROXY_URL` | Proxy URL used by prompts when generating scrapers and debugging | `http://127.0.0.1:8890` |
  174. | `LOG_LEVEL` | How verbose the logs are: `debug`, `info`, `warn`, `error` | `info` |
  175. | `LOG_FILE` | File to write logs to (empty = print to console) | `""` (console) |
  176. </details>
  177. <details>
  178. <summary><strong>Performance Tuning</strong></summary>
  179. | Variable | Description | Default |
  180. |----------|-------------|---------|
  181. | `HTTP_CLIENT_TIMEOUT_MS` | How long to wait for API responses (milliseconds) | `10000` (10s) |
  182. | `FETCH_WORKERS` | How many entries to fetch in parallel | `16` |
  183. | `ENTRY_CACHE_MAX_ITEMS` | How many entries to keep in memory cache | `512` |
  184. | `REFRESH_INTERVAL_MS` | How often to check for new entries (milliseconds) | `2000` (2s) |
  185. | `REFRESH_TIMEOUT_MS` | Max time for index refresh operation (milliseconds) | `15000` (15s) |
  186. | `FRESHNESS_THRESHOLD_MS` | Consider data stale after this many milliseconds | `500` (0.5s) |
  187. </details>
  188. <details>
  189. <summary><strong>Data Limits</strong></summary>
  190. | Variable | Description | Default |
  191. |----------|-------------|---------|
  192. | `TOOL_MAX_BYTES_DEFAULT` | Max response body size tools return (bytes) | `2000000` (2MB) |
  193. | `RESOURCE_MAX_BODY_BYTES` | Max body size for MCP resources (bytes) | `65536` (64KB) |
  194. | `TLS_MAX_EVENTS_DEFAULT` | Max TLS handshake events to return | `200` |
  195. | `H2_MAX_EVENTS_DEFAULT` | Max HTTP/2 frames to return | `200` |
  196. | `BOOTSTRAP_TAIL_LIMIT` | Max entries to load when starting up | `20000` |
  197. </details>
  198. <details>
  199. <summary><strong>AI Token Optimization</strong></summary>
  200. | Variable | Description | Default |
  201. |----------|-------------|---------|
  202. | `COMPACT_MAX_ARRAY_ITEMS` | In compact mode, trim arrays to this many items | `3` |
  203. | `COMPACT_MAX_STRING_LEN` | Truncate strings longer than this (chars) | `500` |
  204. | `COMPACT_MAX_DEPTH` | Max nesting depth for compaction (0 = unlimited) | `0` |
  205. | `DEFAULT_SEARCH_LIMIT` | Default max results for search_entries | `10` |
  206. | `DEFAULT_QUERY_LIMIT` | Default max entries for query_body | `20` |
  207. | `DEFAULT_CLUSTER_LIMIT` | Default max clusters for extract_endpoints | `15` |
  208. | `DEFAULT_EXAMPLES_PER_ITEM` | Default examples shown per cluster | `3` |
  209. </details>
  210. <details>
  211. <summary><strong>Log Rotation</strong></summary>
  212. | Variable | Description | Default |
  213. |----------|-------------|---------|
  214. | `LOG_MAX_SIZE_MB` | Rotate log when it reaches this size (MB) | `10` |
  215. | `LOG_MAX_BACKUPS` | Keep this many old log files | `5` |
  216. | `LOG_MAX_AGE_DAYS` | Delete log files older than this (days) | `28` |
  217. | `LOG_COMPRESS` | Compress old log files (`true`/`false`) | `true` |
  218. </details>
  219. ---
  220. ## Development
  221. ### Prerequisites
  222. - Go 1.24.5 or later
  223. - Running powhttp instance
  224. ### Building
  225. ```bash
  226. go build ./cmd/powhttp-mcp
  227. ```
  228. ### Testing
  229. ```bash
  230. go test ./...
  231. ```
  232. ---
  233. ## Feature Requests & Bug Reports
  234. Have a feature suggestion or found a bug? We'd love to hear from you!
  235. - **Feature Requests**: Open an [issue](https://github.com/usestring/powhttp-mcp/issues/new) with the `enhancement` label
  236. - **Bug Reports**: Please include steps to reproduce, your environment details, and relevant logs
  237. ---
  238. ## Contributing
  239. We use **squash merges** for all pull requests. When creating a PR, ensure the **PR title** follows [Conventional Commits](https://www.conventionalcommits.org/) format, as it will become the commit message:
  240. **Triggers release:**
  241. - `feat:` - minor version bump
  242. - `fix:` - patch version bump
  243. - `perf:` - patch version bump
  244. - `revert:` - patch version bump
  245. - `feat!:` or `BREAKING CHANGE:` - major version bump
  246. **No release:**
  247. - `docs:`, `chore:`, `refactor:`, `test:`, `style:`, `build:`, `ci:`
  248. Versioning is automated via [release-please](https://github.com/googleapis/release-please).
  249. ---
  250. ## License
  251. This project is licensed under the GNU Affero General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
  252. ---
  253. ## Acknowledgments
  254. **About String** — [String](https://usestring.ai) ( better website coming soon :) ) extracts structured data from any website at scale. We handle all the code and maintenance.
  255. This project was built during an internal hackathon focused on developer experience tooling. Special thanks to:
  256. - **[Kashif Ghafoor](https://github.com/kashif-ghafoor)** — For his contributions during the hackathon
  257. - **Florian** — Creator of [powhttp](https://powhttp.com) for implementing the API from a suggestion and being responsive to feedback
  258. ---
  259. ## Related Projects
  260. - [powhttp](https://powhttp.com) - HTTP traffic capture and analysis
  261. - [Model Context Protocol](https://modelcontextprotocol.io/) - Protocol specification

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.