# OpenClassrooms MCP > OpenClassrooms MCP Server gives you full visibility into student records, course catalogs, and diploma progress through a single AI agent connection. Search for courses by keyword, track individual enrollment status, review mentoring session schedules, list all available degree paths, and verify certificates instantly—all without leaving your workflow. ## Overview - **Category:** human-resources - **Price:** Free - **Tags:** course-management, student-tracking, certification, learning-analytics, mentoring ## Description You connect your OpenClassrooms partner account directly to your AI client. This server gives you full visibility into student progress, course catalogs, and diploma paths without switching screens or jumping through dashboards. You'll have all the data you need right where you are working. **Student Status and Progress Tracking** `lister_etudiants` pulls a complete list of every student registered under your partner key. `progression_etudiant` checks an individual student’s precise progress metrics, showing their percentage completion and whether they've validated required projects against their current diploma path. You can also use `certificats_etudiant` to verify if a student earned a specific certificate just by providing their public verification ID. **Course Discovery and Curriculum Deep Dives** If you need to find what students are learning, start with `rechercher_cours`. This tool dynamically searches the entire catalog based on keywords—think 'Python data science' or 'React development.' When that general search isn't enough, `consulter_cours` pulls deep, detailed information for one specific course, including its full syllabus and required skill competencies. To see everything available, run `lister_cours`, which lists every single class on OpenClassrooms, handling all the pagination so you don't miss anything. **Program Mapping and Career Paths** When mapping out career options for a student, you can use `lister_parcours` to list every diploma program available. If you need specifics on one track—like what courses or projects are required for the Master’s degree in Data Science—you'll run `consulter_parcours`. This shows the complete academic structure and requirements needed to finish that specific path. **Administrative Tools and Scheduling** For scheduling, you can check out `sessions_mentorat`, which lists all scheduled video mentoring sessions, providing dates and mentor names. If you're managing student cohorts, remember that `lister_etudiants` always pulls the full manifest of everyone under your account key. **How It Works for You** It's straightforward: Tell your AI agent exactly what you need—for instance, 'What's John Doe's progress in his data science track?' or 'List all courses related to cloud computing.' Your agent runs the necessary tools (`progression_etudiant` and `rechercher_cours`) and presents the raw, actionable data immediately. You don't have to guess which dashboard holds the answer; your AI client just gets it for you. ## Tools ### lister_cours Lists every available course on OpenClassrooms. (Includes pagination handling). ### consulter_cours Retrieves deep, detailed information for one specific course, including its full syllabus. ### rechercher_cours Dynamically searches and returns courses based on specific keywords (e.g., 'Python data science'). ### lister_parcours Lists every degree path available on OpenClassrooms. ### consulter_parcours Shows the complete academic structure and requirements for a single diploma path. ### lister_etudiants Retrieves a list of all students enrolled under your specific partner API key. ### progression_etudiant Checks the precise, detailed progress metrics for a single student against their diploma track. ### sessions_mentorat Lists scheduled video mentoring sessions, including dates and mentor names. ### certificats_etudiant Checks success certificates earned by a student using their verification ID. ## Prompt Examples **Prompt:** ``` Search for courses about Python data analysis. ``` **Response:** ``` Found 8 courses matching 'Python data analysis'. Top results: 1) 'Analyze Your Data with Python' (Beginner, ~10h). 2) 'Use Python Libraries for Data Science' (Intermediate, ~15h). 3) 'Clean Your Data with Python' (Beginner, ~8h). Want me to open the full syllabus for any of these? ``` **Prompt:** ``` How is Maria Silva progressing in her diploma path? ``` **Response:** ``` Maria Silva — Path: 'Web Developer' (12 courses total). Progress: 75% complete (9/12 courses finished). Currently on: 'Build a Responsive Website with HTML & CSS'. 2 projects validated, 1 project pending review. Next mentoring session: April 3 at 14:00. She's on track to finish by May 15. ``` **Prompt:** ``` Which students have earned certificates this month? ``` **Response:** ``` 3 students earned certificates in March. Alex Chen — 'Data Analyst' path completed (Cert ID: OC-2024-8834). Julia Martinez — 'Product Manager' path completed (Cert ID: OC-2024-8901). Tom Nguyen — 'Front-End Developer' path completed (Cert ID: OC-2024-8955). All certificates are publicly verifiable. ``` ## Capabilities ### Check a student’s current status Provides detailed metrics on an individual student, including percentage completion and project validation status against their assigned diploma path. ### Find specific course curricula Allows you to search the entire catalog by keyword (e.g., 'React') or view a deep syllabus for any given class. ### List all enrolled students Retrieves a manifest of every student registered under your partner account's API key. ### Verify professional credentials Confirms if a student earned a certificate, using their public verification ID to pull official records. ### Map out career options Displays the full structure and requirements for all available diploma programs offered by OpenClassrooms. ## Use Cases ### HR Compliance Audit An HR compliance officer needs to verify that 30 employees completed their 'Data Analyst' certification by Q2. They tell their agent, "Check all certifications for the Data Analyst path.". The agent runs `certificats_etudiant` and returns a clean list of IDs, completion dates, and verification status for every required employee. ### Training Manager Onboarding A manager is onboarding a new team. They ask the agent to "Show me all Python courses and how they fit into the 'Web Developer' path." The agent runs `lister_cours` and then uses `consulter_parcours`, combining the data into one readable view, saving hours of manual research. ### Identifying Skill Gaps The academic team needs to update a curriculum. They ask the agent to "List all available courses and which skills they cover." The agent calls `lister_cours` and then uses `consulter_parcours`, allowing them to identify gaps between current offerings and needed competencies. ### Checking Student Status Before Mentoring A mentor needs to prepare for a meeting with Julia. They ask the agent, "What is Julia's last project status?" The agent runs `progression_etudiant`, showing if her current project is validated or still pending review before they even start talking. ## Benefits - **Know who's in the system:** Use `lister_etudiants` to get a complete roster of every person enrolled under your partner account instantly. No more manual spreadsheet checks. - **Pinpoint curriculum details:** Need to know exactly what skills are taught? Call `consulter_cours` or use `rechercher_cours` to pull the full syllabus and competencies for any class. - **Audit credentials fast:** Verifying a student's completion is simple. Just call `certificats_etudiant` with their public ID, and you get an instant status report. - **Map out career routes:** Don't guess at skills. Call `lister_parcours` to see the entire catalog of degree paths and what courses they require. - **Track granular progress:** Instead of just a percentage, `progression_etudiant` shows *where* a student is—which project is next and if it's pending review. ## How It Works The bottom line is that your AI client talks to our server, which pulls specific student and course data from OpenClassrooms without you needing to navigate any websites. 1. Subscribe to this server on Vinkius, then enter your OpenClassrooms Partner API Key. 2. Your AI client sends a natural language request (e.g., 'What is the status for student X?'). 3. The agent invokes the appropriate tool (`progression_etudiant` or `certificats_etudiant`) and passes you the structured data. ## Frequently Asked Questions **How do I check an employee's progress using progression_etudiant?** You must provide the student's unique ID and specify which diploma path you are tracking. This tool gives detailed metrics like project validation counts, not just a single percentage. **What is the difference between lister_cours and rechercher_cours?** Use `lister_cours` when you want to see every course available on OpenClassrooms. Use `rechercher_cours` when you know a keyword (like 'data science') and only want to filter results by that term. **How do I find out what degree paths are offered?** You call the `lister_parcours` tool. This gives you the full catalog of all available career tracks, which you can then drill into using `consulter_parcours` for details. **Can I check if a student is enrolled at all?** Yes, call `lister_etudiants`. This lists every single person associated with your partner key and gives you their basic enrollment status. **When I run `consulter_cours`, what specific data points do I get?** The tool provides a deep syllabus breakdown, listing all mandatory skill competencies for that course. Beyond just the name and duration, you receive structured curriculum details showing required knowledge areas. **If I use an invalid ID with `certificats_etudiant`, what does the API return?** It returns a specific validation error message indicating that the certificate ID is not found or doesn't match the expected format. The response structure details exactly what credentials are required for verification. **How do I check available mentor sessions using `sessions_mentorat`?** You can filter the results by date, mentor name, or status (e.g., 'upcoming'). The tool lists all scheduled video sessions and notes if a session is full or requires pre-registration. **What credentials do I need for `lister_etudiants`?** You must use your OpenClassrooms Partner API Key. This key needs explicit read access to student records and it’s mandatory for listing any enrolled students under the partner account. **Can I track completion rates across my entire team at once?** Yes. List all students associated with your partner API key, then ask your agent to summarize each student's completion percentage and pending projects. Get a full team progress report in a single conversation — no spreadsheets, no manual exports from the OpenClassrooms dashboard. **What data do I get about mentoring sessions?** The agent pulls session date, time, mentor name, session status (completed, scheduled, or missed), and the student linked to each session. This is useful for auditing mentorship quality and identifying students who are missing their scheduled sessions. **Is this API available to everyone or only to OpenClassrooms partners?** The OpenClassrooms API is restricted to approved partners. You need an active partnership agreement with OpenClassrooms to obtain production API credentials. If you're already a partner, your account manager can provide the API key. This integration is designed for organizations using OpenClassrooms for team training.