courseforge

# CourseForge Build and manage courses on [Caring CourseForge](https://caringcourseforge.com) via the MCP client. **Source:** [npm — courseforge-mcp-client](https://www.npmjs.com/package/courseforge-mcp-client) **Publisher:** Caring Consulting Co ([caringcos.com](https://caringcos.com)) ## Setup 1. Install: `npm install -g courseforge-mcp-client` 2. Set `COURSEFORGE_API_KEY` in your environment: - Get your key: caringcourseforge.com → Settings → API Keys - **Store securely** via your gateway environment config or shell profile (`export COURSEFORGE_API_KEY=cf_prod_...`). Do not store API keys in plaintext workspace files. 3. Verify: `courseforge-mcp` starts without errors ## Calling Tools Use the wrapper script to call any of the 89 CourseForge tools: ```bash node scripts/courseforge.mjs <tool_name> '<json_args>' ``` The script requires `COURSEFORGE_API_KEY` in the environment (set via gateway env or shell profile). ```bash node scripts/courseforge.mjs list_courses '{}' ``` Output is clean JSON (the MCP envelope is stripped automatically). ## Available Tools (89) - **Courses** (7): `list_courses`, `create_course`, `get_course`, `update_course`, `delete_course`, `get_course_settings`, `update_course_settings` - **Modules** (5): `create_module`, `update_module`, `delete_module`, `reorder_modules`, `get_module` - **Lessons** (7): `create_lesson`, `get_lesson`, `update_lesson`, `delete_lesson`, `reorder_lessons`, `move_lesson`, `duplicate_lesson` - **Content Blocks** (6): `add_content_block`, `get_content_block`, `update_content_block`, `delete_content_block`, `reorder_content_blocks`, `move_content_block` - **Course Management** (3): `validate_course`, `duplicate_module`, `export_course` - **Knowledge Library** (5): `list_collections`, `create_collection`, `list_documents`, `delete_document`, `search_knowledge` - **AI & Generation** (26): `ai_chat_assistant`, `ai_chat_with_research`, `generate_course_outline`, `generate_lesson_content`, `generate_quiz_from_content`, `generate_image`, `generate_job_aid_pdf`, `suggest_improvements`, `auto_fix_quality_issues`, `translate_content`, `summarize_document`, `convert_document_to_pdf`, `analyze_image`, `marketing_support_chat`, `web_search`, `fetch_url_content`, `get_youtube_metadata`, `get_youtube_captions`, `scrape_web_to_knowledge`, `upload_to_knowledge`, `manage_knowledge_files`, `search_user_media`, `list_storage_files`, `delete_storage_file`, `get_storage_usage`, `get_openapi_spec` - **Search & Media** (2): `search_stock_media`, `search_youtube` - **Recordings** (1): `list_recordings` - **API Keys** (3): `list_api_keys`, `create_api_key`, `revoke_api_key` - **Skills** (2): `list_skills`, `get_skill` - **Agentic UI Control** (22): `lock_canvas`, `unlock_canvas`, `refresh_canvas`, `notify_user`, `show_progress`, `request_confirmation`, `request_choice`, `scroll_to_element`, `select_element`, `expand_sidebar_item`, `focus_content_block`, `get_canvas_state`, `open_preview`, `close_preview`, `open_settings`, `toggle_sidebar`, `create_checkpoint`, `rollback_to_checkpoint`, `list_checkpoints`, `add_annotation`, `remove_annotation`, `highlight_issues` For full parameter details on any tool, read `references/tools.md`. ## Common Workflows ### Create a course from scratch 1. `create_course` — title, description, difficulty (beginner/intermediate/advanced) 2. `create_module` — for each section, pass courseId 3. `create_lesson` — for each lesson, pass courseId + moduleId 4. `add_content_block` — add text, images, quizzes to lessons 5. `validate_course` — check quality and accessibility 6. `export_course` — export to SCORM 1.2, SCORM 2004, xAPI, or HTML ### AI-powered course generation 1. `generate_course_outline` — provide topic, audience, difficulty → get full structure 2. `create_course` + `create_module` + `create_lesson` — build the structure from the outline 3. `generate_lesson_content` — auto-generate content for each lesson 4. `generate_quiz_from_content` — create assessments from lesson content 5. `suggest_improvements` — get AI suggestions for quality 6. `auto_fix_quality_issues` — automatically fix issues ### Use domain skills for specialized content 1. `list_skills` — see all 17 available specialist skills 2. `get_skill` — load a skill (e.g., "Instructional Designer", "HR Specialist") 3. Use the skill context when generating content with `ai_chat_assistant` ### Export a course ```bash node scripts/courseforge.mjs export_course '{"courseId":"xxx","format":"scorm12"}' ``` Formats: `scorm12`, `scorm2004`, `xapi`, `html` ### Content block types When using `add_content_block`, the `type` field accepts: - `text` — Rich text/HTML content - `image` — Image with URL and alt text - `video` — Embedded video (YouTube, Vimeo, URL) - `quiz` — Interactive quiz/assessment - `tabs` — Tabbed content sections - `accordion` — Collapsible sections - `callout` — Highlighted callout box - `divider` — Visual separator - `code` — Code block with syntax highlighting - `embed` — External embed (iframe) - `hotspot` — Interactive image hotspot - `flashcard` — Flashcard for review - `sortable` — Drag-and-drop sorting activity - `timeline` — Timeline visualization - `process` — Step-by-step process - `labeled_graphic` — Image with labels - `knowledge_check` — Quick knowledge check - `scenario` — Branching scenario ## Notes - All IDs are Firestore document IDs (alphanumeric strings) - Courses have a hierarchy: Course → Modules → Lessons → Content Blocks - The Knowledge Library stores reference documents that AI tools can use for generation - Agentic UI Control tools require the user to have the course editor open in their browser - Rate limits apply to AI generation tools based on the user's subscription tier