Mindvalley Products MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with structured access to Mindvalley's educational offerings, including products, masterclasses, programs, and certifications.

✨ Features

🚀 4 MCP Tools - Access products, masterclasses, programs, and certifications
🔒 Read-Only & Safe - Non-destructive operations with static data
⚡ Fast Performance - No external API calls, instant responses
🎯 Smart Filtering - Optional parameters for targeted queries
🔧 Easy Integration - Works with Claude Desktop, Cursor IDE, and custom clients
📚 Complete Documentation - Comprehensive examples and guides

🚦 Quick Start

Installation

# Install globally for easy access
npm install -g mindvalley-products-mcp

# Or install locally in your project
npm install mindvalley-products-mcp

Usage with Claude Desktop

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "mindvalley-products": {
      "command": "npx",
      "args": ["mindvalley-products-mcp"]
    }
  }
}

Restart Claude Desktop and start asking questions like:
- "What products does Mindvalley offer?"
- "Show me masterclasses with Jim Kwik"
- "What programs are in the Mind category?"

🛠️ Available Tools

1. products - Mindvalley Core Products

Get information about Mindvalley's subscription products and pricing.

// Get all products
products();

// Get specific product
products({ name: "Mindvalley Membership" });

Response includes: Product names, descriptions, pricing (monthly/annual), checkout URLs

2. masterclasses - Free Masterclasses

Access current Mindvalley masterclasses with registration links.

// Get all masterclasses
masterclasses();

// Filter by title
masterclasses({ title: "Superbrain" });

Response includes: Masterclass titles, hosts, descriptions, registration URLs

3. programs - Educational Programs

Browse Mindvalley's learning programs organized by category.

// Get all programs (by category)
programs();

// Get programs in specific category
programs({ category: "Mind" });

Available categories: Mind, Body, Soul, Career, Entrepreneurship, Relationships, Parenting

4. certifications - Coaching Certifications

Information about Mindvalley's professional certifications.

// Get all certifications
certifications();

// Filter by name
certifications({ name: "Life Coach" });

Response includes: Certification names, providers, duration, requirements, signup URLs

📖 Integration Guides

💡 Example Use Cases

Personal Learning Planning

User: "I want to improve my memory and focus. What does Mindvalley offer?"

AI Response: Based on your interests, I found several relevant options:

Masterclass (Free): Superbrain Masterclass with Jim Kwik - "Unlock Your Memory & Brain Power"

Program: Superbrain by Jim Kwik - Full program for memory improvement

Also relevant: "Becoming Focused and Indistractable" by Nir Eyal in the Career category

Product Comparison

User: "Compare Mindvalley Membership vs Membership Pro"

AI Response: Here's the comparison:

Mindvalley Membership ($499/year or $99/month)

All-access subscription to 100+ quests and meditations

Mindvalley Membership Pro ($698/year only)

Everything in Membership plus live coaching sessions

Additional $199/year for live coaching access

Certification Research

User: "I want to become a certified coach. What options does Mindvalley have?"

AI Response: Mindvalley offers several coaching certifications through Evercoach:

Certified Life Coach (4 months) - $200 refundable deposit Certified Business Coach (4 months) - For corporate/executive coaching Certified Hypnotherapist (16 weeks) - Led by Paul McKenna

🔧 Development

Local Development

# Clone the repository
git clone https://github.com/mazemax/mindvalley-products-mcp.git
cd mindvalley-products-mcp

# Install dependencies
pnpm install

# Build the server
pnpm run build

# Run tests
pnpm test

# Start development mode (with hot-reload)
pnpm run dev

Project Structure

mindvalley-products-mcp/
├── src/
│   ├── tools/              # MCP tool implementations
│   │   ├── products.ts
│   │   ├── masterclasses.ts
│   │   ├── programs.ts
│   │   └── certifications.ts
│   └── resources/          # Static data source
│       └── mindvalley_data.json
├── examples/               # Integration examples
│   ├── claude-desktop/
│   ├── cursor/
│   └── mcp-client/
├── dist/                   # Built server files
└── docs/                   # Additional documentation

Adding New Tools

Create a new file in src/tools/
Export schema, metadata, and default function
XMCP automatically discovers and registers the tool

import { z } from "zod";
import data from "../resources/mindvalley_data.json";

export const schema = {
  filter: z.string().optional().describe("Filter parameter"),
};

export const metadata = {
  name: "new-tool",
  description: "Description of what the tool does",
  annotations: {
    title: "New Tool",
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
  },
};

export default async function newTool({ filter }: { filter?: string }) {
  // Implementation
  return { content: [{ type: "text", text: JSON.stringify(result) }] };
}

🔍 Troubleshooting

Common Issues

❌ "Command not found: mindvalley-products-mcp"

# Verify installation
npm list -g mindvalley-products-mcp

# Reinstall if needed
npm install -g mindvalley-products-mcp

❌ "Server failed to start"

# Check Node.js version (requires >=20.0.0)
node --version

# Test the server directly
npx mindvalley-products-mcp

# Check for error messages in AI assistant logs

❌ "Tools not available in AI assistant"

Restart your AI assistant after configuration changes
Verify JSON syntax in MCP configuration file
Check that the server path is correct

Testing the Server

Test the server independently before integration:

# Test if server starts correctly
npx mindvalley-products-mcp

# Run the test suite
cd examples/mcp-client
node example.js

Configuration Validation

Verify your MCP configuration:

# Check Claude Desktop config
cat "~/Library/Application Support/Claude/claude_desktop_config.json" | jq

# Test configuration syntax
node -e "console.log(JSON.parse(require('fs').readFileSync('config.json')))"

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Quick Contribution Steps

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make your changes and add tests
Run tests: pnpm test
Commit: git commit -m 'Add amazing feature'
Push: git push origin feature/amazing-feature
Open a Pull Request

Types of Contributions

🐛 Bug fixes - Fix issues and improve stability
✨ New features - Add new tools or enhance existing ones
📖 Documentation - Improve guides and examples
🧪 Tests - Add or improve test coverage
🔄 Data updates - Keep Mindvalley information current

📊 Data Source

All data is sourced from publicly available Mindvalley information and stored in src/resources/mindvalley_data.json. The data includes:

Products: Official pricing and checkout URLs
Masterclasses: Current free masterclass offerings
Programs: Categorized learning content
Certifications: Professional certification programs

Note: Data is static and updated manually. For the most current information, always verify with official Mindvalley sources.

🛡️ Security & Privacy

No API Keys: No external API calls or authentication required
Public Data Only: Contains only publicly available information
No User Data: No personal information is collected or stored
Safe Operations: All tools are read-only and non-destructive

For security concerns, please see our Security Policy.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

NPM Package: https://www.npmjs.com/package/mindvalley-products-mcp
GitHub Repository: https://github.com/mazemax/mindvalley-products-mcp
Issue Tracker: https://github.com/mazemax/mindvalley-products-mcp/issues
MCP Protocol: https://modelcontextprotocol.io
Mindvalley: https://www.mindvalley.com

🙏 Acknowledgments

Model Context Protocol - For the excellent protocol specification
XMCP Framework - For the development framework
Mindvalley - For the educational content (this is an unofficial project)
Community - For feedback, contributions, and support

Made with ❤️ by Max Saad

This is an unofficial project and is not affiliated with or endorsed by Mindvalley.

mindvalley-products-mcp

Documentation