GraphQL-Cop
github.com
- Free plan
- Windows
- macOS
- Linux
- Self-hosted
What GraphQL-Cop is
GraphQL-Cop is a free, lightweight Python utility for checking GraphQL APIs for common security issues, including CI/CD checks. It tests for alias and batch-query overloading, CSRF, information leaks, duplicated fields, denial-of-service risks, and circular introspection queries. When it identifies a vulnerability, it can provide a cURL command that reproduces the finding. Results can be emitted as JSON and can include those commands. You can provide request headers, skip selected tests, force a scan, configure a proxy, or supply a custom endpoint wordlist. If a target URL lacks a GraphQL path, the utility tries a series of common paths. The README documents running it with Python or building it as a Docker container. Requirements are Python 3 and the Requests library. GraphQL-Cop is available for Linux, macOS, Windows, and self-hosted deployments under an MIT License.
Who it suits
GraphQL-Cop suits security auditors and teams adding lightweight GraphQL checks to CI/CD. It is intended for users comfortable with Python, command-line tools, or Docker.
Good to know, and what to watch
- Covers multiple GraphQL security checks
- Provides cURL reproduction commands
- Supports JSON output
- Can scan common endpoint paths
- Runs with Python or Docker
- No API discovery testing
- No authentication or authorization testing
- No input-validation testing
- No business-logic testing
The verdict
GraphQL-Cop provides focused GraphQL vulnerability checks with configurable scans and reproducible output. Its coverage is limited to the listed security tests, so broader API assessment needs other tools.
What the maker publishes
- CI/CD
- The project describes itself as suitable for lightweight GraphQL CI/CD checks. source
- Configuration
- Users can supply request headers, exclude tests, force a scan, configure a proxy, or provide a custom endpoint wordlist. source
- Deployment
- The README documents running GraphQL-Cop from Python and building and running it as a Docker container. source
- Detection coverage
- Its listed checks include alias and batch query overloading, CSRF risks, information leaks, and circular introspection queries. source
- Docker
- The README documents building and running the tool in a Docker container. source
- Endpoint discovery
- If no GraphQL path is provided, the tool iterates through common GraphQL paths. source
- Findings
- It tests for issues including alias overloading, batch queries, CSRF, information leaks, field duplication, and denial-of-service risks. source
- Installation
- The README lists Python 3 and the Requests library as requirements. source
- Intended users
- The repository describes the tool as suitable for GraphQL security auditing and CI/CD checks. source
- License
- The repository includes an MIT License. source
- License
- The repository identifies its license as MIT. source
- Maintainer
- The repository owner profile identifies dolevf as Dolev Farhi and describes him as a security engineer. source
- Output
- It supports JSON output and can include cURL reproduction commands in the results. source
- Purpose
- GraphQL-Cop is a lightweight Python utility for running common security tests against GraphQL APIs, including CI/CD checks. source
- Reproduction
- For identified vulnerabilities, it provides cURL commands to reproduce the findings. source
- Requirements
- The listed requirements are Python 3 and the Requests library. source
- Support
- The README provides command-line help and troubleshooting guidance for Docker file and dependency issues. source
- Target discovery
- If the target URL omits a GraphQL path, it iterates through a series of common GraphQL paths. source
Checked against the maker's pages on 7 Oct 2026.