# tools4skool-mcp

[![npm](https://img.shields.io/npm/v/tools4skool-mcp)](https://www.npmjs.com/package/tools4skool-mcp)

An [MCP](https://modelcontextprotocol.io) server for [Tools4Skool](https://tools4skool.com). It lets Claude, Cursor and other MCP-compatible assistants read and manage your **Skool community**: members, churn risk, analytics, the post feed, DM sequences and member tags.

## Requirements

- A Tools4Skool account with your Skool community connected (via the Tools4Skool Chrome extension).
- An API key from <https://tools4skool.com/dashboard/developer>.
- Node.js 18+.

## Setup

### Claude Desktop / Cursor

Add this to your MCP config (`claude_desktop_config.json`, `.cursor/mcp.json`, ...):

```json
{
  "mcpServers": {
    "tools4skool": {
      "command": "npx",
      "args": ["-y", "tools4skool-mcp"],
      "env": { "SKOOL_TOOLS_API_KEY": "skt_your_key_here" }
    }
  }
}
```

### Claude Code

```bash
claude mcp add tools4skool -e SKOOL_TOOLS_API_KEY=skt_your_key_here -- npx -y tools4skool-mcp
```

## Tools

| Tool | What it does |
| --- | --- |
| `list_members` | List members, filter by status (active, cancelling, churned), paginated |
| `churn_risk` | Members most at risk of cancelling, with a high/medium/low breakdown |
| `get_analytics` | Total members, MRR, conversion rate, retention and growth |
| `get_posts` | Recent posts from your community feed |
| `list_sequences` | Auto-message sequences with trigger type, steps and enrollments |
| `get_member_tags` | Tags on a member |
| `tag_member` / `remove_tag` | Add or remove a tag on a member |
| `list_tags` | All tags in use |
| `send_dm` | Send a direct message to a member |

Most tools accept an optional `accountId` when you have more than one Skool community connected.

## Example prompts

- "Who in my community is most likely to cancel this month?"
- "Summarise my MRR and retention trend."
- "Tag everyone who is cancelling with `win-back`."

## Configuration

| Variable | Required | Description |
| --- | --- | --- |
| `SKOOL_TOOLS_API_KEY` | yes | Your Tools4Skool API key |
| `SKOOL_TOOLS_URL` | no | Override the API base URL (default `https://tools4skool.com`) |

## Links

- Website: <https://tools4skool.com>
- Skool community directory (tens of thousands of communities): <https://tools4skool.com/communities>

## License

MIT