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 分