ASCII art generator API & MCP server

$ Endpoint

URL

https://asciify.art/api/mcp

Transport

Streamable HTTP, JSON-RPC 2.0 over POST

Protocol

2025-06-18

Auth

None (public)

CORS

Any origin, so browser-based clients work too

Server card

https://asciify.art/.well-known/mcp/server-card.json

$ Tools (5)

• generate_text_banner

  Render input text as a FIGlet-style ASCII banner using a named font. Use \n inside the text to create multiple banner lines.

  args: text*, font

• list_text_fonts

  List all FIGlet fonts available to generate_text_banner.

  args: none

• list_gallery

  List public gallery items. Supports pagination and sort (newest, popular, trending).

  args: page, limit, sort

• get_gallery_item

  Fetch a single public gallery item by id, including the full ASCII art payload.

  args: id*

• generate_and_publish_banner

  Generate a FIGlet-style ASCII banner on the server and submit the result to the asciify.art gallery for moderation. Submissions start as 'pending' and only become publicly visible after a human moderator approves them. The published artwork is exactly what this server generated from the provided text and font — agents cannot inject arbitrary ASCII strings this way. Rate limited per IP to 10 publishes per 10 minutes and 10 per 7 days. Profanity filter applies to title and banner text.

  args: text*, font, title

* required argument

$ Connect a client

claude mcp add asciify --transport http https://asciify.art/api/mcp

{
  "mcpServers": {
    "asciify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://asciify.art/api/mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "asciify": {
      "url": "https://asciify.art/api/mcp"
    }
  }
}

curl -s -X POST https://asciify.art/api/mcp \
  -H "content-type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"generate_text_banner",
                 "arguments":{"text":"HELLO","font":"Standard"}}}'

$ Limits

• 10 requests per minute per IP on /api/mcp (HTTP 429 with Retry-After when exceeded).
• Up to 20 requests per JSON-RPC batch array; larger batches get a -32600 Invalid Request error.
• generate_and_publish_banner: 10 publishes per 10 minutes and 10 per 7 days per IP. Submissions are moderated before they appear in the gallery.
• Banner text is limited to 200 characters.

$ More

• REST API documentation (text banners, gallery, HTML export)
• OpenAPI 3.1 spec (/openapi.json)
• API catalog (/.well-known/api-catalog)
• Open the ASCII art generator