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.4.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.4.0
File Size Uploaded
cobaltosec_petrel-0.4.0.tar.gz 34.8 kB Details

Built distribution (wheel)

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

Total release size: 64.4 kB

Release files / cobaltosec_petrel-0.4.0.tar.gz

Download URL cobaltosec_petrel-0.4.0.tar.gz
Size 34.8 kB
Tags Source
SHA-256 checksum
How to use checksums
bd03bd5da1165ef7337cfa597efc1e6ea7088b83ceadb66f9aa3ee08ffcdf172
BLAKE2b-256 checksum
How to use checksums
05b353eb47e3d45502cc13c8582f369f545b795d354ba15605491deaae9bb3de
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.4.0-py3-none-any.whl

Download URL cobaltosec_petrel-0.4.0-py3-none-any.whl
Size 29.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e13306b2e400905734bfd1ab23d97527d606201628481ea1f03f2c077fd3d366
BLAKE2b-256 checksum
How to use checksums
044e2fbdf01cfc968c5110d7e30f29fb48063511c5b78bdba6333882d44dc5c2
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

0.6.0

2 release files

0.5.0

2 release files

This release

0.4.0 This release

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