Wuolah MCP Server

Model Context Protocol server for Wuolah student outreach and content management. This tool enables Claude to interact with the Wuolah platform to post content, send messages, and find students in AI/ML programs.

Features

• Navigate to Wuolah and find AI/ML students
• Send bulk messages to students
• Post educational content to Wuolah
• Find relevant Wuolah degree and master programs
• Extract courses from program pages
• Comment on Wuolah posts
• Update your Wuolah profile

Installation

1. Ensure you have Node.js installed (version 18.0.0 or later)
2. Clone this repository
3. Install dependencies:

   npm install
   

Configuration

1. Copy .env.new to .env or create a new .env file with the following content:

   # Path to Chrome/Chromium executable
   CHROME_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome
   
   # Wuolah credentials
   WUOLAH_EMAIL=your_email@example.com
   WUOLAH_PASSWORD=your_password
   

2. Update the Chrome path to your actual Chrome installation path:

   • macOS: /Applications/Google Chrome.app/Contents/MacOS/Google Chrome
   • Windows: C:Program FilesGoogleChromeApplicationchrome.exe
   • Linux: /usr/bin/google-chrome

3. Set your Wuolah credentials in the .env file

Quick Setup

Run the setup script to copy the environment file, verify Chrome path, build the project, and register the MCP server:

node setup-env.js

Manual Setup

If you prefer to set up manually:

1. Build the project:

   npm run build
   

2. Register with Claude:

   npm run register
   

Troubleshooting

Chrome Executable Path

If you get the error An executablePath or channel must be specified for puppeteer-core, ensure your .env file has the correct path to your Chrome executable and that Chrome is actually installed at that location.

Environment Variables

Make sure the dotenv package is correctly loading your environment variables. Check that the .env file is in the project root directory and has the correct permissions.

File Permissions

If you encounter permission issues with the Chrome executable, you may need to add execute permissions:

chmod +x /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

Using with Claude

Once registered, you can use the Wuolah tools with Claude to:

1. Post educational content:

   wuolah_post_content({ target: "profile", content: { text: "Your post text", title: "Optional title", topic: "ai_basics" } })
   

2. Find AI/ML students:

   wuolah_navigate_and_find({ url: "https://wuolah.com/uem-escuela-arquitectura-ingenieria-diseno/master-inteligencia-artificial" })
   

3. Search for programs:

   wuolah_find_programs({ keywords: "inteligencia artificial", program_types: ["master"], university_tier: "private" })