CourseForge

Build and manage courses on Caring CourseForge via the MCP client.

Source: npm — courseforge-mcp-client Publisher: Caring Consulting Co (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:

node scripts/courseforge.mjs \x3Ctool_name> '\x3Cjson_args>'

The script requires COURSEFORGE_API_KEY in the environment (set via gateway env or shell profile).

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

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