# PlatPhorm Evals

> Registry-driven evaluation mesh for the PlatPhorm ecosystem.

## Service Info
- Canonical URL: https://evals.platphormnews.com
- Version: 0.1.0

## API Endpoints
- Health: GET https://evals.platphormnews.com/api/health
- API Docs (OpenAPI): GET https://evals.platphormnews.com/api/docs
- MCP (JSON-RPC 2.0): POST https://evals.platphormnews.com/api/mcp
- MCP Server Descriptor: GET https://evals.platphormnews.com/api/mcp
- Registry Sync: POST /api/v1/registry/sync
- Registry Services: GET /api/v1/registry/services
- Registry Probe: POST /api/v1/registry/probe
- Eval Suites: GET /api/v1/evals, POST /api/v1/evals
- Eval Runs: GET /api/v1/runs, POST /api/v1/runs
- Release Gates: GET /api/v1/gates, POST /api/v1/gates
- Scorecards: GET /api/v1/graders (grader-based scoring)

## MCP Tools
- sync_network_registry
- import_targets_from_mcp
- import_targets_from_spec
- create_eval_suite
- generate_eval_cases
- run_eval_suite
- generate_scorecard
- gate_release
- compare_eval_runs
- detect_regressions

## Authentication
- GET /api/health: public
- GET /api/docs: public
- GET /api/mcp: public (server descriptor)
- POST /api/mcp: requires Bearer token or X-API-Key header
- All /api/v1/* mutation endpoints: requires Bearer token

## Focus
- Network registry sync from PlatPhormNews network graph
- MCP target ingestion from MCP Hub
- Trace-informed eval synthesis
- Spec-derived contract evals
- Browser and webhook evaluation hooks
- Scorecards and release gates