---
name: replicate
description: "Image generation via Replicate — three models for different production needs."
tools:
  - name: image-generate
    publicAllowlist: false
    adminAllowlist: false
    riskClass: external
  - name: replicate-key-store
    publicAllowlist: false
    adminAllowlist: true
    riskClass: write_local
  - name: replicate-key-verify
    publicAllowlist: false
    adminAllowlist: true
    riskClass: read
metadata: {"platform":{"optional":true,"recommended":true,"pluginKey":"replicate"}}
mcp:
  command: node
  args:
    - ${PLATFORM_ROOT}/lib/mcp-spawn-tee/dist/index.js
    - ${PLATFORM_ROOT}/plugins/replicate/mcp/dist/index.js
  env:
    MCP_SPAWN_TEE_NAME: replicate
    LOG_DIR: ${LOG_DIR}
    PLATFORM_ROOT: ${PLATFORM_ROOT}
    ACCOUNT_ID: ${ACCOUNT_ID}
    SESSION_ID: ${SESSION_ID}
mcp-manifest: auto
---

# Replicate — Image Generation

Generates images from text prompts using three Replicate-hosted models chosen for complementary strengths in knowledge-work production.

## Capabilities

- **image-generate** — produce images from text prompts. Three models: `nano-banana-pro` (photorealistic, data-driven visuals, multilingual text rendering), `recraft-v4` (design-quality compositions, branded assets, supports SVG), `flux-schnell` (fast drafts for iteration).
- **replicate-key-store** — validate and store a Replicate API token.
- **replicate-key-verify** — check whether a stored token is still valid.

## Aspect ratio — set it explicitly

`image-generate` takes an `aspectRatio` parameter that **defaults to `1:1` (square)**. For any non-square placement you MUST set it, or the output is a square that then has to be cropped, which silently loses content (faces, props, edges).

Supported values: `1:1`, `4:3`, `3:2`, `16:9`, `21:9`, `9:16`.

Rule of thumb: full-bleed hero banner = `21:9`, standard hero or in-page image = `16:9`, square tile = `1:1`, portrait = `9:16`. Never accept the square default for a landscape placement.

## API token

Requires a Replicate API token (`r8_` prefix). Obtained from https://replicate.com/account/api-tokens. Stored at `~/.replicate/api-token` with `0o600` permissions. The `REPLICATE_API_TOKEN` environment variable takes precedence when set.