Hoookd docs

Everything the website does, a program can do too: start a scan, read its report, get a drafted fix and scan again. There are two ways in, a REST API and an MCP server for AI assistants.

REST API

The API is described in OpenAPI 3.1 at /openapi.json. Its address is https://app.hoookd.space/api/v1. Requests and answers are JSON.

curl -X POST https://app.hoookd.space/api/v1/scans \
  -H "Authorization: Bearer hk_YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
# {"scan_id":"..."}

curl https://app.hoookd.space/api/v1/scans/SCAN_ID                # the status, then the scores
curl https://app.hoookd.space/api/v1/scans/SCAN_ID/findings       # verified findings and estimates, kept apart
curl https://app.hoookd.space/api/v1/findings/FINDING_ID/fix      # the instruction and the drafted fix
curl -X POST https://app.hoookd.space/api/v1/scans/SCAN_ID/rescan -H "Authorization: Bearer hk_YOUR_KEY"
curl https://app.hoookd.space/report/SCAN_ID/report.md        # the whole report as Markdown

API keys

Create an API key on your account page. An account needs an email address and a password. The key is shown once, when it is made, and starts with hk_. Delete a key on the same page, and it stops working at once.

Send the key with each request, as Authorization: Bearer hk_YOUR_KEY or as x-api-key: hk_YOUR_KEY. A scan started with a key belongs to your account and gives the full report. One key can make 60 requests a minute and 10 scans an hour. A request with a key that does not hold is refused with status 401. It is never treated as a request without a key.

MCP server

Hoookd has an MCP server, so that an AI assistant can scan a site and work through the findings with you. Its address is:

https://app.hoookd.space/mcp

It speaks Streamable HTTP and has five tools: scan_site, get_scan_status, get_report, get_fix and rescan. There are two ways for an assistant to prove who you are: