Developer surfaces

Use API documentation for the JSON and Markdown scan contract, OpenAPI JSON or OpenAPI YAML for function-calling clients, and MCP metadata for capability discovery.

Agents should begin with answerready:tool:get_info. It reads the public LLMS, RSS, OpenAPI, health, MCP, and well-known surfaces and returns the available action catalog. Every documented OpenAPI operation is projected as an answerready:api:* MCP tool; adding an endpoint without a matching tool fails the contract suite.

The compatibility MCP tool answerready.score_evidence lets trusted scanners validate bounded criterion observations against the current rubric without refetching a site. It returns a deterministic validation receipt but does not persist a report. Use answerready:api:create_scan, answerready.scan_site, or POST /api/scan when a fresh fetch and retained report are required.

Protected operations accept Authorization: Bearer PLATPHORM_API_KEY or X-PlatPhorm-API-Key. Never expose the key in browser code, reports, logs, or discovery files.