Leonardo MCP

A Model Context Protocol server that exposes Leonardo.ai image generation as MCP tools over Streamable HTTP.

Features

• generate_image — submit an image generation job to Leonardo.ai (v2 API).

• get_generation_status — poll a job and retrieve generated image URLs.

• Stateful Streamable HTTP transport with per-session management.

• Supports GPT Image models (quality) and Phoenix models (mode).

Related MCP server: creator-factory-mcp

Requirements

• Node.js 20+

• A Leonardo.ai API key

Setup

npm install

Set the required environment variables:

export LEONARDO_API_KEY="your-api-key"
export PORT=3001   # optional, defaults to 3001

Build & Run

npm run build
npm start

Or use the helper script (expects LEONARDO_API_KEY to already be exported):

./run.sh

The server listens on http://0.0.0.0:3001/mcp by default.

MCP Client Configuration

Point your MCP client at the HTTP endpoint. Example:

{
  "mcpServers": {
    "leonardo": {
      "url": "http://localhost:3001/mcp"
    }
  }
}

Tools

generate_image

Returns a generation_id to poll with get_generation_status.

get_generation_status

Returns the job status and, when complete, the generated image URLs.

Project Structure

src/index.ts          Main Streamable HTTP MCP server
sources/index_stdio.js Reference stdio-based implementation (v1 API)
dist/                 Compiled JavaScript output

License

MIT — see LICENSE.