Skip to content
MCP server

Emoji

MCP server that looks up emoji by shortcode or character and searches emoji by keyword

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Emoji

Emoji is a freemium MCP server for developer tools. It can run locally on your machine or as a hosted remote server.

The README describes this as a small MCP server for converting between emoji characters and their :shortcode: names. You can pass a shortcode such as "fire" and get back the character with its keywords, or pass a character and get its shortcode and name. A second tool searches the emoji table by a word like "party" or "money" and returns matching emoji with their shortcodes.

The server is hosted on the Pipeworx gateway, so the requests go over HTTP to gateway.pipeworx.io rather than running locally. The page states that the emoji lookups themselves are keyless and use an inlined table, though the README notes the npm bridge still needs network access. Connections can be anonymous with a daily call cap, or use an optional Pipeworx API key for a higher limit.

It suits developers building chat bots, content tools or text-processing scripts that need emoji names and characters without maintaining their own table.

Install

Run in a terminal

claude mcp add --transport http emoji https://gateway.pipeworx.io/emoji/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/emoji/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "emoji": {
      "url": "https://gateway.pipeworx.io/emoji/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "emoji": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/emoji/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "emoji": {
      "serverUrl": "https://gateway.pipeworx.io/emoji/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "emoji": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/emoji/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

emoji_lookup
Look up an emoji by :shortcode: or pass an emoji character to get its shortcode and name.
search_emoji
Search emoji by keyword or name and return matching emoji with shortcodes.

What it does

Shortcode to character lookup
Converts a shortcode like :fire: or a bare name into the emoji character along with its keywords.
Character to shortcode lookup
Accepts an emoji character and returns its shortcode and name.
Keyword emoji search
Finds emoji matching a keyword and lists them with their shortcodes.
Optional API key
An optional Pipeworx key raises the daily call limit over anonymous access.
Multiple connection methods
Can be attached via a remote streamable HTTP endpoint, an npx stdio bridge, or Claude Code.

Good for

  • Converting :shortcode: names into emoji characters inside a chat or messaging integration
  • Finding the right emoji for a keyword such as party or money when drafting text
  • Identifying the shortcode of an emoji a user pasted into a tool
  • Giving an AI assistant emoji lookup as part of an MCP client setup

Pricing

Freemium, from $49 a month

Free anonymous and free-account tiers; paid usage billed in credits beyond the daily allowance

Prices change. Check pipeworx.io before you buy.

Emoji FAQ

Does the emoji lookup require an API key?

No. The page and README say the lookups are keyless. Anonymous calls are capped at 50 a day, and a free Pipeworx account raises the cap to 200 a day.

Which tools does the server expose?

The README lists two pack tools, emoji_lookup and search_emoji. The endpoint also lists shared Pipeworx meta-tools such as ask_pipeworx.

Is the server open source?

The repository is published under the MIT licence, according to the README.

Is Emoji free?

Emoji has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Emoji to Claude Code?

Run this command in your terminal: claude mcp add --transport http emoji https://gateway.pipeworx.io/emoji/mcp

What are the best alternatives to Emoji?

The closest alternatives to Emoji are Htmlentities, Unicode, Mime, Httpstatus and Morse Code Translator.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers