English Français العربية

FlipLetters

السجل الرسمي الوسائط والتصميم

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http flipletters 'https://app.flipletters.com/mcp/v1' --header 'Authorization: <Bearer token: your flk_ API key from FlipLetters Studio > Account > API keys & agents>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "flipletters": {
            "type": "http",
            "url": "https://app.flipletters.com/mcp/v1",
            "headers": {
                "Authorization": "<Bearer token: your flk_ API key from FlipLetters Studio > Account > API keys & agents>"
            }
        }
    }
}
NPM package flipletters-mcp-server
Claude Code 
claude mcp add flipletters -e 'FLIPLETTERS_API_KEY=<your flipletters_api_key>' -- npx -y flipletters-mcp-server@0.3.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "flipletters": {
            "command": "npx",
            "args": [
                "-y",
                "flipletters-mcp-server@0.3.1"
            ],
            "env": {
                "FLIPLETTERS_API_KEY": "<your flipletters_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • FLIPLETTERS_API_KEY إلزامي سري Your flk_ API key

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. FlipLetters MCP
  2. Connect
  3. Tools
  4. Discovery
  5. Links

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

{
  "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, via the mcp-remote bridge):

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

الأسئلة الشائعة

ما هو FlipLetters؟

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

كيف أثبّت FlipLetters؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http flipletters 'https://app.flipletters.com/mcp/v1' --header 'Authorization: <Bearer token: your flk_ API key from FlipLetters Studio > Account > API keys & agents>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج FlipLetters إلى مفتاح API؟

نعم. يتطلب FLIPLETTERS_API_KEY, Authorization، وتضبطها في إعداداته.

هل FlipLetters مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون FlipLetters؟

ينشره Terahertz-Inc. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.