Built for AI Agents
Agent Access
Programmatic API access for AI agents to scan MCP servers, check security scores, and embed badges.
Quick Start
Get service info with a single request:
GET https://api.mcpsafe.org/api/agent/info
Response:
{
"service": "MCPSafe",
"description": "Security scanner for MCP servers",
"version": "1.0.0",
"capabilities": ["scan_url", "get_report", "get_badge"],
"free_tier": {
"scans_per_month": 1,
"requires_signup": true
}
}API Endpoints
Service Discovery
GET /api/agent/infoReturns service capabilities, endpoints, auth requirements, and pricing info. No auth required.
URL Validation
GET /api/agent/scan-check?url=...Check if a GitHub URL is valid for scanning before making an authenticated request.
Scan Server
POST /api/v1/scans/urlScan a GitHub repository for security vulnerabilities. Requires authentication.
{
"url": "https://github.com/owner/repo"
}Security Badge
GET /api/badge/{slug}.svgGet an SVG security badge for any scanned server. No auth required.
Authentication
Scanning requires authentication. Create a free account to get started:
- Sign up at /signup
- Get your API token from the dashboard
- Include it in requests as a Bearer token
Authorization: Bearer your_api_token