Repository navigation
feat(mcp): add get_report tool for live disclosed-report bodies - #187
Merged
Merged
Conversation
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
New keyless read-only get_report(id|url): GETs reports/<id>.json and returns a whitelisted body + metadata subset, never the raw 51-key object. Thin/empty body yields a fallback note. _report_json helper mirrors _graphql error handling. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…uard Match the in-repo convention (every other tool raises ToolError for bad arguments, surfaced as a recoverable isError result); reserve InvalidParams for protocol-level errors. isascii() guard rejects unicode superscripts / other-script digits that str.isdigit() accepts but int() mis-handles. Adds url-variant parse tests; fixes stale spec prose to get_report(url=...). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The plan's leak-check step hardcoded the banned client identifiers in a grep pattern, which the hash-based leak-guard (scan_identifiers) matched as real identifiers. Point the step at the guard script itself instead. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a public, keyless, read-only HackerOne MCP tool
get_report(id|url)that fetches a disclosed report's full write-up body live, so the hunt path can read the real precedent for a vuln-class instead of only its distilled citation.Why
The repo's moat is 433 disclosed-report citations, but skills carry only the distilled pattern + URL — never the actual write-up.
get_reportcloses that gap: a hunter testing SSRF on a program can now read the precedent report's own reproduction steps and bypasses, then mirror them on the live target.How
_report_json(rid)— REST GET of the public, keylessreports/<id>.json, mirroring_graphql's error handling (404 → clean "not found", other HTTP/URL errors →ToolError).get_report(args)— accepts exactly one ofidorurl(trailing-digit parse), returns a fixed whitelist only —id, url, title, severity, substate, is_published, disclosed_at, body, body_len, plusbounty(gated onhas_bounty?) andnotewhen the body is thin/empty. Never returns the raw object's sensitive fields (reporter, team, voters, is_triager?, can_view_report, abilities, attachments).commands/hunt.mdstep-4:search_disclosed_reports(class, program)→get_report(url=<top result's url>)→ read body → mirror technique; fall back todocs/disclosed-reports/on a thin body.PUBLIC_TOOLS(keyless); nothing stored or committed;$0/no-network default path untouched.Boundary
Report bodies are reporters'/HackerOne's content — fetched live and used ephemerally, never written to any tracked file. No change to the 433-citation corpus,
harvest_h1.py, or the engine.Tests / gates
get_reporttests (full-body whitelist, sensitive-key exclusion, thin-body note, 404, bad-input→ToolError, url-variant parse) + updated gating assertions (public list → 4, total-with-creds → 7).doc-count-checkgreen; noskills/**touched (skill-lint not triggered); leak-clean.Review
Fresh whole-branch review (verdict: ship). Folded fixes: bad-arg validation uses the
ToolErrorchannel like every sibling tool (wasInvalidParams);isascii()+isdigit()guard rejects unicode/other-script digits; added url-parse coverage.Design + plan:
docs/superpowers/specs/2026-11-19-h1-report-body-fetch-design.md,docs/superpowers/plans/2026-11-20-h1-report-body-fetch.md.🤖 Generated with Claude Code