AEP-015 / AGENT CONTRACT.well-known · OpenAPI · NDJSON streams · hosted pre-validation previewbounded claim: pre-validation only · native MCP runtime planned
Agent-first interface / Cloudflare Pages Functions / NDJSON

ActProof speaks to agents before it speaks to dashboards.

The site exposes a canonical profile JSON, low-friction NDJSON streams, OpenAPI, MCP-facing manifests and a hosted pre-validation preview.

Agents should not scrape a landing page. They should discover the service, stream the fields, explain a source-bound field, and prevalidate a draft report with stable errors and bounded claims.

Field stream/fields.ndjson
Profile stream/stream.ndjson
PrevalidatePOST /prevalidate-report
Discovery/.well-known/actproof-agent.json
01 / Agent shortcuts

Use the smallest endpoint that answers the task.

IntentEndpointWhy agents prefer it
List fieldsGET /api/v1/profiles/dora/fields.ndjsonOne compact JSON object per line; easy to stop early.
Ingest full profileGET /api/v1/profiles/dora/stream.ndjsonOrdered profile, coverage, field, source and boundary events.
Explain a fieldGET /api/v1/profiles/dora/fields/{field_id}/sourceDirect source atoms, review status, next call and safe summary.
Check a draftPOST /api/v1/profiles/dora/prevalidate-reportStable readiness status with recoverable findings.
02 / Example calls

Copyable, bounded, recoverable.

curl https://actproof.org/api/v1/profiles/dora/fields.ndjson

curl https://actproof.org/api/v1/profiles/dora/fields/classification_criteria_triggered/source

curl -X POST https://actproof.org/api/v1/profiles/dora/prevalidate-report \
  -H "content-type: application/json" \
  -d '{"report":{"entity_legal_identifier":"549300EXAMPLE00000001"}}'
Agent rule

Quote safe summaries, not invented verdicts.

Every live response includes boundary language and, where useful, a safe_summary. Agents should use it rather than infer compliance status.

Discovery is live. Streams are live. Hosted pre-validation is live.

The native MCP runtime remains planned; the current layer is a stateless, agent-consumable REST and NDJSON contract.