Emoji Storyteller

an mcp server that generates silly stories that are 100% emoji.

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "septapod-mcp-emoji-stories": {
      "command": "node",
      "args": [
        "/path/to/emoji-storyteller/index.js"
      ]
    }
  }
}

You run an MCP server that creates and serves emoji-only stories. It offers random tales, themed adventures, and a chaos mode to maximize fun. This guide shows you how to install, configure, and use the Emoji Storyteller MCP Server so you can entertain friends, spice up chats, or simply enjoy chaotic emoji storytelling.

How to use

After you add the Emoji Storyteller MCP Server to your MCP client, you can access three primary actions: tell random emoji stories, generate themed emoji stories, and unleash pure emoji chaos.

tell_random_story: Creates a spontaneous emoji narrative with adjustable levels of chaos. You can aim for light whimsy or full-on mayhem depending on the mood of your group.
tell_themed_story: Select from Adventure, Romance, Horror, Space, Food, or Party themes to generate a story that fits your occasion.
tell_emoji_madness: Engage MAXIMUM CHAOS MODE to run multiple overlapping stories for an intense, humorous experience.

How to install

Prerequisites: you need Node.js installed on your system. You can verify by running node -v and npm -v in your terminal.

Option 1 — Install Locally (Quick Start)

# Clone or copy this project
cd emoji-storyteller-mcp

# Install dependencies
npm install

# Make it executable
chmod +x index.js

Option 2 — Install from NPM (Coming Soon!)

npm install -g emoji-storyteller-mcp

Additional sections

Configuration and usage details are provided for integrating the server with your MCP client. You can add the server to your Claude Code configuration to enable direct storytelling commands.

Example: add the Emoji Storyteller MCP Server to Claude Code so your client can run emoji stories directly.

{
  "mcpServers": {
    "emoji-storyteller": {
      "command": "node",
      "args": ["/path/to/emoji-storyteller/index.js"]
    }
  }
}

Available tools and examples

The server exposes three core tools you can call through your MCP client to craft emoji stories.

Random Story: Generates chaotic emoji narratives with an adjustable chaos level.
Themed Stories: Produces emoji stories based on selected themes such as Adventure, Romance, Horror, Space, Food, and Party.
Emoji Madness: Activates MAXIMUM CHAOS MODE to run multiple stories in parallel.

Stories Available

Themes include Adventure, Romance, Horror, Space, Food, and Party. Each theme maps to a set of emojis that illustrate its mood and scenes.

Customization and notes

Feel free to customize: add more emoji categories, create new themed stories, adjust the structure and length of stories, and add additional themes. You can tailor the chaos level and storytelling format to fit your group.

Security and usage notes

Run the server in a trusted environment and manage access through your MCP client. If you switch from local to shared usage, ensure you restrict access to avoid unintended story generation during private sessions.

Available tools

Random Story

Generates chaotic emoji narratives with an adjustable chaos level to produce quick, playful stories.

Themed Stories

Creates emoji stories based on predefined themes such as Adventure, Romance, Horror, Space, Food, and Party.

Emoji Madness

Activates MAXIMUM CHAOS MODE to run multiple emoji stories simultaneously for a maximal chaotic effect.