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/info

Returns 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/url

Scan a GitHub repository for security vulnerabilities. Requires authentication.

{
  "url": "https://github.com/owner/repo"
}

Security Badge

GET /api/badge/{slug}.svg

Get an SVG security badge for any scanned server. No auth required.

Authentication

Scanning requires authentication. Create a free account to get started:

  1. Sign up at /signup
  2. Get your API token from the dashboard
  3. Include it in requests as a Bearer token
Authorization: Bearer your_api_token

Pricing

Free

$0

1 scan/month

Pro

$7/mo

10 scans/month

Team

$29/mo

Unlimited scans + API

For complete API documentation: