English Français العربية

FlipLetters

Official registry Media and design

Draft, validate, render, and share split-flap and flip-dot board videos written in flipcode.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http flipletters 'https://app.flipletters.com/mcp/v1' --header 'Authorization: <Bearer token: your flk_ API key from FlipLetters Studio > Account > API keys & agents>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "flipletters": {
            "type": "http",
            "url": "https://app.flipletters.com/mcp/v1",
            "headers": {
                "Authorization": "<Bearer token: your flk_ API key from FlipLetters Studio > Account > API keys & agents>"
            }
        }
    }
}
NPM package flipletters-mcp-server
Claude Code 
claude mcp add flipletters -e 'FLIPLETTERS_API_KEY=<your flipletters_api_key>' -- npx -y flipletters-mcp-server@0.3.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "flipletters": {
            "command": "npx",
            "args": [
                "-y",
                "flipletters-mcp-server@0.3.1"
            ],
            "env": {
                "FLIPLETTERS_API_KEY": "<your flipletters_api_key>"
            }
        }
    }
}

Environment variables

  • FLIPLETTERS_API_KEY required secret Your flk_ API key

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. FlipLetters MCP
  2. Connect
  3. Tools
  4. Discovery
  5. Links

FlipLetters MCP

The Model Context Protocol server for FlipLetters. FlipLetters makes split-flap and flip-dot board videos (the look of an old train-station departure board) with synthesized mechanical sound. Boards are written in flipcode, a small open text format. This MCP lets AI agents draft and validate boards, build Studio share links, render MP4s, and send boards to a team library or a Postiz social queue.

  • 📚 Docs: flipletters.com/mcp · flipcode reference
  • 🌐 Endpoint: https://app.flipletters.com/mcp/v1 (Streamable HTTP; alias https://app.flipletters.com/api/mcp)
  • 🔑 API key: FlipLetters Studio → Account → API keys & agents (keys start with flk_; free to create)
  • 💻 Local, no key: npx -y flipletters-mcp-server (draft tools over stdio)
  • 🗂️ Registry name: com.flipletters/mcp

This is a public listing repo (README, server.json, LICENSE). The hosted MCP runs at the endpoint above. The flipcode parser is open source (MIT) at tera-sarah/flipcode.

Connect

Hosted (every tools/call needs a flk_ key)

Cursor (~/.cursor/mcp.json or .cursor/mcp.json):

{
  "mcpServers": {
    "flipletters": {
      "url": "https://app.flipletters.com/mcp/v1",
      "headers": { "Authorization": "Bearer YOUR_FLK_KEY" }
    }
  }
}

Claude Code:

claude mcp add --transport http flipletters https://app.flipletters.com/mcp/v1 \
  --header "Authorization: Bearer YOUR_FLK_KEY"

Claude Desktop (claude_desktop_config.json, via the mcp-remote bridge):

{
  "mcpServers": {
    "flipletters": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://app.flipletters.com/mcp/v1",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer YOUR_FLK_KEY" }
    }
  }
}
Local stdio (draft tools work with no key)
{
  "mcpServers": {
    "flipletters": {
      "command": "npx",
      "args": ["-y", "flipletters-mcp-server"],
      "env": { "FLIPLETTERS_API_KEY": "optional: flk_ key for render and team tools" }
    }
  }
}

Then ask: "Make a trainboard that flips through 'NOW BOARDING', 'GATE 12', 'ON TIME'."

Tools

Listing tools (GET https://app.flipletters.com/mcp/v1 or tools/list) is open. On the hosted server, every tools/call needs Authorization: Bearer flk_….

Draft
ToolWhat it does
flipletters_flipcode_referenceThe flipcode cheat sheet: directives, board types, size limits, transitions.
flipletters_example_boardA complete, valid flipcode document for a board type.
flipletters_validate_boardParse a draft: normalized code, warnings, and a share URL.
flipletters_template_urlA readable Studio URL where each query parameter mirrors one flipcode line.
Render and share
ToolWhat it does
flipletters_render_boardStart a cloud MP4 render under the key owner's plan.
flipletters_render_statusPoll a render job.
flipletters_list_teamsTeams the key owner belongs to.
flipletters_share_to_teamShare a board into a Team Library.
Workspaces and Postiz
ToolWhat it does
flipletters_list_workspacesAgency projects (workspaces) for the key owner.
flipletters_list_postiz_destinationsPostiz destinations attached to a project.
flipletters_list_postiz_integrationsConnected social channels for a project's Postiz account.
flipletters_share_to_postizUpload media and schedule, draft, or post it through Postiz.

Creating a key is free. Render usage follows the key owner's plan (free export quota, Premium, or Studio), the same as in the Studio UI.

Discovery

URLReturns
GET https://app.flipletters.com/mcp/v1Server info and tool list (no key).
GET https://app.flipletters.com/.well-known/mcp/server.jsonMCP server manifest.
GET https://flipletters.com/llms.txtAgent-readable site summary.

Frequently asked questions

What is FlipLetters?

Draft, validate, render, and share split-flap and flip-dot board videos written in flipcode.

How do I install FlipLetters?

It runs as a remote server. In Claude Code: claude mcp add --transport http flipletters 'https://app.flipletters.com/mcp/v1' --header 'Authorization: <Bearer token: your flk_ API key from FlipLetters Studio > Account > API keys & agents>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does FlipLetters need an API key?

Yes. It expects FLIPLETTERS_API_KEY, Authorization, which you set in its configuration.

Is FlipLetters open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains FlipLetters?

It is published by Terahertz-Inc. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.