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- A scan runs in the background for one to five minutes. Ask for its status about every ten seconds until it is
completedorfailed. - Reading is open to anyone who holds a scan’s id. The id is the secret: share it only with people who should see the report.
- Starting a scan without a key works too. It gives the preview: the scores and the top three findings. Without a key, 3 scans an hour can be started from one network.
- Only public websites can be scanned. An address on a private or local network is refused.
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/mcpIt 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:
- Signing in. An assistant that supports OAuth sends you to this site, where you sign in and allow it. It learns where to send you from /.well-known/oauth-protected-resource/mcp.
- An API key. An assistant that can only send a fixed header takes the key from your account page, as
Authorization: Bearer hk_YOUR_KEY.