Skip to main content

160,000 deductively-derived JSON constraints that enforce LLM persona consistency — eliminates persona drift across interactions.

Project description

five-mcp

MCP server for the FIVE Persona Engine — an LLM persona constraint engine that generates JSON personality/style constraints to prevent persona drift and maintain consistent character voices.

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

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

five_mcp-1.0.0.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

five_mcp-1.0.0-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file five_mcp-1.0.0.tar.gz.

File metadata

  • Download URL: five_mcp-1.0.0.tar.gz
  • Upload date:
  • Size: 4.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for five_mcp-1.0.0.tar.gz
Algorithm Hash digest
SHA256 35a2bec73d7fc6a1c0af4a72513f9ee8a75f26832d1c90ac5610e0785656e05a
MD5 c5e3a63fac3ccc4da963cc3ac34686cb
BLAKE2b-256 03175b0d8784775c3c3e26c844ec74508851bab5392aa0a0c093ab111bf77bde

See more details on using hashes here.

Provenance

The following attestation bundles were made for five_mcp-1.0.0.tar.gz:

Publisher: publish.yml on kiro0x/five-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file five_mcp-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: five_mcp-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for five_mcp-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 84460796c5ce4bb7e7454e6f6767eabd1918645946a54312e2d7fd77478f4899
MD5 e762d7eff1f3e8bfc31e7bab9032a0ab
BLAKE2b-256 cfa9b4fa077a1efd2ea2fdf1b79af90fef82fca5ea648bd4b694804422900bbd

See more details on using hashes here.

Provenance

The following attestation bundles were made for five_mcp-1.0.0-py3-none-any.whl:

Publisher: publish.yml on kiro0x/five-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page