FlipLetters

com.fliplettersPublished by flipletters.comOfficial publisherv0.3.1Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableCommunication & CollaborationMedia & Design

Overview

AI-generated overview

FlipLetters lets an assistant draft, validate, render and share split-flap and flip-dot board videos written in the flipcode text format.

What you can do
Look up the flipcode cheat sheet and get a complete example board for a chosen board type, so drafts are valid first time. Parse and validate a flipcode document, returning normalized code, warnings, a board summary and Studio share links. Build readable Studio template URLs where each query parameter mirrors a flipcode line. Render a board to a cloud MP4 and poll the render job until it finishes. List teams and share a board into a Team Library. List agency workspaces, Postiz destinations and connected social channels, then upload media and schedule, draft or post it.
When to use it
Useful when you want an assistant to produce split-flap or flip-dot board content, check that flipcode is valid, get a shareable Studio link, or turn a board into an MP4 and push it to a team library or social queue.
Requirements
Remote endpoint over Streamable HTTP, or the npm package flipletters-mcp-server over stdio. Hosted calls need a bearer token in the Authorization header, a flk_ API key created in FlipLetters Studio under Account, API keys and agents; the local stdio server can also read FLIPLETTERS_API_KEY. Draft tools work locally without a key; render, team and Postiz tools need one. Network access is required for rendering and sharing.
Before you install
The API key (Authorization header or FLIPLETTERS_API_KEY) is a secret tied to the owner's account and plan. Cloud renders consume the owner's plan quota; free renders carry a watermark. Sharing writes boards into a Team Library, and share_to_postiz uploads media and can schedule, draft or publish to connected social channels, so confirm before posting. Team and workspace listings expose invite codes and masked destination keys.

Installation

In SourceWeft

  1. Open FlipLetters in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.flipletters%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "flipletters": {
      "type": "http",
      "url": "https://app.flipletters.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

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):

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

Claude Code:

bash
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):

json
{  "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)

json
{  "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.

Links

Source: README.md at commit 69e22a5

Tools

13

flipletters_flipcode_reference

flipcode reference

Returns the flipcode cheat sheet (spec v1): directives, board types and size limits, transition modes, and flip-native effect recipes. Call this before writing a board so the code you produce is valid on the first try.

Takes no parameters.

flipletters_validate_board

Validate a board

Parses a flipcode document, returning the normalized canonical code, any warnings (out-of-range values are clamped, unknown lines ignored), a board summary, and links: a share URL that opens the exact board in the FlipLetters Studio, and an open-with-code URL that also reveals the code panel. Use this after drafting a board; fix warnings and re-validate until clean, then give the human the share link.

Parameterscoderequired

flipletters_example_board

Example board

Returns a complete, valid flipcode document for a board type (minimal, trainboard/station, artboard, flipdot, marquee, announcement, arena) — a known-good starting point to edit rather than writing from scratch.

Parameterstemplaterequired

flipletters_template_url

Readable template URL

Builds a human-readable FlipLetters Studio URL where every query parameter mirrors one flipcode line — good for short text boards you want legible in the address itself (chat messages, docs). For full fidelity or paint grids use flipletters_validate_board's share link instead. Slides are strings with | between rows.

Parametersoutflipgridholdboardsoundspeedtitleaccentslides

flipletters_create_animation

Create a split-flap animation from text

One call from plain text to a FlipLetters video: builds a board on a text template (default minimal), checks the text against FlipLetters content rules, cloud-renders an MP4 under the signed-in owner's plan (free renders carry the FlipLetters watermark), and returns mp4Url (downloadable HTTPS), shareUrl (opens in Studio), jobId, status and expiresAt. If the render is still running when this returns, poll flipletters_render_status with jobId.

Parameterstextrequiredtemplate

flipletters_render_board

Cloud-render a board to MP4

Parses flipcode and submits a cloud MP4 render under the API key owner's FlipLetters plan (same free quota / Premium / Studio limits as the Studio). Requires Authorization: Bearer flk_… (or FLIPLETTERS_API_KEY on stdio). Polls until done (or returns jobId if wait=false). Prefer share links for free previews; only render when the human wants an MP4 file.

Parameterscoderequiredwaitrepeat

flipletters_render_status

Cloud render job status

Poll a cloud render job started with flipletters_render_board. Requires Authorization: Bearer flk_….

ParametersjobIdrequired

flipletters_list_teams

List my teams

Lists FlipLetters teams the API key owner belongs to (teamId, name, inviteCode). Requires Authorization: Bearer flk_… with team scope.

Takes no parameters.

flipletters_share_to_team

Share board to team library

Parses flipcode and shares the board into a Team Library the key owner is a member of. Requires Authorization: Bearer flk_…. Use flipletters_list_teams first to get teamId.

ParameterscoderequirednamerequiredteamIdrequired

flipletters_list_workspaces

List FlipLetters projects

Lists agency projects (workspaces) for the API key owner, plus the active project id. Project-scoped keys return their bound project as active. Requires Authorization: Bearer flk_….

Takes no parameters.

flipletters_list_postiz_destinations

List Postiz share accounts on a project

Lists Postiz destinations (masked keys) attached to a FlipLetters project. Use flipletters_list_workspaces first. Requires Authorization: Bearer flk_….

ParametersworkspaceIdrequired

flipletters_list_postiz_integrations

List channels on a Postiz destination

Lists connected social channels for a project's Postiz share account. Use before flipletters_share_to_postiz to get integrationId. Requires Authorization: Bearer flk_….

ParametersworkspaceIdrequireddestinationIdrequired

flipletters_share_to_postiz

Schedule export on Postiz

Uploads a cloud media URL (or Studio host local fileName) to a project's Postiz destination and schedules/drafts/posts it. Loop: render_board → list_workspaces → list_postiz_destinations → list_postiz_integrations → share_to_postiz. Requires Authorization: Bearer flk_…. Prefer mediaUrl from flipletters_render_board.

ParametersdaterequiredtypecontentfileNamemediaUrlworkspaceIdrequiredproviderTypedestinationIdrequiredintegrationIdrequired

Version history

1
  1. v0.3.1LatestOct 17, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts