Aynstyn Developer Resources

Aynstyn is an AI-powered knowledge assessment and exam preparation platform. This page provides all entry points for developers and AI agents to integrate with Aynstyn's capabilities.

Quick Links

Resource	URL	Format
MCP Server	app.aynstyn.com/mcp	Streamable HTTP / JSON-RPC 2.0
OpenAPI Spec (JSON)	aynstyn.com/openapi.json	OpenAPI 3.1
OpenAPI Spec (YAML)	aynstyn.com/openapi.yaml	OpenAPI 3.1
LLM context (short)	aynstyn.com/llms.txt	Markdown
LLM context (full)	aynstyn.com/llms-full.txt	Markdown
Agent Card (A2A)	/.well-known/agent-card.json	JSON
MCP Discovery	/.well-known/mcp	JSON
Full Documentation	aynstyn.com/docs.html	HTML

MCP Integration Recommended

Aynstyn exposes its knowledge assessment engine via a Model Context Protocol (MCP) server, allowing any MCP-compatible AI client to assess user knowledge directly.

Endpoint

https://app.aynstyn.com/mcp

Transport

Streamable HTTP, stateless, JSON-RPC 2.0.

Available Tool: `assess_knowledge`

Assess a user's subject understanding and return structured feedback.

{
  "subject": "Quantum Computing",   // required, max 200 chars
  "input": "My explanation..."       // required, 10–5000 chars
}

Returns: score, clarityScore, depthScore, coveredTopics, missingTopics, topicCoverage, feedback

REST API

Standard REST endpoints for assessments, user history, credits, interviews, and learning goals. See the full spec:

Authentication

OAuth 2.0 and Firebase Bearer tokens are supported.

Endpoint	URL
Authorization	https://app.aynstyn.com/api/oauth/authorize
Token	https://app.aynstyn.com/api/oauth/token

Available scopes: profile:read, assessments:write, credits:read

Agent Guidelines

Assessments cost 4 credits — check balance via credits:read if possible.
Use the MAPPT framework terminology in results: Mindset, Analyse, Prepare, Practice, Test.
Always check profile:read scope before accessing user-specific data.

Platform Capabilities

AI Knowledge Assessments — score, gaps, and feedback on any subject
Voice Assessments — spoken-input evaluation
AI Mock Interviews — exam and professional preparation
Learning Goals & Roadmaps — personalised study plans
Smart Study Planner — execution calendar for goals and assessments
Practice Papers — past papers and AI-generated mocks
Playbook Journeys — structured 7-day learning flows
WhatsApp AI Agent — assess and learn over WhatsApp

Supported Exams

CAT, UPSC, GRE, GATE, TOEFL, IELTS, NEET, JEE, SSC, IBPS, CLAT, NDA, SAT, GMAT, and all professional/subject domains.

Home · Full Docs · llms.txt · llms-full.txt · OpenAPI