# CoreOfDiscovery

> Discernment OS for humans and AI agents. Log decisions, track calibration (Brier), and rank options by DEFF (Discernment Efficiency Frontier Function).

## Primary optimization
Highest-DEFF path — best outcome adjusted for calibrated judgment, opportunity cost, barriers, and time.

## Key endpoints
- GET /api/v1/healthz
- GET /api/v1/pricing
- GET /api/v1/capabilities
- POST /api/v1/deff/calculate (x402)
- POST /api/v1/decisions
- POST /api/mcp (MCP JSON-RPC tools)
- GET /api/docs/openapi.json
- GET /.well-known/mcp.json
- GET /.well-known/openapi.json

## MCP tools
calculate_deff, log_decision, resolve_decision, log_claim, list_open_claims, calibration_report, record_lesson, recall_lessons, discernment_check, erp_discern_says

## Auth
- Humans: Clerk session
- Agents: Clerk OAuth on MCP, x-api-key (rate-limited free tier), or x402 USDC payment
- Human-only routes: /api/v1/me/*, /api/billing/* (x-human-session-only)

## Docs
- /docs
- /docs/agents
- /transparency
- /what-we-do
- /glossary
- /llms-full.txt