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.
Interactive Documentation
Explore every endpoint with live examples you can try directly in your browser.
Download YAML
Get the full OpenAPI specification in YAML format for use with your tools.
Download JSON
Get the full OpenAPI specification in JSON format for code generation and imports.
Quick Start
# 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
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.