API & MCP Integration

Integrate Ludo.ai directly into your workflow with our powerful API and MCP support.

Getting Started

Ludo.ai's API and MCP integration allows you to leverage our generative AI models directly within your own applications and workflows. Automate asset creation, streamline your pipeline, and access our full suite of tools programmatically.

Available Features

Images & Animation

Create sprites, icons, UI assets, textures, and backgrounds. Bring them to life with spritesheet animations.

Video & 3D

Generate videos from images with motion prompts. Convert 2D art into textured 3D models.

Audio

Create sound effects, music tracks, and character voices. Clone voices for text-to-speech.

Which plan do I need?

Lowest plan with API & MCP

Pro

$50/mo

1,000 generation credits / month

API & MCP access included

Studio

$350/mo

10,000 generation credits / month · 10 seats

API & MCP access included

API & MCP access is not available on the Free trial or Indie plans. Studio adds more seats, higher rate limits, and concurrent generation jobs. Compare all plans →

In 3 Simple Steps:

Subscribe to Pro or Studio

API and MCP access is included on the Pro and Studio plans.

Get Your API Key

Start Integrating

Use the MCP integration for AI assistants or the REST API for custom apps.

What a generation costs

API and MCP requests consume credits, even on plans with unlimited web features. Each Pro or Studio plan includes a monthly credit allowance; here's what typical calls cost:

Image / sprite / icon0.5 credits

Sprite-sheet animationfrom 5 credits

3D model (GLB)3 credits

Videofrom 5 credits

Sound effect2 credits

Music track3 credits

Voice / text-to-speech1 credit

Video and sprite animation are billed per-second based on the model you choose (roughly 0.6–2.6 credits/second). See the API documentation for full pricing.

MCP (Model Context Protocol)

Connect Ludo.ai to AI assistants like Claude using the Model Context Protocol. Generate game assets, animate sprites, and create visuals directly through natural language conversations.

Using Cursor? See how to generate game assets in Cursor →

One-click install:Add to Cursor Add to VS Codethen paste your API key

MCP Server URL

https://mcp.ludo.ai/mcp

Use this URL to connect any MCP-compatible client.

Authentication Header

Authentication: ApiKey YOUR_API_KEY

Quick Setup with Claude Code

Run this command to add Ludo.ai as an MCP server:

claude mcp add ludo https://mcp.ludo.ai/mcp -t http -H "Authentication: ApiKey YOUR_API_KEY"

1Replace YOUR_API_KEY with your Ludo.ai API key.

2Run the command in your terminal to register the MCP server.

Timeout Fix: Recent Claude Code versions have a bug causing MCP tool calls to timeout after 60 seconds, which may not be enough for 3D generation. To fix this, downgrade to version 2.0.32 and start with a longer timeout:

claude update --version 2.0.32 && MCP_TOOL_TIMEOUT=600000 claude

Setup with Codex

Add Ludo.ai to OpenAI Codex by editing ~/.codex/config.toml:

[mcp_servers.ludo-ai]
url = "https://mcp.ludo.ai/mcp"
tool_timeout_sec = 600

[mcp_servers.ludo-ai.http_headers]
Authentication = "ApiKey YOUR_API_KEY"

Replace YOUR_API_KEY with your Ludo.ai API key, then restart Codex so it reconnects with the new configuration. tool_timeout_sec raises Codex's default 60-second tool timeout, which is too short for 3D and video generation.

Setup with Cursor

Add Ludo.ai to Cursor using either the Settings UI or manual configuration:

Option 1: Cursor Settings UI

Open Cursor Settings (Cmd+, on Mac or Ctrl+, on Windows/Linux)
Go to Tools & MCP section and click New MCP Server
Set Server Name to ludo-ai
Set Transport Type to http
Set URL to https://mcp.ludo.ai/mcp
Add a header: Authentication with value ApiKey YOUR_API_KEY
Save and restart Cursor

Option 2: Manual Configuration

Edit your Cursor MCP config file at ~/.cursor/mcp.json (or .cursor/mcp.json in your project):

{
  "mcpServers": {
    "ludo-ai": {
      "url": "https://mcp.ludo.ai/mcp",
      "transport": "http",
      "headers": {
        "Authentication": "ApiKey YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Ludo.ai API key, then restart Cursor.

Option 3: mcp-remote proxy (fallback)

If the direct HTTP connection above doesn't connect, use the mcp-remote proxy instead. It runs locally via npx and bridges to our server. Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ludo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ludo.ai/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authentication: ApiKey YOUR_API_KEY"
      ]
    }
  }
}

Replace YOUR_API_KEY with your Ludo.ai API key, then restart Cursor. Requires Node.js installed (for npx).

REST API

Build custom integrations with Ludo.ai using our comprehensive REST API. Generate game assets, animate sprites programmatically, and integrate AI-powered asset creation into your pipeline.

Base URL

https://api.ludo.ai/api/

All endpoints are relative to this base URL.

AuthenticationInclude this header in all API requests:

Authentication: ApiKey YOUR_API_KEY

Full programmatic access to asset generation features

RESTful endpoints with JSON responses

Comprehensive documentation with examples

Using Unity? Check out our Unity Plugin to generate assets directly in the Editor.

Need help with integration?

Join our DiscordorContact us