# Aynstyn Developer Documentation (LLM Optimized)

This is a scoped context file for the developer-facing features of the Aynstyn platform.

## Integration Entry Points

- **MCP Server**: `https://app.aynstyn.com/mcp`
- **MCP Discovery**: `https://app.aynstyn.com/.well-known/mcp`
- **OpenAPI Spec**: `https://aynstyn.com/openapi.json`
- **Developers Portal**: `https://aynstyn.com/developers`

## Core Integration Tools

### Model Context Protocol (MCP)
Aynstyn exposes tools for agents to perform diagnoses and manage learning on behalf of users.
- `assess_knowledge`: Diagnose subject understanding.
- `create_learning_goal`: Map a new study objective.
- `schedule_ai_interview`: Book voice sessions.

### REST API
Standard REST endpoints for credits, user history, and assessments.

## Authentication
OAuth 2.0 and Firebase Bearer tokens are supported.
- Auth Endpoint: `https://app.aynstyn.com/api/oauth/authorize`
- Token Endpoint: `https://app.aynstyn.com/api/oauth/token`

## Guidelines for Agents
- Always check the `profile:read` scope before attempting to access user-specific data.
- Assessments cost 4 credits; verify balance via `credits:read` if possible.
- Use the MAPPT framework terminology in results (Mindset, Analyze, Prepare, Practice, Test).