TextArtTools

TextArtTools MCP Server provides public, edge-deployed text transformation and ASCII art banner generation via the Model Context Protocol. It exposes Unicode style transformations and a large collection of ASCII art fonts, with public access and rate limiting to ensure reliable usage across regions.

How to use

You connect to the MCP server using a client that speaks the Model Context Protocol. The server exposes two main kinds of capabilities: transforming text into Unicode styles and generating ASCII art banners. Use the client to request a style transformation or to render a banner from a chosen font.

How to install

Prerequisites: you should have Node.js and npm installed if you plan to run a local development instance. Ensure you have a compatible MCP client ready to connect to the public server.

Option A — Use the public MCP server directly (recommended for quick experiments): you do not need to install anything locally to start using the server. Instead, point your MCP client at the public endpoint and begin issuing requests.

Option B — Run a local development instance for testing and development: follow these commands to start a development server locally.

Local development and testing

Clone the project directory, install dependencies, and run the development server to test MCP locally. The recommended flow is to install dependencies, then start the development server, and finally test with a local client.

# Clone the repository
git clone https://github.com/humanjesse/textarttools-mcp.git
cd textarttools-mcp

# Install dependencies
npm install

# Create local environment file (development values)
cp .dev.vars.example .dev.vars
# Edit .dev.vars with your development values

# Start development server
npm run dev

# Test locally (server runs at http://localhost:8788)
curl -X POST http://localhost:8788/sse \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Usage patterns and endpoints

Public endpoints are designed for quick evaluation. Use the provided /sse path to access the MCP service with POST requests containing the appropriate JSON-RPC payloads. Typical actions include transforming text into a Unicode style and generating ASCII banners with a chosen font.

Troubleshooting and notes

If you encounter connectivity or rate-limiting issues, try reducing the request rate to stay within the allowed limits. Ensure your client targets the public endpoint https://mcp.textarttools.com/sse and that requests follow the expected JSON-RPC structure. For local testing, verify that the development server is running and reachable at http://localhost:8788.

Available tools

unicode_style_text

Transform text into a chosen Unicode style from 23 available styles.

list_available_styles

Return all available Unicode styles with examples so you can preview options.

preview_styles

Preview how a piece of text looks in multiple Unicode styles.

get_style_info

Provide detailed information about a specific Unicode style and its compatibility.

ascii_art_text

Generate stylized text banners using 322+ fonts for headers and decorations.

list_figlet_fonts

List all available ASCII art fonts from storage.

preview_figlet_fonts

Preview how text looks across multiple ASCII art fonts.