Integrate Cyber Insurance Readiness Into Your Workflow

cURL

# Start a scan
curl -X POST https://cyberdefenseagent.ai/api/scan/run \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cda_your_key_here" \
  -d '{"domain": "example.com", "businessName": "Example Corp", "email": "admin@example.com"}'

# Poll for results
curl https://cyberdefenseagent.ai/api/scan/status?id=scan_abc123 \
  -H "X-API-Key: cda_your_key_here"

Python

import requests, time

API_KEY = "cda_your_key_here"
BASE = "https://cyberdefenseagent.ai"
headers = {"X-API-Key": API_KEY, "Content-Type": "application/json"}

# Start scan
resp = requests.post(f"{BASE}/api/scan/run", headers=headers, json={
    "domain": "example.com",
    "businessName": "Example Corp",
    "email": "admin@example.com"
})
scan_id = resp.json()["id"]

# Poll until complete
while True:
    status = requests.get(f"{BASE}/api/scan/status?id={scan_id}", headers=headers).json()
    if status["status"] == "complete":
        print(f"Score: {status['score']} ({status['grade']})")
        break
    time.sleep(5)

Node.js

const API_KEY = "cda_your_key_here";
const BASE = "https://cyberdefenseagent.ai";

// Start scan
const scanRes = await fetch(`${BASE}/api/scan/run`, {
  method: "POST",
  headers: { "X-API-Key": API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    domain: "example.com",
    businessName: "Example Corp",
    email: "admin@example.com"
  })
});
const { id } = await scanRes.json();

// Poll until complete
let result;
do {
  await new Promise(r => setTimeout(r, 5000));
  const statusRes = await fetch(`${BASE}/api/scan/status?id=${id}`, {
    headers: { "X-API-Key": API_KEY }
  });
  result = await statusRes.json();
} while (result.status !== "complete");

console.log(`Score: ${result.score} (${result.grade})`);

Claude Desktop / Cursor Configuration

{
  "mcpServers": {
    "cyberdefenseagent": {
      "url": "https://cyberdefenseagent.ai/mcp",
      "headers": {
        "X-API-Key": "cda_your_key_here"
      }
    }
  }
}

Available Tools

Agent Card

Discoverable at https://cyberdefenseagent.ai/.well-known/agent.json

Skills

Example JSON-RPC Request

POST https://cyberdefenseagent.ai/a2a
Content-Type: application/json

{
  "jsonrpc": "2.0",
  "method": "tasks/send",
  "id": "1",
  "params": {
    "id": "task-001",
    "message": {
      "role": "user",
      "parts": [
        { "type": "text", "text": "Get the cyber defense score for example.com" }
      ]
    }
  }
}

OpenAPI Schema for Actions

openapi: "3.1.0"
info:
  title: Cyber Defense Agent API
  version: "1.0"
servers:
  - url: https://cyberdefenseagent.ai
paths:
  /api/scan/run:
    post:
      operationId: startScan
      summary: Start a cyber defense scan
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [domain]
              properties:
                domain:
                  type: string
                  description: Domain to scan
                businessName:
                  type: string
                email:
                  type: string
      responses:
        "200":
          description: Scan started
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                  status:
                    type: string
  /api/scan/status:
    get:
      operationId: getScanStatus
      summary: Get scan status and results
      parameters:
        - name: id
          in: query
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Scan status
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  score:
                    type: number
                  grade:
                    type: string
  /api/quote-request:
    post:
      operationId: submitQuoteRequest
      summary: Submit a cyber insurance quote request
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [domain, email]
              properties:
                domain:
                  type: string
                email:
                  type: string
                businessName:
                  type: string
                revenue:
                  type: string
                industry:
                  type: string
      responses:
        "200":
          description: Quote request submitted