🎭 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.

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:

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

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

• Clueo API Documentation

• Get API Key

• Model Context Protocol

• Enterprise Licensing

• Support & Issues

🌟 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