mcp-unicode v0.1.3

Unicode character database: lookup, search, browse, and transform.

This is an MCP (Model Context Protocol) server. It is designed to be used by AI assistants and other MCP-compatible clients, giving them access to the full Unicode character database — character properties, codepoint lookups, name search, block browsing, emoji flags, and text transforms.

This service is built upon character (github.com/philpennock/character), a Unicode toolkit which can also be installed locally and used as a stdio MCP server (via character mcp) for offline or private use without depending on this hosted instance.

MCP Endpoint

The MCP transport is at https://unicode.mcp.pennock.tech/mcp (Streamable HTTP).

Configuring Your Client

Claude Code (CLI)

claude mcp add --scope user --transport http unicode https://unicode.mcp.pennock.tech/mcp

Claude Desktop / claude.ai

Open Settings → MCP Servers, click Add, and enter:

ChatGPT (Actions / Custom GPTs)

When configuring a custom GPT with actions, you can point it at the MCP endpoint. ChatGPT's MCP integration varies by plan and interface; consult OpenAI's current documentation for where to enter a remote MCP server URL.

Other Clients

Any MCP-compatible client that supports Streamable HTTP transport can connect to https://unicode.mcp.pennock.tech/mcp. No authentication is required.

Discovery

Machine-readable server metadata is available at:

Available Tools

unicode_lookup_char
Look up a single character's full Unicode properties, UTF-8 bytes, and language-specific escape sequences.
unicode_lookup_codepoint
Look up a character by codepoint (U+XXXX, 0xNNNN, or decimal).
unicode_lookup_name
Find a character by its exact Unicode name.
unicode_search
Search for characters whose names contain a given substring.
unicode_browse_block
Browse all characters within a Unicode block.
unicode_list_blocks
List all Unicode blocks with their codepoint ranges.
unicode_emoji_flag
Get the flag emoji for a country code.
unicode_transform
Apply stylistic transforms to text (fraktur, math bold, upside-down, etc.).

Example: Trying It Out

You can invoke tools directly via curl. The MCP Streamable HTTP transport accepts JSON-RPC over HTTP POST:

curl -X POST https://unicode.mcp.pennock.tech/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "unicode_lookup_char",
      "arguments": {"character": "☃"}
    }
  }'
curl -X POST https://unicode.mcp.pennock.tech/mcp \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "unicode_search",
      "arguments": {"query": "snowman", "detail": "summary", "limit": 5}
    }
  }'