🎭 Persona MCP - Advanced AI Persona Management System

World's First MCP Persona Marketplace with Smart Context Detection, Persona Chaining, and 80%+ Token Savings

An advanced persona management MCP server for Claude Desktop that revolutionizes how AI maintains specialized expertise while dramatically reducing token consumption.

✨ What is Persona MCP?

Persona MCP is a Model Context Protocol (MCP) server that allows you to:

• 🎯 Switch between 26 world-class expert personas on demand

• 🚢 Save 80%+ tokens with "Submarine Mode" (0 tokens until triggered)

• 🧠 Smart context detection - AI suggests the right persona automatically

• 🔗 Chain personas for multi-step workflows

• 🌍 Community marketplace - share and monetize your expertise

🚀 Key Features

Core Capabilities

• Submarine Mode: Zero token consumption by default

• Trigger-Based Activation: Load personas only when needed via @persona:name

• Individual File Management: Each persona stored as a .txt file

• Simple CRUD Operations: Create, update, delete personas with MCP tools

v2.0 Innovations

• 🧠 Smart Context Detection: AI analyzes conversation and suggests optimal persona

• 🔗 Persona Chaining: Execute multiple personas sequentially for complex tasks

• 📊 Usage Analytics: Track patterns and improve recommendations (local storage only)

• 🌟 Community Collection: 26 expert personas ready to use

💡 How Token Savings Work

Traditional Approach (System Prompt)

Persona MCP Approach

Result: 80%+ token savings in real-world usage

📦 Installation

Prerequisites

• Claude Desktop

• Node.js 18+

• npm or yarn

Steps

1. Clone and Install

2. Configure Claude Desktop

Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):

3. Restart Claude Desktop

🎯 Quick Start

1. Browse Community Personas

2. Install a Persona

3. Use the Persona

4. Smart Suggestions

🌟 Community Persona Collection

26 world-class expert personas included!

Innovation & Technology (5)

• innovation-expert - Innovation strategy and disruption analysis

• ai-engineer - AI/ML engineering and architecture

• fullstack-dev - Full-stack web development

• data-engineer - Data pipelines and infrastructure

• devops-engineer - DevOps, CI/CD, cloud infrastructure

Business & Strategy (6)

• business-mgmt - Business management and operations

• strategy-consultant - Strategic consulting and planning

• product-manager - Product management and roadmapping

• vp-innovation - VP of Innovation perspective

• disruptive-entrepreneur - Disruptive business models

• global-startup - Global startup strategy

Education & Learning (7)

• education-policy - Education policy and reform

• intl-education - International education systems

• student-mobility - Student mobility and exchange programs

• elite-tutor - Elite tutoring and exam preparation

• college-consultant - College admissions consulting

• university-president - University leadership perspective

• science-teacher - Science education

Analytics (2)

• business-analytics - Business data analysis

• education-analytics - Education data and metrics

Professional Services (2)

• harvard-law-dispute - Harvard Law School dispute resolution

• harvard-phd-negotiation - Harvard PhD-level negotiation

Example Personas (4)

• python-master - Python programming expert

• creative-writer - Creative writing and storytelling

• product-strategist - Product strategy

• ux-design-expert - UX design and user research

🛠️ Advanced Features

Persona Chaining

Execute complex multi-step workflows:

Use Cases:

• Code review → Documentation → Presentation

• Analysis → Summary → Executive brief

• Brainstorming → Structure → Final proposal

Usage Analytics

🔧 MCP Tools

Basic Tools

1. create_persona - Create new persona

2. update_persona - Modify existing persona

3. delete_persona - Remove persona

4. list_personas - List all available personas

Advanced Tools (v2.0)

5. suggest_persona - AI-powered persona recommendation

6. chain_personas - Sequential persona execution

7. get_analytics - View usage statistics

8. browse_community - Explore community collection

9. install_community_persona - One-click install from community

💡 Vision: Persona Marketplace

This is just the beginning! We're building the world's first MCP Persona Marketplace.

Roadmap

Phase 1 (Current): GitHub Community

• ✅ 26 free personas

• ✅ Open source (MIT)

• ✅ Community contributions

Phase 2 (In Development): Persona Hub Website

• 🚧 Web-based marketplace

• 🚧 Search and discovery

• 🚧 One-click installation

Phase 3 (Planned): Creator Economy

• 💰 Premium personas

• 💰 70/30 revenue sharing (Creator/Platform)

• 💰 Monetize your expertise

See VISION.md for details.

🤝 Contributing

We welcome contributions! Share your expertise with the community.

How to Contribute a Persona

1. Create persona following community examples

2. Include metadata (Author, Category, Version)

3. Submit via Persona Submission Issue

4. Or create a Pull Request

Revenue Sharing Promise

When Persona Hub launches:

• 70% to Creator

• 30% to Platform

• Minimum payout: $50/month

• Monthly transparent reports

See CONTRIBUTING.md for full details.

📚 Documentation

• VISION.md - Long-term vision and roadmap

• CONTRIBUTING.md - Contribution guidelines and revenue sharing

• Community Personas - Browse all 26 personas

🐛 Troubleshooting

MCP Server Not Showing

1. Completely quit and restart Claude Desktop

2. Check config file path: %APPDATA%\Claude\claude_desktop_config.json

3. Verify JSON syntax (commas, brackets)

Persona Not Activating

• Use exact format: @persona:name

• Check persona name spelling

• Run list_personas to see available personas

File Location Issues

Windows: C:\Users\YourName\.persona\ Mac/Linux: ~/.persona/

Note: Folder may be hidden (enable "Show hidden files" in Explorer)

📄 License

MIT License - See LICENSE for details

🙏 Acknowledgments

Built with:

• Model Context Protocol SDK by Anthropic

• docx for Word export

Special thanks to all community contributors!

🔗 Links

• GitHub: https://github.com/seanshin0214/persona-mcp

• Issues: https://github.com/seanshin0214/persona-mcp/issues

• Discussions: https://github.com/seanshin0214/persona-mcp/discussions

Created by: @seanshin0214 Version: 2.0.0 Last Updated: 2025-11-02

🎭 Join the Persona Revolution! ⭐ Star the repo to support the project!