hunt-graphql

Discover GraphQL endpoints, map schemas, and test authorization boundaries.

1|Updated Apr 18, 2026
One-click install
npx skills add https://github.com/jellaharshith/SWIFT --skill hunt-graphql-jellaharshith
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt-graphql
Source: https://github.com/jellaharshith/SWIFT/tree/main/swift/skills/cbh/skills/hunt-graphql
Command: npx skills add https://github.com/jellaharshith/SWIFT --skill hunt-graphql-jellaharshith

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify and exploit GraphQL security weaknesses by guiding endpoint discovery, schema probing, authorization validation, and reproduction-focused hunting when targets expose GraphQL functionality.

Core Features & Use Cases

  • Endpoint discovery & fingerprinting: Locates GraphQL endpoints via URL patterns, JSON POST behavior, and frontend/JS bundle signals (e.g., Apollo/Relay, gql template usage, query/mutation strings).
  • Schema mapping & reconnaissance: Performs introspection attempts (including minimal probes and schema enumeration tactics) and maps type relationships to find high-impact mutations.
  • Authorization boundary testing & state desync hunting: Validates whether GraphQL resolvers enforce the same access control as equivalent REST actions, with special focus on persistent privilege after revocation and cross-API desynchronization.

Quick Start

Use the hunt-graphql skill to produce a prioritized list of GraphQL endpoints, candidate high-impact mutations, and a concrete authorization desync test plan for a target you specify.

Frequently Asked Questions about hunt-graphql

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test GraphQL authorization boundaries for IDOR vulnerabilities?

To test GraphQL authorization boundaries, you probe resolvers to verify if they enforce the same access controls as equivalent REST actions, specifically targeting IDOR-prone global IDs and validating mutation-focused authorization checks across different privilege tiers.

What is GraphQL state desync and how do I hunt for it?

GraphQL state desync occurs when GraphQL resolvers and overlapping REST APIs enforce inconsistent access controls. You hunt for it by testing for persistent privilege retention after revocation and validating cross-API authorization desynchronization during bug bounty recon.

How do I discover GraphQL endpoints and map the schema?

You discover GraphQL endpoints by probing URL patterns, JSON POST behavior, and frontend JS bundle signals like Apollo or Relay usage. Schema mapping involves performing introspection attempts, minimal probes, and schema enumeration tactics to map type relationships.

Can I use this for bug bounty recon on any platform with dual-write surfaces?

Yes, this approach applies to bug-bounty style recon and validation workflows targeting GraphQL on any platform. It is specifically designed for environments suspecting dual-write surfaces, IDOR-prone global IDs, or persistent privilege retention after revocation.

How do I generate reproduction-ready PoCs for GraphQL authorization flaws?

You generate reproduction-ready PoCs by sequencing deterministic verification steps that test authorization boundaries across mutations and related REST overlaps, ensuring the exploit is consistently reproducible across privilege tiers.

What's the best way to find high-impact mutations when introspection is disabled?

When introspection is disabled, you can find high-impact mutations by using schema-suggestion techniques and minimal probes to enumerate the schema, mapping type relationships to identify mutations that alter state or escalate privileges.