# PlatPhorm AgentReady

Version: 1.1.1
Canonical: https://agentready.platphormnews.com

AgentReady is the independent, deterministic point-in-time scanner for what autonomous systems can discover, understand, and act on. AnswerReady consumes its machine-readable result as a first-class provider; AgentOps owns longitudinal readiness history.

## Navigation
- [Methodology](https://agentready.platphormnews.com/#method)
- [API documentation](https://agentready.platphormnews.com/api/docs)
- [MCP endpoint](https://agentready.platphormnews.com/api/mcp)
- [OpenAPI JSON](https://agentready.platphormnews.com/openapi.json)
- [OpenAPI YAML](https://agentready.platphormnews.com/openapi.yaml)
- [Agents](https://agentready.platphormnews.com/.well-known/agents.json)
- [Trust policy](https://agentready.platphormnews.com/.well-known/trust.json)
- [AnswerReady](https://answerready.platphormnews.com)
- [AgentOps](https://agentops.platphormnews.com)
- [SitemapOps](https://sitemapops.platphormnews.com)
- [SearchOps](https://searchops.platphormnews.com)
- [TrustOps](https://trustops.platphormnews.com)
- [BrowserOps](https://browserops.platphormnews.com)

## When to use AgentReady
Use AgentReady for a bounded, evidence-backed point-in-time scan of public discovery files, semantics, APIs, structured data, agent guidance, and MCP surfaces.

## When not to use AgentReady
Do not use AgentReady as a browser journey runner, longitudinal monitor, external search engine, sitemap authority, or substitute for a full security/accessibility review. Use AnswerReady for the reconciled cross-scanner rollup.

## Coverage
The suite checks agent discovery, crawler access, server-rendered content, semantic HTML, JSON-LD, API errors, function-calling quality, safe retry/versioning/rate-limit signals, OAuth metadata, MCP initialization/capabilities/errors, and operational guidance. Optional surfaces remain not_applicable when absent.

## API
- POST /api/v1/scans — create a public-safe scan
- GET /api/v1/scans/{id} — retrieve a persisted report
- POST /api/mcp — handle MCP JSON-RPC 2.0 requests; GET /api/mcp returns metadata
- POST /api/v1/answerready/test — protected complete report for AnswerReady; requires PLATPHORM_API_KEY
- Protected report responses include reportCompleteness=complete or findings_only and name omitted report fields without inventing them.
- Protected AnswerReady requests may include sharedScanContext with scanId, normalized target, W3C traceparent, and redacted SHA-256 artifact references for bounded resource reuse.
- GET /api/docs — OpenAPI 3.1 document
- GET /api/health and /api/v1/health — service health

## Limits and safety
Public HTTP(S) URLs only. Private networks, credentials, custom ports, oversized responses, and unsafe redirects are rejected. Scans are bounded and read-only. Caller-network metrics are optional and must be supplied only with explicit consent. Unavailable or unmeasured checks remain visible and are not converted into target failures.