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.9.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.9.0
File Size Uploaded
cobaltosec_petrel-0.9.0.tar.gz 68.7 kB Details

Built distribution (wheel)

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

Total release size: 121.9 kB

Release files / cobaltosec_petrel-0.9.0.tar.gz

Download URL cobaltosec_petrel-0.9.0.tar.gz
Size 68.7 kB
Tags Source
SHA-256 checksum
How to use checksums
1cfc10b2c85a7526430e862f70eb641888aa30a3594a4e131f49e84eb27b05e2
BLAKE2b-256 checksum
How to use checksums
3ce35a76df43ea5b1b0627eb7984b8671975604671964423804c806bbdd64d9b
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.9.0-py3-none-any.whl

Download URL cobaltosec_petrel-0.9.0-py3-none-any.whl
Size 53.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
081812c5e4d9fca2187ac41c48350f8a7050529052f137bcb1ae9b66db93d136
BLAKE2b-256 checksum
How to use checksums
8e8b21d0b2271af61047902d3086fcfc91b56d71ed2dad737e6983186dcc7e2f
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

This release

0.9.0 This release

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