Skip to main content
Glama

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 →

Measured: with the constraint JSON + free harness, the demo character survived a 120-turn pressure test with zero persona breaks (plain prompt: 8 breaks; JSON alone: 1). Numbers, transcripts and scripts →

Free — no API key, no account.

Quick Start

Install

pip install five-mcp

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "five-character-engine": {
      "command": "five-mcp"
    }
  }
}

That's it — no environment variables needed.

Use with other MCP clients

Any MCP-compatible client can connect via stdio transport:

five-mcp

Related MCP server: CSL-Core

Tool: generate

Generates persona constraints via the FIVE engine.

Parameters

Parameter

Type

Required

Description

character_name

string

Yes

Name of the character

q1 – q4

A / B / C / D

Yes

Personality axis choices

s1 – s4

1–5

No

Style sliders (default: 3)

free_text

string

No

Free-form description

Response

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

Rate limits

The API is free. To keep it available to everyone, a light per-IP limit applies: 10 requests/min, 200 requests/day. The free host may cold-start, so the first call can take up to a minute.

License

MIT

mcp-name: io.github.kiro0x/five-mcp

Available Tools

1 tool
generateA

Generate persona constraints using the FIVE engine.

This tool calls the FIVE Persona Engine API to produce JSON constraints that prevent persona drift and keep an LLM character's voice consistent.

Each call costs $1 and consumes one credit from your account.

Args: character_name: Name of the character to generate constraints for. q1: Personality axis 1 – choose A, B, C, or D. q2: Personality axis 2 – choose A, B, C, or D. q3: Personality axis 3 – choose A, B, C, or D. q4: Personality axis 4 – choose A, B, C, or D. s1: Style slider 1 (1-5, default 3). Optional fine-tuning. s2: Style slider 2 (1-5, default 3). Optional fine-tuning. s3: Style slider 3 (1-5, default 3). Optional fine-tuning. s4: Style slider 4 (1-5, default 3). Optional fine-tuning. free_text: Optional free-form description to further guide generation.

Returns: A dict with keys: status, remaining (credits left), constraint (the generated JSON constraint object).

Inputs: character_name (required), q1 (required), q2 (required), q3 (required), +6 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion between tools. The single 'generate' tool has a clearly distinct purpose.

    Naming Consistency4/5

    The tool name 'generate' is a single verb, which is clear and follows a common convention. While there is no noun to form a verb_noun pattern, the name is consistent as the only tool.

    Tool Count3/5

    The server has only one tool, which feels thin for a general-purpose utility. However, for a very focused single-API function, it is borderline acceptable.

    Completeness4/5

    The tool covers the core functionality of generating persona constraints with many parameters. Minor gaps exist (e.g., no credit management or constraint listing), but the tool is complete for its stated purpose.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides a universal AI personality layer that uses a scientifically-backed Big Five engine to apply consistent character traits and brand voices across MCP-compatible platforms. It allows users to inject custom personality profiles or presets into AI interactions to ensure behavioral consistency.
      7
      13 npm
      77
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Deterministic AI safety policy engine with Z3 formal verification. Write, verify, simulate, and enforce machine-verifiable safety constraints for AI agents. Completely outside the LLM.
      11
      70 PyPI
      27
      Apache 2.0