Brainito API & MCP

Authorization: Bearer brn_live_XXXXXXXX.YOUR_SECRET

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "clientInfo": { "name": "my-app", "version": "1.0" },
    "capabilities": {}
  }
}

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

// ~/Library/Application Support/Claude/claude_desktop_config.json
// (Windows: %APPDATA%\Claude\claude_desktop_config.json)
{
  "mcpServers": {
    "brainito": {
      "command": "npx",
      "args": ["-y", "@brainito/mcp@latest"],
      "env": {
        "BRAINITO_API_KEY": "brn_sa_XXXXXXXX.YOUR_SECRET"
      }
    }
  }
}

// Settings → MCP → Add new global MCP server
// or .cursor/mcp.json in your project root
{
  "mcpServers": {
    "brainito": {
      "command": "npx",
      "args": ["-y", "@brainito/mcp@latest"],
      "env": {
        "BRAINITO_API_KEY": "brn_sa_XXXXXXXX.YOUR_SECRET"
      }
    }
  }
}

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "brainito": {
      "command": "npx",
      "args": ["-y", "@brainito/mcp@latest"],
      "env": {
        "BRAINITO_API_KEY": "brn_sa_XXXXXXXX.YOUR_SECRET"
      }
    }
  }
}

const API_KEY = "brn_live_XXXXXXXX.YOUR_SECRET";
const BASE = "https://brainito.com/api/v1";

async function auditWebsite(url) {
  // 1. Start scan
  const scanRes = await fetch(`${BASE}/scan`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ url }),
  });
  const { scan_uid } = await scanRes.json();

  // 2. Poll until complete
  let report;
  while (true) {
    await new Promise(r => setTimeout(r, 5000)); // wait 5s between polls
    const res = await fetch(`${BASE}/report/${scan_uid}`, {
      headers: { "Authorization": `Bearer ${API_KEY}` },
    });
    report = await res.json();
    if (report.status === "completed") break;
    console.log(`Still ${report.status}...`);
  }

  return report;
}

const result = await auditWebsite("https://example.com");
console.log("Overall score:", result.scores.overall);
console.log("Top priority:", result.priority_actions[0]);

import requests
import time

API_KEY = "brn_live_XXXXXXXX.YOUR_SECRET"
BASE = "https://brainito.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def audit_website(url: str) -> dict:
    # 1. Start scan
    res = requests.post(f"{BASE}/scan", headers=HEADERS, json={"url": url})
    res.raise_for_status()
    scan_uid = res.json()["scan_uid"]

    # 2. Poll until complete
    while True:
        time.sleep(5)
        res = requests.get(f"{BASE}/report/{scan_uid}", headers=HEADERS)
        report = res.json()
        if report["status"] == "completed":
            return report
        print(f"Still {report['status']}...")

report = audit_website("https://example.com")
print("Overall score:", report["scores"]["overall"])
print("Top priority:", report["priority_actions"][0])

# Initialize
curl -X POST https://brainito.com/api/mcp \
  -H "Authorization: Bearer brn_live_XXXXXXXX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{}}}'

# Scan
curl -X POST https://brainito.com/api/mcp \
  -H "Authorization: Bearer brn_live_XXXXXXXX.YOUR_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"scan_website","arguments":{"url":"https://example.com"}}}'

HTTP/1.1 402 Payment Required
{ "error": "Insufficient credits. You have 40; a scan costs 100.", "available_credits": 40, "required_credits": 100 }

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "Invalid API key format"
  }
}