Developer API and MCP

Automate security scanning and vulnerability management with the Panoptic Scans REST API or the MCP server. Both are included on every plan.

Quick Start

bash
# 1. Get an API token
curl -X POST "https://panopticscans.com/api/token?key=YOUR_API_KEY"

# 2. List all scans
curl -X GET "https://panopticscans.com/api/scans" \
  -H "Authorization: Bearer YOUR_TOKEN"

# 3. Create a new scan
curl -X POST "https://panopticscans.com/api/new-scan" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "scan_name": "Production Scan",
    "scan_type": "Nmap",
    "scan_frequency": "Weekly",
    "scan_target": "192.168.1.0/24"
  }'

Authentication

The API and the MCP server use JWT bearer-token authentication. Create an API key from your account settings, exchange it for a token via the /api/token endpoint, and include Authorization: Bearer <token> on every subsequent request. The exchange also returns a refresh token. When a call returns 401 with error="invalid_token", send grant_type=refresh_token to the same endpoint. Agents can follow auth.md.

MCP

Connect an agent to the Streamable HTTP server at POST https://panopticscans.com/mcp. Discover it from the MCP server card. OAuth clients such as Cursor sign in at https://panopticscans.com/oauth/authorize and refresh the access token themselves. Send Accept: application/json, text/event-stream and the bearer token. The initialize response sets Mcp-Session-Id; send that header on later requests.

A 401 from the API or from /mcp includes WWW-Authenticate. Tools cover scans, reports, vulnerabilities, targets, and webhooks. Vulnerability statuses are Unresolved, Resolved, Accepted, and False Positive. The review-findings prompt summarizes what to fix first. The same plan limits as the REST API apply.

Capabilities

Scans — Create, list, update, delete, and rerun scans
Vulnerabilities — Browse and filter discovered findings
Targets — Manage hosts, IPs, and URLs
Webhooks — Receive real-time scan event notifications
Reports — Download PDF and CSV scan reports
Tokens — Issue, refresh, and revoke API tokens

Need more detail? Explore our fully interactive API reference.

Scanning for clients? The white-label scanning API for MSPs page has Python and Google Sheets examples.

Scan a URL, IP, or hostname

Enter a target and an email address. We'll send a findings report.