Skip to content

🎭 The Personality Layer for LLMs- Transform any MCP-compatible AI with rich, consistent personalities powered by Clueo's Big Five personality engine.

License

Notifications You must be signed in to change notification settings

ClueoFoundation/ClueoMCP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

55 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎭 OpenClueo MCP Server

The Universal AI Personality Layer for Model Context Protocol

Patent-pending technology that transforms any AI into a consistent, branded personality across all platforms.

npm version License: MIT PRs Welcome

Transform any MCP-compatible AI with rich, consistent personalities powered by OpenClueo's scientifically-backed Big Five personality engine. The first universal AI personality protocol that works across Claude Desktop, Cursor, Windsurf, VS Code, and any MCP-compatible platform.

⚑ Quick Start

# Install from npm
npm install -g @openclueo/mcp

# Add to your IDE (Claude Desktop example)
{
  "mcpServers": {
    "clueo-mcp": {
      "command": "@openclueo/mcp",
      "env": {
        "CLUEO_API_URL": "https://backend.clueoai.com",
        "CLUEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

# Start using personalities instantly!
inject_preset_personality "Hello, how can I help?" "professional"
inject_personality "Write an email" {"openness": 8, "conscientiousness": 9}

🌟 What Makes OpenClueo MCP Revolutionary?

🎯 Universal AI Personality Protocol

The first standardized method for applying consistent personality traits across ALL AI platforms:

  • Cross-Platform: Same personality in Claude, ChatGPT, Cursor, Windsurf, VS Code
  • Real-Time: Personality applied before AI processing, not after
  • Scientific: Big Five psychological model with numerical precision (1-10 scale)
  • Consistent: Identical personality behavior across all your AI tools

🏒 Enterprise Brand Personality

Patent-pending technology for organization-wide AI brand consistency:

  • Brand Compliance: Ensure all company AI interactions match your brand voice
  • Department Variations: Customer service (empathetic), Sales (enthusiastic), Engineering (analytical)
  • Context Awareness: Automatically adapts personality based on communication context
  • Analytics: Track brand personality performance and ROI across your organization

🧠 Adaptive Memory System

AI that learns YOUR personality preferences:

  • Smart Suggestions: "You often use empathetic + professional for customer emails"
  • Project Memory: Save default personalities for specific projects
  • Usage Analytics: Understand your personality patterns and success rates
  • Context Learning: System improves recommendations based on your patterns

πŸš€ Installation & Setup

Prerequisites

  • Node.js 18+
  • An MCP-compatible client (Claude Desktop, Cursor, Windsurf, VS Code, etc.)
  • Get your API key (optional for basic use)

Option 1: NPM Install (Recommended)

# Install globally
npm install -g @openclueo/mcp

# Verify installation
@openclueo/mcp --version

Option 2: From Source

git clone https://github.com/ClueoFoundation/ClueoMCP.git
cd ClueoMCP
npm install
npm run build

πŸ”Œ IDE Integration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "clueo-mcp": {
      "command": "@openclueo/mcp",
      "env": {
        "CLUEO_API_URL": "https://backend.clueoai.com",
        "CLUEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor IDE

  1. Settings β†’ Features β†’ Model Context Protocol
  2. Add Server:
    • Name: clueo-mcp
    • Command: @openclueo/mcp
    • Environment: CLUEO_API_URL=https://backend.clueoai.com

Windsurf IDE

  1. Settings β†’ Advanced β†’ Cascade
  2. Add custom server:
{
  "mcpServers": {
    "clueo-mcp": {
      "command": "@openclueo/mcp",
      "env": {
        "CLUEO_API_URL": "https://backend.clueoai.com",
        "CLUEO_API_KEY": "your_api_key_here"
      }
    }
  }
}

VS Code (with MCP extension)

Install the MCP extension, then add the OpenClueo server to your workspace settings.

🎭 Personality Presets

8 scientifically-crafted personalities for common scenarios:

Preset Personality Traits Best For
Professional Balanced (6,8,6,7,3) Business communications, formal emails
Creative High Openness (9,6,7,6,4) Brainstorming, content creation, marketing
Empathetic High Agreeableness (7,7,6,9,3) Customer support, counseling, HR
Analytical High Conscientiousness (8,9,5,6,2) Technical docs, research, analysis
Enthusiastic High Extraversion (8,7,9,7,2) Sales, presentations, team motivation
Casual Friend Balanced & Relaxed (7,5,7,8,3) Informal chats, internal communication
Luxury Brand Sophisticated (6,9,6,6,2) Premium brand voice, high-end clients
Startup Brand Bold & Innovative (9,8,8,6,3) Tech startups, innovation messaging

Values shown as (Openness, Conscientiousness, Extraversion, Agreeableness, Neuroticism)

πŸ› οΈ Core Tools

inject_personality

Apply custom Big Five personality traits to any text:

{
  "text": "Hello, how can I help you today?",
  "personality": {
    "openness": 7,        // Creativity, curiosity (1-10)
    "conscientiousness": 8, // Organization, discipline (1-10)
    "extraversion": 6,     // Sociability, energy (1-10)
    "agreeableness": 9,    // Cooperation, empathy (1-10)
    "neuroticism": 3       // Emotional stability (1-10, lower = more stable)
  },
  "apiKey": "your_api_key"
}

inject_preset_personality

Apply predefined personality presets:

{
  "text": "Thanks for your feedback on our product",
  "presetId": "empathetic",
  "apiKey": "your_api_key"
}

simulate_response

Generate AI responses with specific personality:

{
  "prompt": "A customer is frustrated with delayed shipping",
  "personality": {
    "openness": 6,
    "conscientiousness": 9,
    "extraversion": 5,
    "agreeableness": 10,
    "neuroticism": 2
  },
  "apiKey": "your_api_key"
}

🧠 Advanced Memory Features

Smart Personality Suggestions

get_memory_suggestions {"context": "customer_email"}
# Returns: "You typically use empathetic + professional for customer emails"

Project-Level Personality

save_project_personality {
  "projectPath": "/work/customer-portal",
  "projectName": "Customer Support Portal",
  "personality": {"openness": 7, "conscientiousness": 9, "extraversion": 6, "agreeableness": 8, "neuroticism": 3}
}

Usage Analytics

get_usage_analytics {"userId": "optional"}
# Returns: Most used personalities, success rates, recommendations

🏒 Enterprise Features

Brand Personality Management

  • Organization-wide consistency: Ensure all AI interactions match your brand
  • Department variations: Different personalities for different teams
  • Compliance monitoring: Track adherence to brand guidelines
  • Role-based access: Control who can modify brand personalities

Advanced Analytics

  • Brand performance metrics: Track personality effectiveness
  • Department usage patterns: See how different teams use AI personalities
  • ROI measurement: Understand the business impact of consistent AI branding
  • Compliance reporting: Generate reports for brand guideline adherence

Enterprise API Endpoints

# Apply company brand personality
inject_brand_personality {"organizationId": "company_uuid", "text": "Customer response"}

# Validate brand compliance
validate_brand_compliance {"organizationId": "company_uuid", "text": "Generated response"}

# Deploy organization-wide personality
deploy_brand_personality {"organizationId": "company_uuid", "brandPersonality": {...}}

πŸ”§ Configuration

Environment Variables

# Required
CLUEO_API_URL=https://backend.clueoai.com

# Optional (get at https://api.clueoai.com/)
CLUEO_API_KEY=your_api_key_here

# Server Configuration
MCP_SERVER_NAME=clueo-mcp
MCP_SERVER_VERSION=1.2.20
LOG_LEVEL=info

Big Five Personality Science

Each dimension uses a 1-10 scale based on established psychological research:

  • Openness (1-10): Creativity, curiosity, openness to new experiences
  • Conscientiousness (1-10): Organization, dependability, self-discipline
  • Extraversion (1-10): Sociability, assertiveness, energy level
  • Agreeableness (1-10): Cooperation, trust, empathy towards others
  • Neuroticism (1-10): Emotional instability, anxiety (lower = more stable)

🎯 Use Cases

Personal AI Enhancement

  • Consistent personality across all your AI tools
  • Context-aware suggestions based on your work patterns
  • Project-specific personalities for different types of work
  • Learning from your preferences to improve over time

Enterprise Brand Management

  • Customer Service: Ensure empathetic, helpful responses across all channels
  • Sales Team: Maintain enthusiastic, professional communication
  • Technical Support: Provide analytical, precise assistance
  • Marketing: Consistent brand voice in all AI-generated content

Developer Integration

  • API-first design: Integrate personality into any application
  • Cross-platform compatibility: Works with any MCP-compatible AI
  • Real-time processing: Personality applied before AI generation
  • Scalable architecture: From personal use to enterprise deployment

πŸ“Š API Rate Limits & Pricing

Plan Monthly API Calls Price Best For
Free 100 calls $0 Personal exploration
Dev+ 5,000 calls $25 Individual developers
Operator 50,000 calls $149 Small teams
Enterprise Custom Contact Large organizations

Get your API key β†’

🀝 Contributing

We welcome contributions to the open source OpenClueo MCP Server!

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-personality)
  3. Commit your changes (git commit -m 'Add amazing personality feature')
  4. Push to the branch (git push origin feature/amazing-personality)
  5. Open a Pull Request

πŸ“„ License

MIT License - see LICENSE for details.

Note: The core personality injection technology is patent-pending. This open source implementation provides basic functionality, while advanced enterprise features require a commercial license.

πŸ”— Links

🌟 Why OpenClueo MCP Changes Everything

Before OpenClueo MCP:

  • ❌ Generic, inconsistent AI responses across platforms
  • ❌ No brand personality control for organizations
  • ❌ Manual personality prompting for every interaction
  • ❌ No learning or memory of personality preferences

With OpenClueo MCP:

  • βœ… Universal personality protocol across ALL AI platforms
  • βœ… Scientific Big Five model with precise numerical control
  • βœ… Enterprise brand consistency with compliance monitoring
  • βœ… Adaptive memory system that learns your preferences
  • βœ… Real-time personality injection before AI processing
  • βœ… Patent-protected innovation with open source accessibility

πŸš€ What's Next?

OpenClueo MCP represents the first step toward universal AI personality standardization. As the ecosystem grows, we're building:

  • Personality Marketplace: Buy, sell, and share personality presets
  • Industry-Specific Templates: Healthcare AI, Legal AI, Financial AI personalities
  • Advanced Analytics: Deep insights into AI personality performance
  • Multi-Modal Support: Personality for voice, video, and other AI modalities

Join the AI personality revolution. 🎭✨


Ready to give your AI a consistent, memorable personality across every platform?

Get Started Now β†’

Made with ❀️ by Clueo Foundation

About

🎭 The Personality Layer for LLMs- Transform any MCP-compatible AI with rich, consistent personalities powered by Clueo's Big Five personality engine.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published