FlipLetters

FlipLetters MCP

适用于 FlipLetters 的模型上下文协议服务。 FlipLetters 可制作翻页式和翻点式显示板视频（呈现老式火车站出发信息牌的效果），并配有合成机械音效。显示板采用 flipcode 编写，这是一种简洁的开放文本格式。此 MCP 可让 AI Agent 起草并验证显示板、创建 Studio 分享链接、渲染 MP4，并将显示板发送到团队资料库或 Postiz 社交媒体队列。

• 📚 文档： flipletters.com/mcp · flipcode 参考
• 🌐 端点： https://app.flipletters.com/mcp/v1（Streamable HTTP；别名 https://app.flipletters.com/api/mcp）
• 🔑 API 密钥： FlipLetters Studio → Account → API keys & agents（密钥以 flk_ 开头；创建免费）
• 💻 本地运行，无需密钥： npx -y flipletters-mcp-server（通过 stdio 使用起草工具）
• 🗂️ 注册表名称： com.flipletters/mcp

这是一个公开列表仓库（README、server.json、LICENSE）。托管的 MCP 在上述端点运行。flipcode 解析器在 tera-sarah/flipcode 开源（MIT）。

---

连接

托管服务（每次 tools/call 都需要 flk_ 密钥）

Cursor（~/.cursor/mcp.json 或 .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（通过 mcp-remote 桥接程序配置 claude_desktop_config.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" }
    }
  }
}

本地 stdio（无需密钥即可使用起草工具）

{
  "mcpServers": {
    "flipletters": {
      "command": "npx",
      "args": ["-y", "flipletters-mcp-server"],
      "env": { "FLIPLETTERS_API_KEY": "optional: flk_ key for render and team tools" }
    }
  }
}

然后提问：“制作一块火车站显示板，依次翻出 ‘NOW BOARDING’、‘GATE 12’、‘ON TIME’。”

---

工具

查看工具列表（GET https://app.flipletters.com/mcp/v1 或 tools/list）无需密钥。在托管服务上，每次 tools/call 都需要 Authorization: Bearer flk_…。

起草

工具	功能
flipletters_flipcode_reference	flipcode 速查表：指令、显示板类型、尺寸限制和转场效果。
flipletters_example_board	指定显示板类型的完整有效 flipcode 文档。
flipletters_validate_board	解析草稿：返回规范化代码、警告和分享 URL。
flipletters_template_url	易读的 Studio URL，其中每个查询参数都对应一行 flipcode。

渲染和分享

工具	功能
flipletters_render_board	根据密钥所有者的套餐启动云端 MP4 渲染。
flipletters_render_status	查询渲染任务状态。
flipletters_list_teams	列出密钥所有者所属的团队。
flipletters_share_to_team	将显示板分享到团队资料库。

工作区和 Postiz

工具	功能
flipletters_list_workspaces	列出密钥所有者的代理项目（工作区）。
flipletters_list_postiz_destinations	列出项目关联的 Postiz 发布目标。
flipletters_list_postiz_integrations	列出项目 Postiz 账户已连接的社交渠道。
flipletters_share_to_postiz	通过 Postiz 上传媒体并安排发布、保存为草稿或直接发布。

创建密钥免费。渲染用量遵循密钥所有者的套餐（免费导出额度、Premium 或 Studio），与 Studio 界面中的规则相同。

发现

URL	返回内容
GET https://app.flipletters.com/mcp/v1	服务信息和工具列表（无需密钥）。
GET https://app.flipletters.com/.well-known/mcp/server.json	MCP 服务清单。
GET https://flipletters.com/llms.txt	面向 Agent 的网站摘要。

链接

• flipletters.com · Studio · 隐私政策 · 条款
• npm：flipletters-mcp-server · @flipletters/flipcode
• 联系方式：[email protected]