FlipLetters

FlipLetters MCP

FlipLetters 用の Model Context Protocol サーバーです。 FlipLetters は、合成された機械音とともに、パタパタ式や反転ドット式のボード動画（昔の駅の発車案内板のような見た目）を作成します。ボードは、小規模なオープンテキスト形式である flipcode で記述します。この MCP を使うと、AI エージェントがボードの下書きと検証、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（claude_desktop_config.json、mcp-remote ブリッジ経由）：

{
  "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』を順に表示する trainboard を作ってください。」

---

ツール

ツールの一覧表示（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	各クエリパラメーターが flipcode の各行に対応する、読みやすい Studio URL です。

レンダリングと共有

ツール	説明
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 経由でメディアをアップロードし、予約投稿、下書き保存、または投稿を行います。

キーは無料で作成できます。レンダリングの利用条件は、Studio UI と同様に、キー所有者のプラン（無料の書き出し枠、Premium、または 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	エージェントが読み取れるサイト概要。

リンク

• flipletters.com · Studio · プライバシー · 利用規約
• npm：flipletters-mcp-server · @flipletters/flipcode
• お問い合わせ：[email protected]