mcp-server-emojikey

@identimoji

About mcp-server-emojikey

MCP Server for emojikey.io ... save your unique relationship state and interaction style with your favorite LLM

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "emojikey": {
      "command": "npx",
      "args": [
        "-y",
        "@identimoji/mcp-server-emojikey"
      ],
      "env": {
        "EMOJIKEYIO_API_KEY": "",
        "MODEL_ID": "",
        "CODE_MODE": ""
      }
    }
  }
}

Tools

IMPORTANT: 1. Run this tool at the start of every conversation to initialize the emojikey context. 2. Emojikeys follow a structured language where each component encodes dimensions with magnitude and phase angle. 3. The initialize_conversation function will return recent keys and a unique conversation ID. 4. You must use the returned conversation ID in all subsequent emojikey operations in this conversation. 5. This ensures that each conversation maintains its own emojikey state separate from others.

Get the current emojikey for this conversation. This function can be used when the user requests a vibe check.

Use this function to create and store a new emojikey in the v3 format. The Emojikey v3 format uses: [ME|🧠🎨8∠45|🔒🔓9∠60] where: * Each component (ME, CONTENT, YOU) is enclosed in square brackets * Dimensions are separated by pipes (|) * Each dimension has emoji pairs followed by magnitude (0-9) and angle (0-180°) * Multiple components can be joined with ~ connector Example: [ME|🧠🎨8∠45|🔒🔓9∠60]~[CONTENT|💻🧩9∠15|🌱🌳7∠30]~[YOU|🎓🌱8∠35|🔥💤9∠10] Set a new emojikey when you detect significant changes in the interaction.

Function to list previously stored historical emojikeys for this conversation. Useful for seeing the progression of vibes and interaction styles within the conversation.

Overview

What is mcp-server-emojikey?

mcp-server-emojikey is an MCP server that persists LLM relationship context as emoji-based memory keys, enabling Claude to maintain consistent interaction styles and remember relationship context across conversations. Emojikeys are stored online for cross-device use, and no user information other than the emojikeys is stored.

How to use mcp-server-emojikey?

Get an API key from emojikey.io, then configure Claude Desktop with the server command npx -y @identimoji/mcp-server-emojikey and set EMOJIKEYIO_API_KEY, MODEL_ID, and optionally CODE_MODE. First-time usage: tell Claude to "Set emojikey"; on subsequent conversations Claude automatically uses this key to maintain context.

Key features of mcp-server-emojikey

Persists relationship context as emoji memory keys
Online storage for cross-device and cross-application use
Auto-initialization display with aggregated key history
Coding context support with 10 programming dimensions
Superkeys that compress multiple emojikeys into one
Adjustable angle distribution for dimension balancing

Use cases of mcp-server-emojikey

Maintaining consistent interaction style across separate Claude conversations
Remembering relationship context across devices and applications
Adapting Claude's programming approach using coding dimensions
Preserving conversation history with superkeys after many interactions
Tracking long-term relationship evolution via aggregated time-based keys

FAQ from mcp-server-emojikey

What is an emojikey?

An emojikey is an emoji-based memory key that stores LLM relationship context, allowing Claude to remember interaction styles and preferences across conversations.

How do I start using the server?

Install it via npx, add your API key from emojikey.io to the Claude Desktop config, and tell Claude "Set emojikey" on first use. Claude will then automatically use that key in future conversations.

Does the server store any personal information?

No, only the emojikeys are stored online. No user information beyond these keys is kept.

What environment variables are required?

You must set EMOJIKEYIO_API_KEY and MODEL_ID. Optionally set CODE_MODE to "true" to enable coding dimensions, or use custom Supabase credentials with SUPABASE_URL and SUPABASE_ANON_KEY.

What are coding dimensions and how do they work?

Coding dimensions are ten emoji-paired axes (e.g., ImplementationFocus, CodeScope) that track programming interaction patterns. They help Claude adapt its explanations and guidance to your coding style.

Frequently asked questions