Persona MCP
The Persona MCP server provides 142+ world-class expert personas for leadership problem-solving and strategic decision-making with 80%+ token savings through "Submarine Mode" activation.
Core Persona Management: Create, update, delete, and list custom personas with simple CRUD operations across 9 categories (Engineering, Design, Business, AI, Testing, Education, Science, Leadership, Legal).
Smart Features: AI-powered context detection automatically suggests optimal expert personas for your needs. Execute complex workflows by chaining multiple experts sequentially (e.g., code review → documentation → presentation). Track usage patterns with local-only analytics for improved recommendations.
Community Integration: Browse and install from 142 professionally curated personas organized with a 100-unit numbering system. Each includes comprehensive knowledge bases with production-ready code examples, frameworks, and best practices in multiple languages (Python, JavaScript, TypeScript, Swift, Kotlin, SQL, Bash).
Key Benefits: Zero-token consumption by default—personas only activate when triggered via @persona:name. Local-first privacy with no external API calls. Cross-platform support (Claude Desktop, Cursor, Windsurf, Cline). Completely free and open source (MIT License).
Provides access to a community collection of 142 expert personas hosted on GitHub, enabling browsing and installation of pre-built personas for various professional domains.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Persona MCPhelp me debug this Python function that's returning unexpected results"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🎯 World-Class Leadership Assistant Personas
142 World-Class+ Expert Personas for All Leaders' Problem Solving & Strategic Decision Making
모든 리더들의 문제 해결을 위한 142개 월드클래스+ 전문가 페르소나
🎉 NEW: Complete Professional Knowledge Base!
All 142 personas now include comprehensive, expert-level knowledge base documents!
📚 Real-world code examples (Python, JavaScript, Bash, SQL, Swift, Kotlin)
🎯 Production-ready best practices from industry experts
🔧 Step-by-step workflows and practical guides
💡 Domain-specific frameworks and methodologies
⚡ CLI commands & configurations (AWS, Azure, GCP, kubectl)
Not just prompts anymore! Each persona is backed by detailed, practical knowledge base documents that provide real expertise.
⭐ If you find this useful, please star this repository! It helps others discover these World-Class+ personas.
An advanced persona management MCP server that provides 142 World-Class+ expert personas to solve every leader's challenges. From strategic planning to technical implementation, access the right expert at the right time with 80%+ token savings.
✨ What is World-Class Leadership Assistant Personas?
A Model Context Protocol (MCP) server providing 142 World-Class+ expert personas to solve every leader's challenges:
🎯 Access 142 World-Class+ expert advisors on demand
🌟 All 142 personas World-Class+ certified - Evidence-based, innovation-oriented - Extensive experience and deep expertise
🚢 Save 80%+ tokens with "Submarine Mode" (0 tokens until triggered)
🧠 Smart context detection - AI suggests the right expert automatically
🔗 Chain multiple experts for comprehensive analysis
🌍 Professional expertise - from strategy to implementation
🚀 Key Features
Core Capabilities
Submarine Mode: Zero token consumption by default
Trigger-Based Activation: Load personas only when needed via
@persona:nameIndividual File Management: Each persona stored as a
.txtfileSimple CRUD Operations: Create, update, delete personas with MCP tools
v2.0+ Innovations
🧠 Smart Context Detection: AI analyzes conversation and suggests optimal expert
🔗 Expert Chaining: Execute multiple experts sequentially for complex decisions
📊 Usage Analytics: Track patterns and improve recommendations (local storage only)
🌟 World-Class+ Collection: 142 expert advisors ready to use (100% World-Class+ certified!)
🆕 All World-Class+ Standard: Evidence-based practices, disruptive questions, cross-disciplinary insights, ethical standards, continuous innovation
📂 Category-Based Organization: 9 categories with 100-unit numbering system
🔢 Smart Numbering: 100s=Engineering, 200s=Design, 300s=Business, 400s=AI, 500s=Testing, 600s=Education, 700s=Science, 800s=Leadership, 900s=Legal
⚡ Automation Scripts: Upgrade and numbering scripts included
💡 How Token Savings Work
Traditional Approach (System Prompt)
Every conversation: 500 tokens consumed
100 conversations: 50,000 tokens wasted
Even when expertise isn't neededLeader's Decision Making Assistants Approach
Default: 0 tokens (Submarine Mode)
When needed: @persona:name → Active only for that conversation
Next conversation: Back to 0 tokensResult: 80%+ token savings in real-world usage
📦 Installation
Prerequisites
Node.js 18+
npm or yarn
One of the supported IDEs: Claude Desktop, Cursor, Windsurf, or Cline
Steps
Clone and Install
git clone https://github.com/seanshin0214/world-class-leadership-personas.git
cd world-class-leadership-personas
npm install
npm run buildConfigure Your IDE
Choose your IDE and follow the configuration steps:
🖥️ Claude Desktop
Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (Mac):
{
"mcpServers": {
"persona": {
"command": "node",
"args": ["C:\\Users\\YourName\\Documents\\world-class-leadership-personas\\dist\\index.js"]
}
}
}Restart Claude Desktop to activate.
🔮 Cursor
Edit .cursor/config.json in your home directory:
{
"mcpServers": {
"persona": {
"command": "node",
"args": ["C:\\Users\\YourName\\Documents\\world-class-leadership-personas\\dist\\index.js"]
}
}
}Or use Cursor Settings UI:
Open Cursor Settings (⌘/Ctrl + ,)
Search for "MCP"
Add server with command:
nodeand args:[path to dist/index.js]
Restart Cursor to activate.
🌊 Windsurf (Codeium)
Edit Windsurf MCP configuration file:
Windows: %APPDATA%\Windsurf\mcp_config.json
Mac: ~/Library/Application Support/Windsurf/mcp_config.json
Linux: ~/.config/Windsurf/mcp_config.json
{
"mcpServers": {
"persona": {
"command": "node",
"args": ["C:\\Users\\YourName\\Documents\\world-class-leadership-personas\\dist\\index.js"]
}
}
}Restart Windsurf to activate.
🔧 Cline (formerly Claude Code)
Edit Cline MCP settings:
VS Code Settings > Extensions > Cline > MCP Servers
Add:
{
"persona": {
"command": "node",
"args": ["C:\\Users\\YourName\\Documents\\world-class-leadership-personas\\dist\\index.js"]
}
}Or edit .vscode/settings.json:
{
"cline.mcpServers": {
"persona": {
"command": "node",
"args": ["C:\\Users\\YourName\\Documents\\world-class-leadership-personas\\dist\\index.js"]
}
}
}Reload VS Code window to activate.
Verify Installation
In any supported IDE:
You: "List available personas"
AI: [Shows 142 personas organized by category]🎯 Quick Start
1. Browse Community Personas
You: "Browse community personas"
Claude: [Executes browse_community tool]
🌟 Community Persona Collection
Found 26 personas
## Innovation & Technology
- innovation-expert
- ai-engineer
- fullstack-dev
...2. Install a Persona
You: "Install innovation-expert persona"
Claude: [Executes install_community_persona]
✅ Persona "innovation-expert" installed successfully!3. Use the Persona
You: "@persona:innovation-expert Analyze our product's disruption potential"
Claude: [Activates innovation expert persona and analyzes]4. Smart Suggestions
You: "Explain quantum computing to a 10-year-old"
Claude: [Executes suggest_persona]
💡 Persona Suggestion
Recommended: @persona:science-teacher
Confidence: 85%
Reason: Educational context detected📚 Professional Knowledge Base
Every persona includes comprehensive knowledge base documents with real expertise!
What's Included
Each of the 142 personas has detailed documentation covering:
🔧 Practical Examples
Production-ready code snippets (Python, JavaScript, TypeScript, Swift, Kotlin, SQL, Bash)
Real-world workflows and step-by-step guides
CLI commands for major platforms (AWS, Azure, GCP, kubectl)
Configuration files and setup instructions
🎯 Domain Expertise
Industry-standard frameworks and methodologies
Best practices from leading companies
Common pitfalls and how to avoid them
Performance optimization techniques
💡 Actionable Insights
Decision-making frameworks
Troubleshooting guides
Resource recommendations (books, tools, courses)
Related competencies and skills
Example Knowledge Base Documents
Engineering & Development
101-software-engineer: Software Engineering & Architecture 2025
Design patterns, SOLID principles, system design
Code examples: Factory, Observer, Strategy patterns
Best practices: Code reviews, testing, documentation
106-mobile-developer: Mobile App Development 2025
iOS development with Swift/SwiftUI (state management, navigation, networking)
Android development with Kotlin/Jetpack Compose
Cross-platform with React Native
Production code examples for each platform
132-devops-engineer: DevOps, CI/CD & Infrastructure 2025
GitHub Actions, GitLab CI workflows
Docker multi-stage builds
Kubernetes deployments, services, ingress
Terraform infrastructure as code (AWS, Azure, GCP)
Prometheus + Grafana monitoring
Healthcare
701-physician: Clinical Medicine & Diagnosis 2025
Differential diagnosis frameworks
Treatment protocols by specialty
Clinical decision-making tools
Evidence-based medicine guidelines
710-nurse-practitioner: Advanced Practice Nursing & Primary Care 2025
Comprehensive health assessment (HPI, ROS, physical exam)
Common diagnoses: HTN, diabetes, hyperlipidemia, depression
Prescribing guidelines and antibiotic stewardship
Motivational interviewing and patient education
Business & Strategy
301-product-manager: Product Management & Strategy 2025
Product discovery frameworks
Prioritization methods (RICE, Kano, Value vs Effort)
Roadmap planning and stakeholder management
Metrics and analytics (AARRR, cohort analysis)
302-data-analyst: Data Analysis & Business Intelligence 2025
SQL queries for business analytics
Python data analysis with pandas/numpy
Tableau/Power BI dashboard design
Statistical analysis and A/B testing
Creative & Content
233-music-producer: Music Production & Audio Engineering 2025
DAW workflows (Ableton, FL Studio, Logic Pro)
Mixing and mastering techniques
Sound design and synthesis
Production-ready examples
313-content-creator: Content Creation & Social Media 2025
Platform strategy (YouTube, TikTok, Instagram)
Content calendar and batch creation
Brand partnerships and monetization
Engagement tactics and growth strategies
How to Access Knowledge Base
Browse on GitHub:
knowledge-base/{persona-id}/core-competencies/Ask the persona directly:
You: "@persona:132-devops-engineer Show me Kubernetes deployment best practices" AI: [References knowledge base and provides detailed guide]Explore by category: See PERSONA_CATEGORIES.md for full list
💡 Pro Tip: Each knowledge base document is 1000+ lines of expert-level content, making these personas truly professional-grade advisors!
🌟 Community Persona Collection
142 World-Class+ expert personas organized by category!
⭐ World-Class+ Standard (All 142 Personas)
Every persona now includes:
✅ Evidence-based practices from authoritative sources
✅ Disruptive questions to challenge assumptions
✅ Cross-disciplinary insights for holistic problem-solving
✅ Ethical standards and inclusive practices
✅ Continuous innovation mindset
📂 Category-Based Organization (v2.3.0)
All personas are now organized with a 100-unit numbering system for easy navigation:
100-199: 💻 Engineering & Development (30 personas)
200-299: 🎨 Design & Creative (23 personas) ← +1 UX Researcher ⭐NEW
300-399: 💼 Business & Strategy (35 personas) ← +1 Scrum Master ⭐NEW
400-499: 🤖 Data, AI & ML (10 personas) ← +2 LLM Engineer, AI Agent Developer ⭐NEW
500-599: 🧪 Testing & QA (2 personas)
600-699: 📚 Education & Training (24 personas)
700-799: 🔬 Science & Research (13 personas)
800-899: 👔 Leadership & Management (2 personas)
900-999: ⚖️ Legal & Advisory (3 personas)🆕 What's New in v2.3.0:
223-ux-researcher: User/UX Researcher (UK Gov Digital Service Framework)
337-scrum-master: Scrum Master (2020 Scrum Guide standards)
410-llm-engineer: LLM Engineer (Transformers, Prompt Engineering, Deployment)
411-ai-agent-developer: AI Agent Developer (Autonomous Systems, Multi-Agent)
📖 Full Catalog: See PERSONA_CATEGORIES.md for complete list
🏛️ The Council for Future Design (NEW!)
8 Executive-Level Advisory Personas for Strategic Decision-Making
The Council represents the pinnacle of business expertise - world-class advisors who have shaped Fortune 100 companies, led $15B+ deals, and transformed entire industries. Each brings 20+ years of experience and proven methodologies.
Strategic & Leadership (96-98)
96-strategic-oracle- 전략의 현자: MIT Systems Dynamics PhD, 15yr McKinsey Partner, WEF Advisor. 7-dimension macro analysis, 4th-gen scenario planning, Real Options valuation97-ethical-technologist- 윤리적 기술 설계자: Google AI Ethics Board founder, DeepMind Safety, IEEE P7000 Chair. AI fairness (LIME/SHAP), Zero Trust security, Differential Privacy98-governance-guardian- 거버넌스 수호자: Yale Law JD, 3x S&P 500 Board Chair, SEC Enforcement. Board optimization, CEO succession, crisis management (6-hour golden time)
People & Markets (99-100)
99-human-dynamics-architect- 인간 역학 설계자: Harvard Org Psych PhD, Google People Ops VP (Project Aristotle). ONA, psychological safety, generational integration, continuous performance (OKRs)100-market-experience-creator- 시장 경험 창조자: Stanford GSB, P&G Brand Director, Apple CX VP, Tesla CMO. Brand architecture, 15-20 touchpoint orchestration, Marketing Mix Modeling, D2C transformation
Execution & Growth (101-102)
101-execution-capital-alchemist- 실행 자본 연금술사: Wharton MBA, McKinsey Ops Partner, Goldman M&A MD, KKR/Blackstone. DCF/LBO modeling, Lean Six Sigma DMAIC, PMI 100-day plans, turnaround ($500M saved)102-agile-growth-architect- 민첩한 성장 설계자: Google X, Y Combinator Partner, 3x Unicorn founder, a16z. Product-Market Fit (Sean Ellis Test), AARRR funnel, viral growth (K-factor), 0→$10M ARR playbooks
Sustainability (108)
108-sustainability-policy-shaper- 지속가능성 정책 설계자: Harvard Kennedy MPA, UN SDG Officer, World Bank Green Bond, EU Climate Advisor. ESG materiality, Scope 1/2/3, Science-Based Targets, Net Zero roadmaps, PPP structures
When to Use the Council:
Complex strategic decisions requiring multiple perspectives
M&A integration, transformation, or turnaround scenarios
Balancing innovation, ethics, profitability, and sustainability
Building world-class teams, boards, and governance structures
Example Council Session:
You: "@persona:96-strategic-oracle Should we enter the AGI market given 2030 timeline?"
[Strategic Oracle analyzes with 4 scenarios, Real Options]
You: "@persona:97-ethical-technologist What are the AI ethics implications?"
[Ethical Technologist applies 3-filter framework, TCFD risks]
You: "@persona:101-execution-capital-alchemist What's the financial model?"
[Execution Alchemist builds LBO model, Unit Economics, IRR projections]Innovation & Technology (5)
innovation-expert- Innovation strategy and disruption analysisai-engineer- AI/ML engineering and architecturefullstack-dev- Full-stack web developmentdata-engineer- Data pipelines and infrastructuredevops-engineer- DevOps, CI/CD, cloud infrastructure
Business & Strategy (6)
business-mgmt- Business management and operationsstrategy-consultant- Strategic consulting and planningproduct-manager- Product management and roadmappingvp-innovation- VP of Innovation perspectivedisruptive-entrepreneur- Disruptive business modelsglobal-startup- Global startup strategy
Education & Learning (7)
education-policy- Education policy and reformintl-education- International education systemsstudent-mobility- Student mobility and exchange programselite-tutor- Elite tutoring and exam preparationcollege-consultant- College admissions consultinguniversity-president- University leadership perspectivescience-teacher- Science education
Analytics (2)
business-analytics- Business data analysiseducation-analytics- Education data and metrics
Professional Services (2)
harvard-law-dispute- Harvard Law School dispute resolutionharvard-phd-negotiation- Harvard PhD-level negotiation
Example Personas (4)
python-master- Python programming expertcreative-writer- Creative writing and storytellingproduct-strategist- Product strategyux-design-expert- UX design and user research
🛠️ Advanced Features
Persona Chaining
Execute complex multi-step workflows:
You: "Chain these personas: coder → teacher → professional"
Step 1 - coder: Code analysis and bug detection
Step 2 - teacher: Explain findings to beginners
Step 3 - professional: Create formal report
✅ Chain completed: 3/3 stepsUse Cases:
Code review → Documentation → Presentation
Analysis → Summary → Executive brief
Brainstorming → Structure → Final proposal
Usage Analytics
You: "Show persona analytics"
📊 Persona Usage Analytics
Usage count:
professional: 15 uses
coder: 12 uses
teacher: 8 uses
Top context patterns:
professional: business, report, meeting
coder: function, debug, implement
teacher: explain, understand, learn
💡 Data stored locally only (never transmitted)🔧 MCP Tools
Basic Tools
create_persona - Create new persona
update_persona - Modify existing persona
delete_persona - Remove persona
list_personas - List all available personas
Advanced Tools (v2.0)
suggest_persona - AI-powered persona recommendation
chain_personas - Sequential persona execution
get_analytics - View usage statistics
browse_community - Explore community collection
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
Create persona following community examples
Include metadata (Author, Category, Version)
Submit via Persona Submission Issue
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.
❓ FAQ
Does this cost money to use?
No API costs. Leader's Decision Making Assistants is completely free to use. Unlike AI Council MCP (which calls multiple AI APIs), Leader's Decision Making Assistants only manages text files on your local computer. It doesn't make any external API calls.
What you need:
✅ Claude Desktop (free or paid subscription)
✅ Node.js (free)
❌ No additional API keys required
❌ No pay-per-use costs
Cost structure:
Leader's Decision Making Assistants itself: $0 (open source, MIT License)
Running personas in Claude Desktop: Uses your existing Claude subscription
The personas are just text prompts that enhance Claude's behavior
Who pays for what?
You:
Your Claude Desktop subscription (if using Claude Pro)
No additional costs for Leader's Decision Making Assistants
Creator (@seanshin0214):
Does NOT pay for your Claude usage
Does NOT collect any fees
Provides this as free open-source software
Is this a cloud service or SaaS?
No. Leader's Decision Making Assistants runs entirely on your local computer.
How it works:
You download and install Leader's Decision Making Assistants on your computer
Personas are stored as
.txtfiles in~/.persona/folderWhen you type
@persona:name, it loads that text fileNo data sent to external servers
Everything stays on your machine
Do you collect any data?
No. Everything is local:
✅ Persona files stored locally (
~/.persona/)✅ Usage analytics stored locally (never transmitted)
✅ No telemetry, tracking, or data collection
✅ No central server to send data to
✅ Your privacy is 100% protected
How is this different from ChatGPT custom GPTs?
ChatGPT Custom GPTs:
Cloud-based, stored on OpenAI servers
Requires ChatGPT Plus ($20/month)
Limited to OpenAI ecosystem
Can be shared publicly (privacy concerns)
Leader's Decision Making Assistants:
Runs locally on your computer
Works with Claude Desktop (any tier)
Open source and fully customizable
100% private (never leaves your machine)
80%+ token savings with Submarine Mode
Community marketplace with revenue sharing
Will the marketplace charge for personas?
Current (Phase 1):
All 26 community personas are FREE
MIT License (open source)
Future (Phase 3 - Planned):
Premium personas may be offered by creators
70/30 revenue split (Creator gets 70%)
Free personas will always remain available
You choose what to download
If you contribute a persona now:
It's free and open source (MIT)
If marketplace launches, you're eligible for 70% revenue share on premium versions
See CONTRIBUTING.md for details
🌐 Use with ChatGPT (GPT + ngrok)
Want to use these personas in ChatGPT Custom GPTs?
You can expose your local MCP server via ngrok and connect it to ChatGPT Actions!
Quick Start
# 1. Start HTTP API server
node http-server.js
# 2. In another terminal, start ngrok
ngrok http 3000
# 3. Copy the ngrok URL and add to your GPT ActionsImportant: ngrok Free vs Paid
Feature | Free | Paid ($8/month~) |
URL | Changes every restart | Fixed domain |
GPT Actions update | Required every time | One-time setup |
Session limit | 2 hours | Unlimited |
Recommendation: For production use, ngrok paid plan is strongly recommended to avoid updating GPT Actions every time.
What You Get
Access all 142+ personas from ChatGPT
Real-time knowledge base search
Same expert-level responses as Claude Desktop
Works on mobile and web
Full Guide
See docs/GPT-NGROK-INTEGRATION.md for:
Complete setup instructions
OpenAPI schema for GPT Actions
Local-only options (ChromaDB/SQLite)
Security configuration
📚 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
Completely quit and restart Claude Desktop
Check config file path:
%APPDATA%\Claude\claude_desktop_config.jsonVerify JSON syntax (commas, brackets)
Persona Not Activating
Use exact format:
@persona:nameCheck persona name spelling
Run
list_personasto 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!
📢 Share & Support
Love this project? Help spread the word!
Ways to Support:
⭐ Star this repository on GitHub
🔀 Fork it and create your own personas
🐛 Report bugs or suggest features
📝 Contribute new personas or improvements
💬 Share with your network
📖 Write about your experience using it
🌟 Showcase
Using World-Class+ Personas in your project? We'd love to feature you!
Submit your use case via GitHub Discussions and we'll add it here.
Featured Projects:
Your project could be here! 🚀
🔗 Links
GitHub: https://github.com/seanshin0214/world-class-leadership-personas
Issues: https://github.com/seanshin0214/world-class-leadership-personas/issues
Discussions: https://github.com/seanshin0214/world-class-leadership-personas/discussions
Releases: https://github.com/seanshin0214/world-class-leadership-personas/releases
📊 Project Stats
Created by: @seanshin0214 Version: 2.0.0 Last Updated: 2025-11-02
🎭 Join the Persona Revolution! ⭐ Star the repo to support the project!
Available Tools
9 toolsbrowse_communityC
커뮤니티 페르소나 컬렉션을 탐색합니다 (GitHub에서 공유된 무료 페르소나)
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | 필터링할 카테고리 (선택사항): Programming, Creative, Business, Education, Design 등 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions the source (GitHub) and that personas are free, but fails to disclose key behavioral traits such as whether this is a read-only operation, if it requires authentication, rate limits, pagination, or what the output format looks like. For a tool with no annotations, this is a significant gap in transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that conveys the core purpose without unnecessary details. It is front-loaded and wastes no words, though it could benefit from slightly more structure (e.g., separating key points) for clarity.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations and output schema, the description is incomplete. It does not explain what the tool returns (e.g., list of personas, details), behavioral constraints, or how it integrates with sibling tools. For a tool with one parameter and no structured output, more context is needed to guide effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with the parameter 'category' fully documented in the schema. The description does not add any additional meaning or examples beyond what the schema provides (e.g., how categories affect browsing). Baseline score of 3 is appropriate as the schema handles parameter documentation adequately.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('browse') and resource ('community persona collection'), specifying that it's free personas shared on GitHub. It distinguishes from siblings like 'list_personas' by focusing on community rather than local personas, though not explicitly. However, it could be more specific about what 'browse' entails (e.g., searching or viewing).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives like 'list_personas' or 'suggest_persona'. The description implies usage for exploring community personas, but lacks context on prerequisites, exclusions, or comparisons with sibling tools, leaving the agent to infer usage scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
chain_personasC
여러 페르소나를 순차적으로 실행하여 단계별 처리를 수행합니다
| Name | Required | Description | Default |
|---|---|---|---|
| personas | Yes | 순차 실행할 페르소나 이름 배열 | |
| initialInput | Yes | 첫 번째 페르소나에 전달할 입력 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions sequential execution and step-by-step processing but doesn't describe what happens during execution (e.g., error handling, state persistence between personas, performance characteristics, or authentication requirements). This leaves significant gaps for a tool that appears to orchestrate multiple operations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Korean that communicates the core concept without unnecessary words. It's appropriately sized for what it does cover, though it could be more informative.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of orchestrating multiple personas, no annotations, and no output schema, the description is insufficient. It doesn't explain what the tool returns, how errors are handled, or what 'step-by-step processing' entails in practical terms, leaving the agent with inadequate information for proper use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 100% description coverage, so the parameters are well-documented in the structured schema. The description doesn't add any meaningful information about parameter usage beyond what's already in the schema descriptions, maintaining the baseline score of 3.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states the tool executes multiple personas sequentially for step-by-step processing, which provides a basic purpose. However, it's somewhat vague about what '페르소나' (personas) are in this context and doesn't distinguish this tool from sibling tools like 'create_persona' or 'update_persona' that also involve personas.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites, appropriate scenarios, or how it differs from other persona-related tools like 'suggest_persona' or 'list_personas'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
create_personaC
새로운 페르소나 프로필을 생성합니다
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | 페르소나 이름 (예: default, professional, casual) | |
| content | Yes | 페르소나 프롬프트 내용 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. While '생성합니다' (creates) implies a write/mutation operation, there's no information about permissions needed, whether creation is idempotent, what happens on duplicate names, or what the response contains. For a creation tool with zero annotation coverage, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that states the core functionality without any wasted words. It's appropriately sized for a simple creation tool and gets straight to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a creation tool with no annotations and no output schema, the description is too minimal. It doesn't address what happens after creation, whether there are validation rules, how the created persona can be used, or any error conditions. Given the complexity of persona management and the existence of multiple sibling tools, more context would be helpful.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so both parameters are well-documented in the schema itself. The description doesn't add any additional meaning about the parameters beyond what's already in the schema descriptions. This meets the baseline expectation when schema does the heavy lifting.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('새로운...생성합니다' - creates new) and resource ('페르소나 프로필' - persona profile), making the purpose immediately understandable. It doesn't distinguish from siblings like 'update_persona' or 'install_community_persona', but the verb+resource combination is specific enough for basic understanding.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to use this tool versus alternatives like 'update_persona', 'install_community_persona', or 'chain_personas'. The description simply states what the tool does without context about appropriate use cases or prerequisites for creating a persona.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delete_personaC
페르소나 프로필을 삭제합니다
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | 삭제할 페르소나 이름 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It states the tool deletes a persona profile, implying a destructive mutation, but doesn't cover critical aspects like whether deletion is permanent, requires specific permissions, has side effects, or what happens to associated data. This leaves significant gaps for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Korean that directly states the tool's purpose with zero wasted words. It's appropriately sized and front-loaded, making it easy to parse quickly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity as a destructive mutation with no annotations, no output schema, and incomplete behavioral disclosure, the description is inadequate. It fails to address key contextual elements like deletion permanence, error conditions, or return values, leaving the agent with insufficient information for safe and effective use.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema description coverage is 100%, with the single parameter 'name' documented as '삭제할 페르소나 이름' (name of the persona to delete). The description adds no additional meaning beyond what the schema provides, so it meets the baseline for high schema coverage without compensating value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('삭제합니다' - deletes) and the resource ('페르소나 프로필' - persona profile), providing a specific verb+resource combination. However, it doesn't differentiate from sibling tools like 'update_persona' or 'chain_personas' in terms of scope or effect, which prevents a perfect score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'update_persona' or 'list_personas', nor does it mention prerequisites or consequences. The description merely states what it does without contextual usage instructions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_analyticsB
페르소나 사용 통계를 조회합니다 (로컬 데이터만)
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions 'local data only', which adds some context about data scope, but doesn't disclose other behavioral traits like whether it's read-only (implied by '조회합니다' but not explicit), performance characteristics, error conditions, or return format. For a tool with zero annotation coverage, this is insufficient.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise - a single Korean sentence with a brief parenthetical clarification. Every word earns its place by stating the action and a key constraint. It's front-loaded with the main purpose and efficiently structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (analytics tool with no output schema and no annotations), the description is incomplete. It doesn't explain what statistics are returned, the format of the data, or any behavioral expectations beyond the local data scope. For a tool that presumably returns structured analytics data, this leaves significant gaps for an AI agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters, and schema description coverage is 100% (though empty). The description doesn't need to compensate for missing parameter documentation. It appropriately doesn't discuss parameters, so a baseline of 4 is warranted as it doesn't add or detract from parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('조회합니다' - retrieves/checks) and resource ('페르소나 사용 통계' - persona usage statistics), making the purpose understandable. It distinguishes itself from siblings by focusing on analytics rather than creation, deletion, or listing of personas. However, it doesn't explicitly differentiate from potential analytics siblings that might exist in other contexts.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides minimal guidance with the parenthetical '(로컬 데이터만)' - 'local data only', which implies a scope limitation. However, it doesn't specify when to use this tool versus alternatives like 'list_personas' for basic listing or other potential analytics tools. No explicit when-not-to-use or alternative tool references are provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
install_community_personaC
커뮤니티 페르소나를 로컬 컬렉션에 설치합니다
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | 설치할 커뮤니티 페르소나 이름 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden but offers minimal behavioral insight. It mentions installation into a local collection, hinting at a write operation, but lacks details on permissions, side effects, error conditions, or what 'installation' entails (e.g., copying, linking, or modifying).
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Korean that directly states the tool's purpose without redundancy. It's appropriately sized and front-loaded, with no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no annotations, no output schema, and a write-like operation ('install'), the description is incomplete. It lacks information on what happens after installation, potential conflicts, or how this tool interacts with siblings like 'create_persona' or 'list_personas'.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, with the single parameter 'name' documented as 'name of the community persona to install'. The description adds no additional parameter semantics beyond this, so it meets the baseline for high schema coverage without compensating value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('install') and target resource ('community persona'), specifying it's installed 'into the local collection'. However, it doesn't distinguish this from sibling tools like 'create_persona' or 'update_persona', which might have overlapping functionality.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives like 'create_persona' or 'browse_community'. The description implies installation from a community source, but it doesn't specify prerequisites, exclusions, or contextual triggers for selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_personasB
사용 가능한 모든 페르소나 목록을 조회합니다
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. While '조회합니다' implies a read operation, it doesn't specify whether this requires authentication, what format the list returns, whether there's pagination, or any rate limits. The description provides minimal behavioral context beyond the basic operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that directly states the tool's purpose without any wasted words. It's appropriately sized for a simple listing tool and gets straight to the point.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a zero-parameter listing tool with no output schema, the description provides the basic purpose but lacks important context. It doesn't describe what information is returned about each persona, whether the list is filtered or complete, or how this differs from similar tools. The absence of annotations means the description should do more to explain behavioral aspects.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has 0 parameters with 100% schema description coverage, so the baseline is 4. The description appropriately doesn't discuss parameters since none exist, and the empty input schema is self-explanatory for a simple listing operation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('조회합니다' - retrieves/views) and resource ('사용 가능한 모든 페르소나 목록' - list of all available personas). It distinguishes from siblings like create_persona or delete_persona by being a read operation. However, it doesn't explicitly differentiate from similar listing tools like browse_community or suggest_persona.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to use this tool versus alternatives. The description doesn't mention when this tool should be used instead of browse_community or suggest_persona, nor does it provide any context about prerequisites or appropriate situations for its use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
suggest_personaB
대화 컨텍스트를 분석하여 적합한 페르소나를 제안합니다 (트리거 시에만 활성화)
| Name | Required | Description | Default |
|---|---|---|---|
| context | Yes | 분석할 대화 컨텍스트 또는 질문 내용 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden. It mentions 'triggered activation only,' which hints at conditional behavior, but doesn't disclose other traits like whether it's read-only, what happens on failure, or if there are rate limits. This leaves significant gaps for a tool that analyzes and suggests.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence in Korean that conveys the core purpose and a key behavioral note. It's front-loaded with the main action and avoids unnecessary words, making it highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's complexity (analyzing context to suggest personas) and lack of annotations or output schema, the description is insufficient. It doesn't explain what a 'persona' entails, how suggestions are generated, or what the output looks like, leaving the agent with incomplete guidance.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has 100% description coverage, with the 'context' parameter documented as 'conversation context or question content to analyze.' The description adds no additional parameter details beyond this, so it meets the baseline of 3 without compensating further.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: analyzing conversation context to suggest suitable personas. It specifies the action ('analyze' and 'suggest') and resource ('personas'), though it doesn't explicitly differentiate from siblings like 'list_personas' or 'create_persona'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides some usage context by mentioning 'triggered activation only,' implying this tool should be used when a specific trigger condition is met. However, it doesn't specify what triggers it or when to use alternatives like 'list_personas' for browsing or 'create_persona' for manual creation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
update_personaC
기존 페르소나 프로필을 수정합니다
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | 수정할 페르소나 이름 | |
| content | Yes | 새로운 페르소나 프롬프트 내용 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. While '수정합니다' implies a mutation operation, it doesn't specify whether this requires specific permissions, what happens to unchanged fields, if changes are reversible, or any rate limits. For a mutation tool with zero annotation coverage, this is a significant gap in transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence with zero waste. It's appropriately sized and front-loaded, directly stating the tool's purpose without unnecessary elaboration. Every word earns its place, making it highly concise and well-structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a mutation tool with no annotations and no output schema, the description is incomplete. It lacks crucial context such as behavioral traits (e.g., permissions, side effects), usage guidelines, and output expectations. The high schema coverage doesn't compensate for these gaps in a tool that modifies data.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, meaning the input schema already fully documents both parameters ('name' and 'content'). The description adds no additional meaning beyond what the schema provides, such as explaining parameter interactions or constraints. With high schema coverage, the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('수정합니다' - modifies/updates) and the resource ('기존 페르소나 프로필' - existing persona profile), providing a specific verb+resource combination. However, it doesn't explicitly differentiate from sibling tools like 'create_persona' or 'delete_persona' beyond the 'existing' qualifier, which is why it doesn't reach a perfect 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. It doesn't mention prerequisites (e.g., needing an existing persona), exclusions, or comparisons to siblings like 'create_persona' for new personas or 'delete_persona' for removal. This leaves the agent without context for tool selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
9 tool updates
- First observed
browse_community - First observed
chain_personas - First observed
create_persona - First observed
delete_persona - First observed
get_analytics - First observed
install_community_persona - First observed
list_personas - First observed
suggest_persona - First observed
update_persona
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose with no overlap: browsing community personas, chaining personas, creating, deleting, getting analytics, installing community personas, listing, suggesting based on context, and updating. The descriptions clarify unique functions, preventing misselection.
All tool names follow a consistent verb_noun pattern (e.g., browse_community, create_persona, update_persona), with no deviations in style or convention. This predictability enhances readability and usability.
With 9 tools, the count is well-scoped for managing personas, covering core operations like CRUD, listing, installation, analytics, and advanced features like chaining and suggestion. Each tool earns its place without bloat.
The tool set provides complete coverage for persona management: CRUD operations (create, list, update, delete), community interaction (browse, install), analytics, and advanced workflows (chain, suggest). No obvious gaps exist, supporting full lifecycle handling.
Related MCP Connectors
SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.
Agent personas for Claude. 16 tools, 13 personas, 3 workflows. Zero extra API cost. Free.
Contextual prompts and agent skills for 140+ AI platforms.
150+ vertical AI expert bots as agent tools. $1 bots run on YOUR machine - your data stays yours.