Skool Server

An MCP (Model Context Protocol) server for interacting with Skool.com communities.

Overview

Skool doesn't have a public API, so this MCP uses authenticated HTTP requests to Skool's internal API endpoints (reverse-engineered from the web app).

Setup

1. Install & Build

cd /mnt/c/projects/skool-mcp   # or wherever you cloned it
npm install
npm run build

2. Configure Skool Auth

Create ~/.config/skool-mcp/config.json:

{
  "cookies": "your-skool-session-cookies-here",
  "defaultCommunity": "ai-agent-academy-6994",
  "baseUrl": "https://www.skool.com"
}

Getting cookies: Open Skool in Chrome → DevTools → Application → Cookies → copy the auth_token value. The cookies field should be: auth_token=YOUR_JWT_HERE

3. Configure Claude Code

Add to your .mcp.json (in your project root or ~/.claude/.mcp.json for global):

{
  "mcpServers": {
    "skool": {
      "command": "node",
      "args": ["/mnt/c/projects/skool-mcp/dist/index.js"],
      "env": {}
    }
  }
}

4. Configure mcporter (OpenClaw)

mcporter add skool --command "node /mnt/c/projects/skool-mcp/dist/index.js" --transport stdio

Then call tools via:

mcporter call skool "skool.request" method="GET" path="/api/v1/..."

Authentication

Uses session cookies from an authenticated Skool session. The auth_token JWT is httpOnly and long-lived (expires ~1 year).

Tools

Discovery

• skool.request — Make arbitrary authenticated requests to Skool (for API exploration)

Community

• skool.community.info — Get community details (name, description, member count, settings)

Members

• skool.members.list — List members of a community
• skool.members.pending — List pending membership requests
• skool.members.approve — Approve a pending member
• skool.members.reject — Reject a pending member

Posts

• skool.posts.list — List posts in a community (with category filter, pagination)
• skool.posts.get — Get a specific post with comments
• skool.posts.create — Create a new post
• skool.posts.comment — Comment on a post

Classroom

• skool.courses.list — List courses
• skool.lessons.list — List lessons in a course

Notifications

• skool.notifications — Get recent notifications

API Notes

• Read operations use Next.js data routes (/_next/data/{buildId}/...). The buildId is fetched dynamically.
• Write operations use api2.skool.com REST endpoints.
• A User-Agent header is required (CloudFront blocks bare requests with 403).
• See API-DISCOVERY.md for detailed endpoint documentation and response shapes.