# Emoji

> Emoji is a freemium MCP server for developer tools. MCP server that looks up emoji by shortcode or character and searches emoji by keyword. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/emoji
- **Repository:** https://github.com/pipeworx-io/mcp-emoji
- **MCP Registry name:** io.github.pipeworx-io/emoji
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/emoji/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "emoji": {
      "url": "https://gateway.pipeworx.io/emoji/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Htmlentities](https://ai-powered.com/mcp/htmlentities): Htmlentities is a freemium MCP server for developer tools.
- [Unicode](https://ai-powered.com/mcp/unicode): Unicode is a freemium MCP server for developer tools.
- [Mime](https://ai-powered.com/mcp/mime): Mime is a freemium MCP server for developer tools.
- [Httpstatus](https://ai-powered.com/mcp/httpstatus): Httpstatus is a freemium MCP server for developer tools.
- [Morse Code Translator](https://ai-powered.com/mcp/morse-code-translator): Morse Code Translator is a free MCP server for developer tools.
- [MCP Server](https://ai-powered.com/mcp/mcp-server-mwl02fii): MCP Server is an open-source MCP server for developer tools.
- [Hash](https://ai-powered.com/mcp/hash): Hash is a freemium MCP server for developer tools.
- [Markdown](https://ai-powered.com/mcp/markdown-2): Markdown is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/emoji
