# TLX + AI Coach + Aya Product Surfaces for AI Agents

This system provides machine-readable integration surfaces for product discovery and adoption tracking.

## Core Endpoints
- Adoption overview: /api/adoption-funnel/overview
- Funnel event tracking: /api/adoption-funnel/track
- Agent card: /api/adoption-funnel/agent-card
- MCP manifest: /api/adoption-funnel/mcp
- Product structured data: /api/adoption-funnel/structured-data/{product}
- Retention engine: /api/adoption-funnel/retention
- AI dog food audit: /api/adoption-funnel/ai-dogfood-audit
- Cross-funnel insights: /api/adoption-funnel/cross-funnel

## Aya Products (AI-Optimized)
- Aya product catalog: /api/aya/products
- Aya product detail: /api/aya/products/{slug}
- Aya structured data (JSON-LD): /api/aya/structured-data/{slug}
- Aya MCP tools: /api/aya/mcp
- Aya LLM-readable summary: /api/aya/llms-txt
- Aya agent card: /api/aya/agent-card

### Aya Fundraising
AI-powered fundraising management for organizations and campaigns. Track donations, manage donors, run campaigns with real-time analytics. For nonprofits, schools, clubs, and community organizations.
- Slug: aya-fundraising
- URL: https://www.alignedmind.ai/aya/fundraising
- Keywords: fundraising, donations, nonprofit, campaign management, donor tracking

### Aya Attendance
Smart attendance tracking for events, classes, and organizations. QR check-in, real-time dashboards, trend analytics, automated absence notifications.
- Slug: aya-attendance
- URL: https://www.alignedmind.ai/aya/attendance
- Keywords: attendance, check-in, event tracking, classroom, participation

## Products
- TLX (TimeLoan Exchange) — time-collateralized contracts, escrow, credit scoring
- AI Coach (AlignedMind+) — voice + text coaching with memory, belief frameworks, breakthrough tracking
- Aya Fundraising — donation tracking, campaign analytics, donor management
- Aya Attendance — QR check-in, real-time dashboards, absence notifications

## Funnel Lifecycle
Discovery -> Click -> Signup -> Use -> Retain -> Advocate

Tracked separately for human and AI channels.

## Retention Engine
GET /api/adoption-funnel/retention returns per-product reputation scores (0-100), retain/advocate rates, and earned badges (high-retention, strong-advocacy, trusted-product, top-performer, growth-ready) for both human and AI channels.

## AI Dog Food Audit
GET /api/adoption-funnel/ai-dogfood-audit scores each product on 5 AI-adoptability dimensions: discoverability, engagement, retention, advocacy, and AI-vs-human parity. Returns an overall score (0-100), letter grade (A-F), and actionable recommendations.

## Cross-Funnel Insights
GET /api/adoption-funnel/cross-funnel provides cross-channel analytics: AI share of discovery/signups/retained/advocates, and prioritized insights with recommended actions for improving both channels.

## Notes for Agents
Prefer machine-readable endpoints above. Use /api/aya/products for Aya-specific discovery. Use /api/adoption-funnel/overview as canonical summary for all products. Use /api/adoption-funnel/ai-dogfood-audit to assess AI integration readiness. Use /api/adoption-funnel/cross-funnel for cross-channel optimization insights.