Mindvalley Products Mcp

Mindvalley Products MCP Server

[npm version] [License: MIT] [Node.js CI]

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 accessnpm install -g mindvalley-products-mcp
# Or install locally in your projectnpm install mindvalley-products-mcp

Usage with Claude Desktop

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

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

2. 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 productsproducts();
// Get specific productproducts({ 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 masterclassesmasterclasses();
// Filter by titlemasterclasses({ 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 categoryprograms({ category: "Mind" });

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

4. certifications - Coaching Certifications

Information about Mindvalley's professional certifications.

// Get all certificationscertifications();
// Filter by namecertifications({ name: "Life Coach" });

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

📖 Integration Guides

Claude Desktop

Detailed setup guide: examples/claude-desktop/README.md

Cursor IDE

Integration instructions: examples/cursor/README.md

Custom MCP Client

Programmatic usage example: examples/mcp-client/README.md

💡 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 repositorygit clone https://github.com/mazemax/mindvalley-products-mcp.gitcd mindvalley-products-mcp
# Install dependenciespnpm install
# Build the serverpnpm run build
# Run testspnpm 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

1. Create a new file in src/tools/
2. Export schema, metadata, and default function
3. 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 installationnpm list -g mindvalley-products-mcp
# Reinstall if needednpm install -g mindvalley-products-mcp

❌ "Server failed to start"

# Check Node.js version (requires >=20.0.0)node --version
# Test the server directlynpx 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 correctlynpx mindvalley-products-mcp
# Run the test suitecd examples/mcp-clientnode example.js

Configuration Validation

Verify your MCP configuration:

# Check Claude Desktop configcat "~/Library/Application Support/Claude/claude_desktop_config.json" | jq
# Test configuration syntaxnode -e "console.log(JSON.parse(require('fs').readFileSync('config.json')))"

🤝 Contributing

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

Quick Contribution Steps

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes and add tests
4. Run tests: pnpm test
5. Commit: git commit -m 'Add amazing feature'
6. Push: git push origin feature/amazing-feature
7. 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.