Flatkey MCP

Independently maintained by mguozhen for Flatkey API users. This is not yet a flatkey-ai organization release.

Use Flatkey from any MCP-compatible AI client. The server lists the models enabled for your Flatkey account, checks credits and status, and can generate text, images, video, speech, sound effects, and music.

Each generation tool is explicitly marked as credit-consuming so compatible clients can ask for confirmation before a paid request is sent.

Install

You need Node.js 20+ and a Flatkey API key from flatkey.ai/keys.

Codex

codex mcp add flatkey \
  --env FLATKEY_API_KEY=YOUR_FLATKEY_API_KEY \
  -- npx -y @mguozhen/flatkey-mcp@1.0.0

Claude Code

claude mcp add --transport stdio flatkey \
  --env FLATKEY_API_KEY=YOUR_FLATKEY_API_KEY \
  -- npx -y @mguozhen/flatkey-mcp@1.0.0

Generic MCP JSON

{
  "mcpServers": {
    "flatkey": {
      "command": "npx",
      "args": ["-y", "@mguozhen/flatkey-mcp@1.0.0"],
      "env": {
        "FLATKEY_API_KEY": "YOUR_FLATKEY_API_KEY"
      }
    }
  }
}

Keep your API key out of source control and public support requests.

Tools

Call flatkey_list_models before selecting a model. The available inventory can differ by account.

Configuration

Development

npm install
npm test
npm run lint
npm run pack:check

Routine tests use a mocked gateway; they do not spend Flatkey credits.

Security

• The MCP server receives the API key only through FLATKEY_API_KEY; it is never accepted as a tool argument.

• Tool errors are sanitized and never include an Authorization header.

• The generation tools can consume credits and are marked as destructive/paid actions for client confirmation.

Catalog metadata

server.json is the canonical manifest for the Official MCP Registry and compatible catalogs. CATALOG_COPY.md contains the listing copy. Do not submit the manifest until @mguozhen/flatkey-mcp@1.0.0 and the mguozhen/flatkey-mcp repository are public: registries validate that install target.