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.

In 3 Simple Steps:

Subscribe to a Plan

API and MCP features are available on select subscription plans.

Get Your API Key

Start Integrating

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

Beta Notice

The API and MCP integration is currently in beta. During this period, stricter rate limits apply. Currently, only 1 simultaneous request is allowed per endpoint. If your use case requires higher throughput, please contact us to discuss your needs.

Credit Usage

API and MCP requests consume credits, even on plans with unlimited web features. Credit costs vary by endpoint: 0.5 for images, 3 for audio and 3D,5 for animations, and 5-15 for video depending on duration. Check the API documentation for detailed 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.

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 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.

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

Need help with integration?

Join our DiscordorContact us