Five Persona Engine

by kiro0x

273 downloads
Not rated
GitHub

About

LLM persona consistency engine — enforce JSON personality and style constraints across interactions. Prevents persona drift with 160,000 deductively-derived behavioral rules.

Details

Author
kiro0x
Downloads
273
Categories
Other, AI

- Generates structured JSON persona constraints via the FIVE engine
- Eliminates LLM persona drift with deterministic behavioral parameters
- Single generate tool with required and optional parameters
- API key authentication via environment variable
- Stdio transport for MCP client compatibility
- Each generate call costs $1 (one credit)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Five Persona Engine
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via pip (pip install five-mcp), set the FIVE_API_KEY environment variable (get a key at fiveengine.dev), then run the server (five-mcp) with any MCP-compatible client. Use the generate tool to produce persona constraints by providing a character name and four personality axis choices (Q1–Q4), with optional style sliders (S1–S4, default 3) and free-form text.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "five persona engine": {
            "five-character-engine": {
                "command": "five-mcp",
                "env": {
                    "FIVE_API_KEY": "five_sk_your_key_here"
                }
            }
        }
    }
}

McpServers

{
    "five-character-engine": {
        "command": "five-mcp",
        "env": {
            "FIVE_API_KEY": "five_sk_your_key_here"
        }
    }
}

five-mcp

MCP server for the FIVE Persona Engine — an LLM persona constraint engine that generates structured JSON constraints to eliminate persona drift. Instead of describing personality in words (which LLMs interpret differently each turn), FIVE defines behavioral parameters the LLM executes as a recipe. See how it works →

Quick Start

Install

pip install five-mcp

Configure

Set your API key as an environment variable:

export FIVE_API_KEY=five_sk_your_key_here

Get your key at fiveengine.dev.

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "five-character-engine": {
      "command": "five-mcp",
      "env": {
        "FIVE_API_KEY": "five_sk_your_key_here"
      }
    }
  }
}

Use with other MCP clients

Any MCP-compatible client can connect via stdio transport:

five-mcp

Tool: generate

Generates persona constraints via the FIVE engine.

Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| character_name | string | Yes | Name of the character |
| q1q4 | A / B / C / D | Yes | Personality axis choices |
| s1s4 | 1–5 | No | Style sliders (default: 3) |
| free_text | string | No | Free-form description |

Response

{
  "status": "ok",
  "remaining": 42,
  "constraint": { "..." }
}

Pricing

Each generate call costs $1 and consumes one credit. Manage credits at fiveengine.dev.

Links

- API & Docs: fiveengine.dev
- GitHub: github.com/kiro0x/five-mcp
- Design philosophy & examples: five-character-engine README
- Engine repo: github.com/kiro0x/five-character-engine

License

MIT

<!-- mcp-name: io.github.kiro0x/five-mcp -->

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.