Commit on: 2025-08-26 17:53:44

Author: alexanderjeurissen

README.md

@@ -35,10 +35,42 @@ A Docker image that provides access to HackerOne's GraphQL API through the Model
 
 ## Generating an API Token
 
+### Option 1: Using the included script (recommended)
+1. Visit https://hackerone.com/settings/api_token/edit to generate an API key
+2. Run the token generation script: `./scripts/generate_token.sh`
+   This will prompt for your username and API key, then automatically encode and copy the token to your clipboard.
+3. Use the resulting string as your TOKEN value
+
+### Option 2: Manual encoding
 1. Visit https://hackerone.com/settings/api_token/edit to generate an API key
 2. Encode as: `echo -n "username:api_key" | base64`
 3. Use the resulting string as your TOKEN value
 
+## Example config in Flowise
+
+1. Go to an Agent node
+2. Go to tools
+3. Select custom MCP
+4. Put the following in the MCP parameters:
+
+```json
+{
+    "command": "/usr/local/bin/docker",
+    "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "ENDPOINT=https://hackerone.com/graphql",
+        "-e",
+        "TOKEN=<your_base64_encoded_token>",
+        "-e",
+        "ALLOW_MUTATIONS=none",
+        "hackertwo/hackerone-graphql-mcp-server:1.0.5"
+    ]
+}
+```
+
 ## Example config in editor (Zed)
 
 ```json

scripts/generate_token.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env sh
+set -e
+
+cleanup() { stty echo 2>/dev/null || true; }
+trap cleanup EXIT INT TERM
+
+# Prompt for username
+printf "Username: "
+read -r USERNAME
+
+# Prompt for API key (silent)
+printf "API key: "
+stty -echo
+read -r APIKEY
+cleanup
+printf "\n"
+
+# Encode and copy
+ENCODED=$(printf "%s" "${USERNAME}:${APIKEY}" | base64 | tr -d '\n')
+printf "%s" "$ENCODED" | pbcopy
+
+printf "\nYour encoded token has been copied to the clipboard:\n\n"
+printf "%s\n" "$ENCODED"