Model Context Protocol

FlipLetters MCP

The FlipLetters MCP server lets agents draft, validate, and share split-flap boards as flipcode. It is available over hosted Streamable HTTP (connect by URL) and as a local stdio process via npm. Hosted HTTP requires a Studio API key for every tools/call. Local stdio draft tools need no key.

Hosted (Cursor / remote MCP)

URL: https://app.flipletters.com/mcp/v1 (the older /api/mcp path still works). Discovery: /.well-known/mcp/server.json. GET is a liveness descriptor (no key). Every hosted tools/call requires Authorization: Bearer flk_… minted in Studio → Account → API keys & agents.

{
  "mcpServers": {
    "flipletters": {
      "url": "https://app.flipletters.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer flk_…"
      }
    }
  }
}

Local stdio

npx -y flipletters-mcp-server

npm: flipletters-mcp-server

{
  "mcpServers": {
    "flipletters": {
      "command": "npx",
      "args": ["-y", "flipletters-mcp-server"],
      "env": {
        "FLIPLETTERS_API_KEY": "flk_…optional…",
        "FLIPLETTERS_API_URL": "https://app.flipletters.com"
      }
    }
  }
}

Local stdio draft tools need no key. Cloud render, team library, and Postiz tools need FLIPLETTERS_API_KEY from Studio → Account → API keys & agents. Hosted HTTP is different: every tools/call needs the same flk_… key. See the FlipLetters API and agent guide.