REST, MCP, and the separate human-approved OAuth tier. Check the capabilities manifest before promising anything.
curl -X POST https://pagecompass.onrender.com/agent/v1/recommend \
-H "Content-Type: application/json" \
-d '{"query":"practical leadership book, no academic textbook"}'
Save session_id. For more: POST /agent/v1/recommend/more with session_id and exclude_book_ids.
Feedback: {"on_primary_id":"...","outcome":"accept|reject|keep","reasons":["too_long"],"note":"..."}
POST to /agent/mcp. Initialize, then tools/list, then tools/call with pagecompass_recommend or pagecompass_more.
The private reader MCP at /agent/account/mcp is a different endpoint and credential.
Allow up to 90 seconds. HTTP 503 with spine_timeout is retryable — honor Retry-After. HTTP 200 with zero_result: true is an honest miss, not a failure.
Separate Authorization Code + PKCE flow. Minimal scopes: profile:read, library:read, quality:report, profile:suggest.
Honest status: Client registration is operator-verified. Vendor support is not guaranteed. Check /.well-known/pagecompass-reader-agent.json and the capabilities manifest before promising this path to a human. profile:write and library:write are disabled by default.