Skip to main content

Petrel

MCP Internet Scanner & Fingerprinter — find exposed MCP servers before attackers do.

petrel discover                     # passive: crt.sh + HuggingFace Spaces
petrel probe https://target.com     # fingerprint a single server
petrel scan targets.txt             # batch from file

Install

pip install cobaltosec-petrel

What it finds

Petrel probes MCP servers via their JSON-RPC handshake, extracts the full tool inventory, detects auth state, and scores risk:

  • execute_bash without auth → CRITICAL
  • write_file without auth → HIGH
  • read_file without auth → MEDIUM

Unlike Shodan, Petrel understands MCP semantics — not just "port open" but "this server exposes shell execution with no authentication."

Discovery sources (no API key required)

  • crt.sh — certificate transparency logs
  • HuggingFace Spaces — public MCP server deployments

Pipeline with Corvus

petrel discover -o results.jsonl
# feed into Corvus for deep security audit

Part of the CobaltoSec ecosystem

CobaltoSec · Corvus · Kestrel

Metadata

Release files for cobaltosec-petrel 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cobaltosec-petrel 0.6.0
File Size Uploaded
cobaltosec_petrel-0.6.0.tar.gz 45.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cobaltosec-petrel 0.6.0
File Interpreter ABI Platform
cobaltosec_petrel-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 79.4 kB

Release files / cobaltosec_petrel-0.6.0.tar.gz

Download URL cobaltosec_petrel-0.6.0.tar.gz
Size 45.5 kB
Tags Source
SHA-256 checksum
How to use checksums
02471283c07aec6d465585a459467db7e765a2f9f70bc56c40fe4e4ba196afc7
BLAKE2b-256 checksum
How to use checksums
2c0085492bd070816893cdf2d7c920a3317a7a7d4acfdb79c3969125b89b92c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release files / cobaltosec_petrel-0.6.0-py3-none-any.whl

Download URL cobaltosec_petrel-0.6.0-py3-none-any.whl
Size 33.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3db5232777e2c7d6f95af378dd90f26458691312f37e9e8058435d7c77b36af1
BLAKE2b-256 checksum
How to use checksums
b5795b3a599bec2f5119ed1c6828d27af13510562d0a53de4b84560ec5e47e4d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.12.10

Release history Release notifications | RSS feed

0.10.0

2 release files

0.9.0

2 release files

This release

0.6.0 This release

2 release files

0.5.0

2 release files

0.4.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page