OpenClueo

You can equip any MCP-compatible AI with a consistent, branded personality using the OpenClueo MCP Server. It injects a Big Five personality before AI processing, enabling real-time, cross-platform persona consistency for individuals and organizations.

How to use

You integrate the MCP server with your MCP client (such as Claude Desktop, Cursor, Windsurf, or VS Code) to apply a defined personality to every AI interaction. Start by configuring one of your MCP clients to point at the OpenClueo MCP server, then choose either a preset personality or a custom set of Big Five traits for each interaction. Use the server to maintain brand-consistent tones across teams, projects, and channels, and take advantage of memory and analytics features to tailor personalities over time.

How to install

Prerequisites: install Node.js version 18 or later and ensure you have an MCP-compatible client installed (Claude Desktop, Cursor, Windsurf, VS Code, etc.). You may obtain an API key for advanced usage.

Option 1: Install from npm (recommended)

# Install globally
npm install -g @openclueo/mcp

# Verify installation
@openclueo/mcp --version

Option 2: Install from source

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

Additional configuration and usage notes

Configure your MCP client to point to the OpenClueo MCP server by providing the server command and environment values shown in the integration examples. Example configurations are provided for Claude Desktop, Cursor, Windsurf, and VS Code. The server requires the API URL and, optionally, an API key for authenticated usage.

Configuration examples

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

Usage with presets and custom personalities

Apply predefined personality presets to quickly set common tones, or supply a custom Big Five trait set for precise control.

# Apply a preset (example: empathetic)
{
  "text": "Thanks for your feedback on our product",
  "presetId": "empathetic",
  "apiKey": "your_api_key"
}

Advanced usage and memory features

Leverage memory features to save project-specific personalities, get smart suggestions, and analyze usage patterns to refine how personalities are applied.

get_memory_suggestions {"context": "customer_email"}

Enterprise features (optional)

If you are using OpenClueo MCP in an organization, you can manage brand personality across teams, monitor compliance, and gather analytics to measure impact.

Troubleshooting

If you encounter connection issues, verify that your MCP client is configured with the correct server command and environment variables. Check that the API URL is reachable and that any required API keys are valid. Ensure the MCP server process is running and accessible from your development environment.

Available tools

inject_personality

Apply a custom Big Five personality profile to a given text, returning the text with the desired personality traits injected.

inject_preset_personality

Apply a predefined personality preset to text to quickly adopt a standard voice (e.g., professional, empathetic, analytical).

simulate_response

Generate AI responses that reflect a specified personality profile for a given prompt or scenario.

get_memory_suggestions

Retrieve smart memory suggestions based on context to guide future interactions.

save_project_personality

Save and manage project-specific personality configurations for consistent collaboration within a project.

get_usage_analytics

Analyze usage data to reveal personality trends, success rates, and recommended adjustments.

inject_brand_personality

Apply brand-level personality across organization-wide AI interactions.

validate_brand_compliance

Check generated text against brand guidelines to ensure compliance.

deploy_brand_personality

Roll out and manage brand personality across teams and departments.