Can I check the progress of my image generation through my agent?

Yes. Use the `get_generation_status` tool with the Generation ID provided when you started the request. Your agent will poll the Leonardo API and return the final image URLs and metadata once the process is complete.

How do I find which AI models are available for generation?

Ask your agent to `list_platform_models` or `list_custom_models`. It will return a list of available UUIDs and model names (like Phoenix or Kino XL), which are required when triggering a new image generation request.

Can my agent perform image-to-image transformations?

Absolutely. Use the `upload_init_image` tool to acquire a secure presigned URL for your source image. Once uploaded, you can command your agent to trigger a generation that uses that image as a reference for guided AI transformations.

Leonardo.ai (Generative AI & Models) MCP Server for OpenAI Agents SDK 10 tools — connect in under 2 minutes

Name: Leonardo.ai (Generative AI & Models)
Availability: InStock
Author: Vinkius

openai.github.io/openai-agents-python/mcp

Built by Vinkius GDPR 10 Tools SDK

The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect Leonardo.ai (Generative AI & Models) through the Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails — no manual schema definitions required.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp

async def main():
    # Your Vinkius token — get it at cloud.vinkius.com
    async with MCPServerStreamableHttp(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as mcp_server:

        agent = Agent(
            name="Leonardo.ai (Generative AI & Models) Assistant",
            instructions=(
                "You help users interact with Leonardo.ai (Generative AI & Models). "
                "You have access to 10 tools."
            ),
            mcp_servers=[mcp_server],
        )

        result = await Runner.run(
            agent, "List all available tools from Leonardo.ai (Generative AI & Models)"
        )
        print(result.final_output)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Leonardo.ai (Generative AI & Models) MCP Server

Connect your Leonardo.ai account to any AI agent and take full control of state-of-the-art generative image production and custom AI models through natural conversation.

The OpenAI Agents SDK auto-discovers all 10 tools from Leonardo.ai (Generative AI & Models) through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns — chain multiple agents where one queries Leonardo.ai (Generative AI & Models), another analyzes results, and a third generates reports, all orchestrated through the Vinkius.

What you can do

Generation Orchestration — Initiate asynchronous image generation requests defining precise prompts, model UUIDs, and dimensions directly from your agent
Model Discovery — Enumerate global platform models (Phoenix, Kino XL) and your fine-tuned custom models to understand available inference capabilities
Image-to-Image — Acquire secure presigned URLs to upload initial images for guided AI generation and reference-based transformations
Precision Variations — Create unzoom context extensions and visual variations expanding previously generated images while maintaining structural consistency
Inventory Audit — List recent user generations and retrieve absolute image URLs, prompts used, and exact hardware metadata securely
User Metrics — Monitor active account metrics and token usage allocations to manage your generation budget and operational costs in real-time

The Leonardo.ai (Generative AI & Models) MCP Server exposes 10 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Leonardo.ai (Generative AI & Models) to OpenAI Agents SDK via MCP

Follow these steps to integrate the Leonardo.ai (Generative AI & Models) MCP Server with OpenAI Agents SDK.

Install the SDK

Run pip install openai-agents in your Python environment

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.com

Run the script

Save the code above and run it: python agent.py

Explore tools

The agent will automatically discover 10 tools from Leonardo.ai (Generative AI & Models)

Why Use OpenAI Agents SDK with the Leonardo.ai (Generative AI & Models) MCP Server

OpenAI Agents SDK provides unique advantages when paired with Leonardo.ai (Generative AI & Models) through the Model Context Protocol.

Native MCP integration via `MCPServerSse` — pass the URL and the SDK auto-discovers all tools with full type safety

Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure

Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate

First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output

Leonardo.ai (Generative AI & Models) + OpenAI Agents SDK Use Cases

Practical scenarios where OpenAI Agents SDK combined with the Leonardo.ai (Generative AI & Models) MCP Server delivers measurable value.

Automated workflows: build agents that query Leonardo.ai (Generative AI & Models), process the data, and trigger follow-up actions autonomously

Multi-agent orchestration: create specialist agents — one queries Leonardo.ai (Generative AI & Models), another analyzes results, a third generates reports

Data enrichment pipelines: stream data through Leonardo.ai (Generative AI & Models) tools and transform it with OpenAI models in a single async loop

Customer support bots: agents query Leonardo.ai (Generative AI & Models) to resolve tickets, look up records, and update statuses without human intervention

Leonardo.ai (Generative AI & Models) MCP Tools for OpenAI Agents SDK (10)

These 10 tools become available when you connect Leonardo.ai (Generative AI & Models) to OpenAI Agents SDK via MCP:

create_variation

Create an unzoom context extension expanding a Leonardo.ai generated image

delete_generation

Delete a Leonardo generation history log and its image array explicitly

generate_image

Returns a Generation ID used to poll for the output. Generate images from a text prompt using Leonardo.ai

get_generation

Get the active status or completed result of a generation

get_model

Get specific details and parameters of a Leonardo.ai model

get_user

Get active authenticated Leonardo AI user metrics

list_custom_models

List fine-tuned and custom-trained models available explicitly on your Leonardo instance

list_platform_models

List all global public platform models hosted on Leonardo.ai

list_user_generations

List recent image generations initiated by a specific Leonardo user

upload_init_image

Acquire a secure presigned URL tracking for image-to-image inference datasets

Example Prompts for Leonardo.ai (Generative AI & Models) in OpenAI Agents SDK

Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with Leonardo.ai (Generative AI & Models) immediately.

"Generate a futuristic cityscape at sunset using the Phoenix model"

"List my last 3 image generations"

"Check my current token balance and account limits"

Troubleshooting Leonardo.ai (Generative AI & Models) MCP Server with OpenAI Agents SDK

Common issues when connecting Leonardo.ai (Generative AI & Models) to OpenAI Agents SDK through the Vinkius, and how to resolve them.

MCPServerStreamableHttp not found

Ensure you have the latest version: pip install --upgrade openai-agents

Agent not calling tools

Make sure your prompt explicitly references the task the tools can help with.

Leonardo.ai (Generative AI & Models) + OpenAI Agents SDK FAQ

Common questions about integrating Leonardo.ai (Generative AI & Models) MCP Server with OpenAI Agents SDK.

How does the OpenAI Agents SDK connect to MCP?

Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.