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.10.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.10.0
File Size Uploaded
cobaltosec_petrel-0.10.0.tar.gz 82.0 kB Details

Built distribution (wheel)

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

Total release size: 144.5 kB

Release files / cobaltosec_petrel-0.10.0.tar.gz

Download URL cobaltosec_petrel-0.10.0.tar.gz
Size 82.0 kB
Tags Source
SHA-256 checksum
How to use checksums
0069edca3a5ec93dd8a36631a832a4886f14797121cc909f5a3695e5ffb32acc
BLAKE2b-256 checksum
How to use checksums
f0e7eb04549f6c9ccd448ffe46173e57c23e2fe7f4931b3163c506c3cfea7e33
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.10.0-py3-none-any.whl

Download URL cobaltosec_petrel-0.10.0-py3-none-any.whl
Size 62.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1c66483f1c116e469d036ae822f7f9b73b50401141264bc90a24b503547a4366
BLAKE2b-256 checksum
How to use checksums
4655db5d38b3b3df95d7fce14acc6fa72af298427e8fddd205429dfdcc96f47a
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

This release

0.10.0 This release

2 release files

0.9.0

2 release files

0.6.0

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