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.5.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.5.0
File Size Uploaded
cobaltosec_petrel-0.5.0.tar.gz 38.1 kB Details

Built distribution (wheel)

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

Total release size: 68.9 kB

Release files / cobaltosec_petrel-0.5.0.tar.gz

Download URL cobaltosec_petrel-0.5.0.tar.gz
Size 38.1 kB
Tags Source
SHA-256 checksum
How to use checksums
d752b7683a3b5ddf283203448b2a8a8b751c61ce4525a2870bb6891f5ad1878a
BLAKE2b-256 checksum
How to use checksums
535a72e0ca070bac1c56f732046a430e3e246f4d6a68e13171053ec4daca8168
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.5.0-py3-none-any.whl

Download URL cobaltosec_petrel-0.5.0-py3-none-any.whl
Size 30.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
89cca00be29214cb9818215f7b5968bd70f7c7b443dccbb14aaa8d0523f96f06
BLAKE2b-256 checksum
How to use checksums
edded8322c4878f41778bc49cd353c97961ef9bd4dbf71f58a68b8f39d5ff269
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

This release

0.5.0 This release

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