# ATLAS
> Verified route layer for the AI ecosystem.

ATLAS maps goals to evidence-backed routes, stacks, receipts, and outcomes for both humans and AI agents.

## Core contract
- Routes beat directories.
- Evidence beats hype.
- Paid placement never affects score.
- No verified path without exclusions.
- No score without freshness.

## Public endpoints
- GET /health
- GET /paths/deltas
- GET /paths/{pathId}/delta
- GET /entities
- GET /entities/batch
- GET /entities/{entityId}
- GET /api/admin/status
- GET /api/runtime/status
- POST /api/obelisk-verify
- GET /verified-paths
- GET /verified-paths/{pathId}
- GET /evidence
- POST /evidence/submit
- GET /scoring/entity/{entityId}
- GET /scoring/path/{pathId}
- POST /routes/generate
- POST /receipts/generate
- GET /paths/{pathId}/receipt
- POST /receipts/verify
- GET/POST /outcomes
- GET /outcomes/aggregate/{pathId}
- GET /outcomes/summary
- GET /paths/compare
- GET /terrain/diff
- GET/POST /api/errors
- GET /api/contact/status
- POST /api/contact
- GET /api/popular-goals
- GET/POST/DELETE /api/subscribe
- POST /api/waitlist

## Admin-gated endpoints
- POST /api/admin/review/{entityId}
- GET /api/admin/log
- GET /api/admin/waitlist/insights

## Machine-readable API spec
- OpenAPI 3.1: /api-schema.json
- Manifest-derived route and smoke contract: /api-contract.json
- Runtime persistence status: /api/runtime/status

## Agent surfaces
- agents.json: /agents.json
- MCP tools: atlas.search_entities, atlas.get_verified_path, atlas.generate_route, atlas.score_stack, atlas.generate_receipt, atlas.compare_paths, atlas.verify_receipt, atlas.get_route_for_goal

## Token efficiency tips
- Use ?fields=id,name,confidence to project only needed fields
- Use /entities/batch?ids=a,b,c instead of N separate /entities/:id calls
- Use /paths/deltas?ids=a,b,c instead of N separate /paths/:id/delta calls
- Use atlas.get_route_for_goal (MCP) instead of generate_route plus get_verified_path plus generate_receipt
- Read /api-contract.json before probing: only cases with productionSafe=true are appropriate for staging or production smoke tests

## Contact
- hello@atlas.vaultsparkstudios.com