Leonardo AI MCP Server
About
MCP server for Leonardo AI API - Free daily credits for AI image generation
Details
- Author
- nikolausm
- Downloads
- 1,087
- Categories
- Other
Jump to
- Generate high-quality images using various AI models
- 150 free credits daily (resets at midnight UTC)
- Support for multiple art styles and models
- Batch generation (1–4 images at once)
- Save images locally or get URLs
- Check remaining credits
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Leonardo AI MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Clone the repository, install dependencies with npm install, set the LEONARDO_API_KEY environment variable, then add the server to your Claude Desktop configuration. Use tools like generate_image, check_credits, and list_models to create images, monitor credits, or browse available models.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"leonardo ai mcp server": {
"leonardo-ai": {
"command": "node",
"args": [
"/path/to/leonardo-ai-mcp-server/index.js"
],
"env": {
"LEONARDO_API_KEY": ""
}
}
}
}
}McpServers
{
"leonardo-ai": {
"command": "node",
"args": [
"/path/to/leonardo-ai-mcp-server/index.js"
],
"env": {
"LEONARDO_API_KEY": ""
}
}
}Leonardo AI MCP Server
An MCP (Model Context Protocol) server that provides access to Leonardo AI's image generation API with 150 free daily credits.
Features
- Generate high-quality images using various AI models
- 150 free credits daily (refreshes at midnight)
- Support for multiple art styles and models
- Batch generation (1-4 images at once)
- Save images locally or get URLs
- Check remaining credits
Available Models
- Leonardo Diffusion XL: High-quality general purpose model
- Leonardo Vision XL: Photorealistic and artistic styles
- Leonardo Anime XL: Anime and manga style images
- DreamShaper v7: Fantasy and dreamlike images
- Realistic Vision v5: Highly realistic photographs
Installation
1. Clone this repository:
git clone https://github.com/nikolausm/leonardo-ai-mcp-server.git
cd leonardo-ai-mcp-server
2. Install dependencies:
npm install
3. Get your Leonardo AI API key:
- Sign up at https://leonardo.ai (free)
- Go to API settings
- Generate an API key
- Copy the key
4. Set up environment variable:
export LEONARDO_API_KEY="your_api_key_here"
Configuration in Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"leonardo-ai": {
"command": "node",
"args": ["/path/to/leonardo-ai-mcp-server/index.js"],
"env": {
"LEONARDO_API_KEY": "your_api_key_here"
}
}
}
}
Usage
Generate an Image
// Basic usage
generate_image({
prompt: "a majestic castle on a hilltop at sunset"
})
// Advanced usage
generate_image({
prompt: "cute cartoon guinea pig with big eyes",
model: "leonardo-anime-xl",
negative_prompt: "realistic, scary, dark",
num_images: 2,
width: 768,
height: 768,
guidance_scale: 10,
save_path: "/tmp/guinea_pig.png"
})
Check Remaining Credits
check_credits()
List Available Models
list_models()
Free Credits System
- 150 credits daily (resets at midnight UTC)
- Each image costs approximately 2 credits
- That's about 75 images per day for free!
- No credit card required
Tips for Better Results
1. Use specific models:
- leonardo-anime-xl for anime/cartoon style
- realistic-vision-v5 for photorealistic images
- dreamshaper-v7 for fantasy art
2. Optimize dimensions:
- Use multiples of 8 (512, 768, 1024)
- Square images often work best
3. Negative prompts are powerful:
- Use them to avoid unwanted elements
- Example: "blurry, low quality, distorted"
Examples
Children's Book Illustration
generate_image({
prompt: "friendly guinea pig reading a book, children's illustration, soft pastel colors",
model: "leonardo-diffusion-xl",
negative_prompt: "realistic, dark, scary",
width: 768,
height: 768
})
Educational Poster
generate_image({
prompt: "educational poster showing guinea pig care, clean design, infographic style",
model: "leonardo-vision-xl",
num_images: 3,
guidance_scale: 12
})
Error Handling
The server handles common errors:
- Invalid API key
- Insufficient credits
- Generation failures
- Timeout issues
License
MIT
Author
Michael Nikolaus
Links
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
