# tjclaude88/mcp-bling [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/tjclaude88/mcp-bling  
**GitHub Stars:** 1  
**npm Downloads (last month):** 235  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tjclaude88-mcp-bling

## Description
Give AI agents a persistent identity and cross-platform visual style. Includes WOW (Weird Office Workers) random-identity generator with rarity tiers and screenshot-ready share cards. npx -y bling-bag

## Tools
Capabilities this server exposes over MCP:

- **get_identity** — Who's your bot? Pull up the full identity — name, personality, quirks, appearance, and theme colours. Returns whatever's configured in bling.json. Errors if bling.json is missing or invalid.
- **get_theme_for_platform** — Get your bot's colours formatted for a specific platform. Supported: terminal (ANSI codes), web (CSS variables), slack, discord, ide. Unknown platforms get the raw hex colours.
- **roll_identity** — Give your bot a random identity. Pick a variant: wow (Weird Office Workers — quirky office drones, default) or legends (historical figures in absurd corporate roles). Returns a name, job title, traits, rarity score, and a screenshot-ready share card. Stores the roll for save_last_roll.
- **save_last_roll** — Save the most-recent roll as your bot's permanent identity. Errors if no roll has happened this session — call roll_identity first. Writes to bling.json, backing up any existing config to bling.json.bak first. Returns the backup path (or null if nothing was overwritten).
- **get_rarity_report** — Get the formatted share card for the most-recent roll — a plain-text block ready to screenshot and post. Errors if no roll has happened this session.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mcp-bling": {
    "command": "npx",
    "args": ["-y","bling-bag"],
    "env": {
      "BLING_PATH": ""
    }
  }
}
```

**Requires environment variables:** `BLING_PATH` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What tjclaude88/mcp-bling does

tjclaude88/mcp-bling MCP server gives an agent a stored identity and tools for presenting that identity across several environments. The identity can include a name, personality, appearance, office details, theme colours, and optional metadata. Required configuration includes a non-empty name, three personality values, and primary and accent colours written as six-digit hexadecimal values.

The server also supports generated identities. The default WOW pool creates quirky office-worker characters, while the Legends pool places historical figures in absurd corporate roles. Generated results include character details, traits, a rarity score, and a formatted share card.

## How it works

The server uses stdio transport, so an MCP client starts it as a child process rather than connecting to a network port. Configuration is resolved in this order: the `--bling` command-line option, the `BLING_PATH` environment variable, then `./bling.json` in the working directory.

`get_identity` reads the configured file and returns the identity. `get_theme_for_platform` converts the configured colours into platform-specific output. A terminal request returns ANSI codes, a web request returns CSS variables, and Slack, Discord, and IDE requests receive their supported formatting. Unknown platforms receive the raw hexadecimal colours.

`roll_identity` creates a session-level result without immediately changing the file. `save_last_roll` writes that result to `bling.json` and first backs up an existing file as `bling.json.bak`. `get_rarity_report` returns the latest roll's share-card text. Calls that depend on a missing file or previous roll return structured errors.

## Setup and configuration

Install Node.js 20 or later, then either install `bling-bag` with npm or run it on demand through `npx -y bling-bag`. Add the command and its arguments to an MCP client configuration, using an absolute path in `BLING_PATH` when the identity file is stored outside the working directory. A local clone can instead run the compiled `dist/index.js` with Node.

A minimal `bling.json` needs `name`, `personality.tone`, `personality.formality`, `personality.humor`, `theme.primary_color`, and `theme.accent_color`. Theme values must match `#RRGGBB`; shorthand colours and values without the leading hash are invalid. Optional sections can describe physical traits, office details, and homunculus metadata.

For repeatable deployments, pin the npm package version instead of using an unversioned latest release.

## Tools and capabilities

The five MCP tools are:

- `get_identity`: Reads the configured identity.
- `get_theme_for_platform`: Produces platform-specific theme output.
- `roll_identity`: Generates a WOW or Legends identity and stores it in memory for the session.
- `save_last_roll`: Persists the latest generated identity and creates a backup when needed.
- `get_rarity_report`: Returns the latest generated share card.

The WOW generator uses weighted trait pools and rarity bands, then assigns a character tier from the resulting score. Both text content and parsed structured content are returned by the tools.

## Limitations and notes

A missing or invalid `bling.json` prevents identity reads and produces a structured validation error. `save_last_roll` cannot run until `roll_identity` has been called in the current session. The generated identity is not persistent until explicitly saved.

The inspection scripts mentioned in the project documentation are available from a cloned repository, not from the installed npm package. The server is intended for MCP clients that can launch local stdio processes, including Claude Code, Claude Desktop, Codex, and Cursor.

_Full upstream README: https://allmcps.com/mcp/tjclaude88-mcp-bling/readme_