Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Faroz MCP Create a beginner English course for 10-year-olds with 5 lessons."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Endpoint: https://faroz.uz/mcp · Docs: faroz.uz/faroz-mcp · Registry: uz.faroz/faroz · Auth: OAuth 2.0 (no API key)
Connect AI assistants (Claude, ChatGPT, Gemini and any MCP client) to Faroz, a learning platform for children aged 8–17. Teachers, parents and content authors use it to plan lessons, create learning content, run the lesson calendar, check students' homework and build age-appropriate habits by simply talking to the assistant.
Transport: Streamable HTTP. Auth: OAuth 2.0 with dynamic client registration — the client opens the Faroz sign-in page on first use.
Area | Capabilities |
Courses | Browse the catalog and your own courses, search, open full details (lessons, exercises, subject, level, age range). Create courses and edit title, description, subject, level, age range, tags and visibility. |
Lessons | Add lessons to a course, edit them, attach up to 5 exercises to each lesson (your own or other teachers' exercises found by ID, title, description or category), reorder the course plan, and switch on homework with a task text. |
Lesson calendar | See a course's schedule, move a lesson to another day or time, add an extra lesson, or change a group's weekly timetable. New lessons are placed on the calendar automatically. |
Homework review | List students' submissions, open one to see the task, the student's comment, the photos and the text of PDF / Word / PowerPoint files, then grade it (0–100) with feedback the student sees in the app, or send it back for rework. Grades feed the student's mastery. |
Student progress | See a course's students ranked by mastery (no phone numbers or emails). |
Interactive exercises | Turn any text, topic or lesson plan into ready-to-use exercises. Each exercise is checked against the Faroz format before saving, so it opens correctly in the mobile and web apps. |
Games | Browse game categories and games. Authors with the |
Library | Browse the subject tree and your media library (video, audio, images) to reuse in exercises, and write titles, descriptions and tags for your own media. |
Recommendations & strategies | Create recommendations with an age range and dates, and group them into strategies (e.g. "beating laziness") that children of the right age can follow step by step. |
Search | One search across courses, exercises, videos, audio, images, recommendations and strategies. |
Text multiple choice · picture multiple choice · fill in the blanks · typed answer · speak-aloud answer (speech recognition) · image · image gallery · audio · video · styled rich text · callout boxes (rules, examples, tips)
Layout blocks: column (blocks one under another — e.g. several blocks inside one callout) and row (2–3 blocks side by side with equal widths, on phones too).
Related MCP server: SafeNest MCP Server
Read-only: whoami, search, fetch, list_courses, get_course, get_course_filters, get_course_schedule, list_course_students, list_homework_submissions, get_homework_submission, list_exercises, get_exercise, get_exercise_usages, get_exercise_format_guide, validate_exercise_body, list_game_categories, list_games, list_media, list_subjects
Create: create_course, add_lesson, create_exercise, create_game, add_calendar_lesson, create_recommendation, create_strategy, add_strategy_recommendations
Edit (overwrites existing content): update_course, update_lesson, reorder_lessons, reschedule_lesson, set_group_schedule, update_exercise, update_game, update_media, review_homework, update_recommendation, update_strategy, reorder_strategy_stages
There are no delete tools and no payments: prices, subscriptions and wallets are never shown or changed through this server. Every call runs as the signed-in user, with exactly the same permissions as in the Faroz app. Homework tools work only for the course's staff (teacher, support teacher, course admin).
Every client gets the same course-authoring playbook automatically — no setup needed:
Server instructions tell the assistant to read it before creating a course.
Tool guide: get_exercise_format_guide(topics=["course_authoring"]) returns the full playbook (also the resource faroz://docs/exercise/course_authoring).
Prompt: create_course (arguments: topic, optional audience, lessons) — in Claude pick it from the prompt menu, in Gemini CLI run /create_course.
Tool results: create_course returns next_steps; create_exercise / update_exercise return validation_warnings (e.g. a test without a question, unstyled text) so the assistant fixes them.
Skill file: skills/faroz-course-builder/SKILL.md — upload it as a skill in Claude, or use it from the ChatGPT/Codex plugin.
What the playbook enforces: full course metadata and a banner, 4–6 lessons with 2–3 exercises each (theory → practice → test, final test at the end), all 11 content block types across the course (plus column / row layouts where they help), a question above every answer block, styled text and callouts, verified image/video/audio links, homework on 1–2 lessons, building with is_active=false and publishing only after a final check.
Students submit homework for a lesson in the Faroz app: images, audio, PDF, Word or presentations, up to 20 MB in total, plus an optional comment. Files are stored privately and served only through signed links that expire. Teachers review them in the app or with an AI assistant through this server.
Claude: Settings → Connectors → Add custom connector → URL https://faroz.uz/mcp → Connect → sign in with your Faroz account.
ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode → Create → MCP Server URL https://faroz.uz/mcp, Authentication: OAuth.
Claude Code
claude mcp add --transport http faroz https://faroz.uz/mcpCursor, VS Code, Windsurf and other mcp.json clients
{
"mcpServers": {
"faroz": { "url": "https://faroz.uz/mcp" }
}
}Gemini CLI
gemini extensions install https://github.com/Akramjon-koder/faroz-mcpAny MCP client: add a remote server with the URL https://faroz.uz/mcp. The client registers itself (RFC 7591), then opens the Faroz sign-in page (email/password or Google).
"Create a 5th-grade math course on fractions with 4 lessons and 2 exercises in each lesson."
"Make a beautiful course about the Solar System for 9–13 year olds." (the assistant follows the course playbook: banner, video, pictures, tests, homework)
"Here is a paragraph about the water cycle. Make a multiple-choice, a fill-in-the-blank and a typed-answer exercise from it, then add them to lesson 2."
"Open my fractions course, check every lesson's exercises for mistakes or unclear questions, and fix what you find."
"Show my courses and list the exercises in the first lesson."
"Check all homework waiting for review in my fractions course, grade each one and write short feedback for every student."
"Who are the top 5 students in my course by mastery?"
"Move tomorrow's lesson of my fractions course to Friday at 16:00."
"Build a 'beating laziness' strategy for 10–12 year olds from fitting recommendations and add one new daily recommendation for November."
A free Faroz account: sign up at faroz.uz. No API key is needed.
Possible next steps:
Per-student progress reports for teachers and parents
Help for students with their lessons and learning progress
The files in this repository (extension manifest, context file and skills) are released under the MIT License. The Faroz platform and the MCP server behind https://faroz.uz/mcp are proprietary services.
Privacy policy: https://faroz.uz/privacy
Terms: https://faroz.uz/terms
Support: akramjonminochdinov@gmail.com
This server cannot be deployed
Family calendars, tasks, reminders, and pickup coordination for your AI assistant.
Create, edit, translate, and export SCORM eLearning modules from a connected AI assistant.
Create, edit and publish Educaplay educational games and quizzes from any AI assistant.
