FlipLetters

com.flipletters由 flipletters.com 發布官方發布者v0.3.1更新於 Oct 24, 2026

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

已驗證Streamable HTTP可網頁執行溝通與協作媒體與設計

概覽

AI 產生的概覽

FlipLetters 讓助理用 flipcode 文字格式起草、驗證、算圖並分享翻牌與翻點風格的看板影片。

可以做什麼
查閱 flipcode 速查表，並依看板類型取得完整範例看板，讓初稿一次就能通過驗證。解析並驗證 flipcode 文件，回傳正規化程式碼、警告、看板摘要與 Studio 分享連結。產生易讀的 Studio 範本連結，每個查詢參數對應一行 flipcode。將看板雲端算圖為 MP4，並輪詢算圖工作直到完成。列出團隊並把看板分享到團隊庫。列出代理商工作區、Postiz 目的地與已連接的社群頻道，然後上傳媒體並排程、存草稿或發布。
適用情境
適合讓助理製作翻牌或翻點看板內容、檢查 flipcode 是否有效、取得可分享的 Studio 連結，或把看板算圖成 MP4 並推送到團隊庫或社群發布佇列。
執行需求
可使用 Streamable HTTP 遠端端點，或透過 stdio 執行 npm 套件 flipletters-mcp-server。託管呼叫需要在 Authorization 標頭提供 bearer 權杖，也就是在 FlipLetters Studio 的「帳戶 > API 金鑰與代理」建立的 flk_ API 金鑰；本機 stdio 服務也可讀取 FLIPLETTERS_API_KEY。起草類工具不需金鑰即可在本機使用；算圖、團隊與 Postiz 工具需要金鑰。算圖與分享需要網路存取。
安裝前請注意
API 金鑰（Authorization 標頭或 FLIPLETTERS_API_KEY）是與帳戶和方案綁定的機密。雲端算圖會消耗帳戶方案配額，免費算圖帶有浮水印。分享會把看板寫入團隊庫，share_to_postiz 會上傳媒體並可排程、存草稿或發布到已連接的社群頻道，發布前請先確認。團隊與工作區清單會揭露邀請碼與遮蔽後的目的地金鑰。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 FlipLetters，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.flipletters%2Fmcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

來源：README.md，提交 69e22a5

工具

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.

無需輸入參數。

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.

輸入參數code必填

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.

輸入參數template必填

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.

輸入參數outflipgridholdboardsoundspeedtitleaccentslides

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.

輸入參數text必填template

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.

輸入參數code必填waitrepeat

flipletters_render_status

Cloud render job status

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

輸入參數jobId必填

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.

無需輸入參數。

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.

輸入參數code必填name必填teamId必填

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_….

無需輸入參數。

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_….

輸入參數workspaceId必填

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_….

輸入參數workspaceId必填destinationId必填

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.

輸入參數date必填typecontentfileNamemediaUrlworkspaceId必填providerTypedestinationId必填integrationId必填

版本歷史

1
  1. v0.3.1最新Oct 17, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分