# WordQuest - Japanese Learning Platform

> JLPT N5 to N1 Japanese learning platform with 146 courses, 8,200+ vocabulary
> words, AI tutoring, gamification, and social features. Supports 8 languages.

## Platform
- [Homepage](https://wordquest.solanalink.jp)
- [Course Catalog](https://wordquest.solanalink.jp/en/course)
- [Grammar Guide](https://wordquest.solanalink.jp/en/grammar)
- [Practice Hub](https://wordquest.solanalink.jp/en/practice)
- [Community Tavern](https://wordquest.solanalink.jp/en/tavern)

## Learning Content
- 146 Progressive Courses (JLPT N5 through N1)
- 8,200+ Vocabulary Words with Audio
- 500+ Grammar Patterns
- 6,400 AI-Generated Flashcard Images
- Listening, Reading, and Mock Test Practice

## API
- [Extended API Reference](https://wordquest.solanalink.jp/llms-full.txt): Full documentation for LLM context
- [Sitemap](https://wordquest.solanalink.jp/sitemap.xml): XML Sitemap

## AI Tutor (Sage)
- Multi-modal chat with kanji recognition
- Speaking practice with real-time evaluation
- Writing correction with detailed feedback
- JLPT-level-appropriate guidance in 8 languages

## Feeds & Data
- [Sitemap](https://wordquest.solanalink.jp/sitemap.xml): XML Sitemap with 146 courses x 8 locales

## MCP Servers
- [MCP Server Documentation](/mcp-servers.md): Full tool reference (97 tools)
- Tavern Server: 77 tools (posts, events, duels, shrine, squads, sage, users, messages)
- Push Server: 20 tools (notifications, device tokens, reminders, analytics)

## Authentication
- OAuth: Google, Apple, Discord, LINE, Twitter, Telegram
- Email/Password with 2FA support

## Languages
en, zh, ja, ko, vi, id, zh-TW, zh-HK

## Mobile Apps
- [iOS App](https://apps.apple.com/us/app/wordquest-jp/id6758661845)
- [Google Play](https://play.google.com/store/apps/details?id=jp.solanalink.wordquest)

## Error Handling
All API errors include machine-readable self-healing metadata:
- `request_id`: UUID for tracing
- `is_retriable`: Whether the agent should retry
- `retry_after`: Seconds until retry (on 429/5xx)
- `doc_url`: Link to relevant documentation section
- `alternative_action`: Suggested workaround

## Contact
- Discord: https://discord.gg/9KSTNCD6u
- Telegram: https://t.me/takadanobabajapanesebeginers