Convert between emoji characters and :shortcode: notation, get Unicode codepoints and shortcode info via @mukundakatta/emoji-mcp (npx)

@mukundakatta/emoji-mcp v0.1.0 — Emoji shortcode ↔ character converter + Unicode inspector

Install & run: npm install @mukundakatta/emoji-mcp → node node_modules/@mukundakatta/emoji-mcp/dist/server.js (stdio)

3 tools:

• from_shortcode — Replace :name: shortcodes with emoji characters. Param: text (string, required). Returns plain text with shortcodes replaced.
• to_shortcode — Replace emoji characters with :name: shortcodes. Param: text (string, required). Returns plain text with emojis replaced.
• info — Return shortcode and Unicode codepoints for an emoji. Param: input (string, required). Returns JSON {input, shortcode, codepoints[]}.

14 calls, 100% success, p50=2ms:

1. from_shortcode("Hello :wave: how are you :smile:?") → Hello 👋 how are you 😄?
2. from_shortcode(":rocket: :fire: :star: :heart:") → 🚀 🔥 ⭐ ❤️
3. from_shortcode(":thumbsup: :thumbsdown: :100:") → :thumbsup: :thumbsdown: 💯 — `:thumbsup:` NOT recognized
4. from_shortcode("No shortcodes here") → passthrough unchanged
5. from_shortcode(":nonexistent_emoji:") → passthrough unchanged (graceful)
6. to_shortcode("Hello 👋 how are you 😄?") → Hello :wave: how are you :smile:?
7. to_shortcode("🚀🔥⭐❤️") → :rocket::fire::star::heart:
8. to_shortcode("No emojis here") → passthrough unchanged
9. to_shortcode("Mixed 🎉 content with text 💯") → Mixed :tada: content with text :100:
10. info("🚀") → {input: "🚀", shortcode: ":rocket:", codepoints: ["U+1F680"]}
11. info("❤️") → {input: "❤️", shortcode: ":heart:", codepoints: ["U+2764", "U+FE0F"]} — includes variation selector
12. info("👍") → {input: "👍", shortcode: ":+1:", codepoints: ["U+1F44D"]} — canonical name is :+1: not :thumbsup:
13. info("🇹🇷") → {input: "🇹🇷", shortcode: ":tr:", codepoints: ["U+1F1F9", "U+1F1F7"]} — flag emojis work (regional indicators)
14. from_shortcode(":tada: shipped it :ship:") → 🎉 shipped it 🚢

Return format:

• from_shortcode and to_shortcode return plain text (not JSON)
• info returns JSON with {input, shortcode, codepoints[]}

Key gotchas:

• Shortcode names follow GitHub/Slack convention but NOT all aliases: :thumbsup: is NOT recognized — the canonical shortcode for 👍 is :+1:. Similarly :thumbsdown: fails, the canonical is :-1:
• Unknown/invalid shortcodes pass through unchanged — no error thrown
• `to_shortcode` strips spaces between adjacent emojis — 🚀🔥 → :rocket::fire: (no space between shortcodes)
• Flag emojis fully supported — regional indicator pairs like 🇹🇷 resolve to :tr:
• Variation selectors preserved — info on ❤️ shows both U+2764 and U+FE0F
• First call ~22ms (JIT warmup), subsequent calls 1-6ms
• Round-trip works for recognized emojis: from_shortcode → to_shortcode → original shortcodes (modulo alias differences)