muapi MCP Server

Connect any MCP-compatible AI assistant to muapi.ai — access 100+ generative AI models (image, video, audio, enhance, edit) directly from Claude, Cursor, Windsurf, and more.

---

Quick Start (Hosted — Recommended)

The fastest way: use the hosted MCP server at https://api.muapi.ai/mcp. No installation required — just add it to your client.

Get your API key at muapi.ai/dashboard/keys

Claude Code

claude mcp add --transport http muapi \
  https://api.muapi.ai/mcp \
  --header "Authorization: Bearer YOUR_MUAPI_KEY"

Cursor

Open Cmd+Shift+P → Open MCP settings and add to mcp.json:

{
  "mcpServers": {
    "muapi": {
      "url": "https://api.muapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MUAPI_KEY"
      }
    }
  }
}

Windsurf

Open Settings → MCP and add:

{
  "mcpServers": {
    "muapi": {
      "serverUrl": "https://api.muapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MUAPI_KEY"
      }
    }
  }
}

Claude Desktop / Other clients

Add to your MCP client config:

{
  "mcpServers": {
    "muapi": {
      "url": "https://api.muapi.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MUAPI_KEY"
      }
    }
  }
}

---

Self-Hosted Setup

If you want to run your own MCP server instance:

1. Clone the repo

git clone https://github.com/SamurAIGPT/muapi-mcp-server.git
cd muapi-mcp-server

2. Install dependencies

pip install fastapi uvicorn requests pydantic

3. Set your API key

export MUAPIAPP_API_KEY=your_muapi_key_here

4. Start the server

python mcp_server.py

The server starts at http://localhost:8000.

5. Configure your client

Point your MCP client to your local server:

{
  "mcpServers": {
    "muapi": {
      "url": "http://localhost:8000",
      "headers": {
        "x-api-key": "YOUR_MUAPI_KEY"
      }
    }
  }
}

Environment Variables

Variable	Description	Default
MUAPIAPP_API_KEY	Your muapi.ai API key	required
MODELS_JSON	Path to models config JSON	models.json
PORT	Server port	8000

---

Available Tools

Once connected, your AI assistant has access to these tools:

Discovery

Tool	Description
search_models	Search muapi's 100+ model catalog by keyword or category

Image Generation

Tool	Models	Description
muapi_image_generate	flux-dev, flux-schnell, flux-kontext-dev/pro/max, hidream-fast/dev/full, wan2.1, reve, gpt4o, midjourney, seedream, qwen	Generate images from text prompts
muapi_image_edit	flux-kontext-dev/pro/max/effects, gpt4o, reve, seededit, midjourney, midjourney-style, midjourney-omni, qwen	Edit or transform images

Video Generation

Tool	Models	Description
muapi_video_generate	veo3, veo3-fast, kling-master, wan2.1/2.2, seedance-pro/lite, hunyuan, runway, pixverse, vidu, minimax-std/pro	Generate videos from text
muapi_video_from_image	veo3, veo3-fast, kling-std/pro/master, wan2.1/2.2, seedance, hunyuan, runway, pixverse, vidu, midjourney, minimax	Animate images into videos

Audio

Tool	Description
muapi_audio_create	Create original music with Suno (prompt, title, tags, instrumental mode)
muapi_audio_from_text	Generate sound effects or ambient audio with MMAudio

Image Enhancement

Tool	Description
muapi_enhance_upscale	AI super-resolution upscaling
muapi_enhance_bg_remove	Background removal
muapi_enhance_face_swap	Face swap in images or videos
muapi_enhance_ghibli	Studio Ghibli style transfer

Video Editing

Tool	Models	Description
muapi_edit_lipsync	sync, latentsync, creatify, veed	Sync lip movements to audio
muapi_edit_clipping	—	Extract highlight clips from long videos

Async Polling

Tool	Description
muapi_predict_result	Poll for the result of any async generation job

Account & Keys

Tool	Description
muapi_account_balance	Check your current credit balance
muapi_account_topup	Create a Stripe checkout session to add credits
muapi_keys_list	List your API keys
muapi_keys_create	Create a new API key
muapi_keys_delete	Delete an API key

---

Usage Examples

Once your MCP client is connected, you can ask your AI assistant naturally:

Generate an image:

"Generate a photorealistic mountain lake at golden hour using flux-dev"

Edit an image:

"Convert this image to Studio Ghibli style" (attaches image URL)

Create a video:

"Make a 5-second cinematic video of a robot walking through a forest using kling-master"

Animate an image:

"Turn this product photo into a 5-second video" (attaches image URL)

Create music:

"Create a 30-second lo-fi hip hop track, instrumental"

Check balance:

"What's my muapi credit balance?"

Find models:

"What image generation models are available on muapi?"

---

How Async Generation Works

Most generation tools return a request_id immediately:

{ "request_id": "abc123", "status": "processing" }

Your assistant will automatically poll muapi_predict_result until the job completes:

{
  "request_id": "abc123",
  "status": "completed",
  "outputs": ["https://cdn.muapi.ai/..."]
}

---

API Reference

The self-hosted server exposes these endpoints:

Method	Path	Description
GET	/	Server info and endpoint list
GET	/health	Health check
GET	/mcp/tools	List available tools/models
POST	/mcp/tools/{tool_name}/call	Call a specific tool
POST	/mcp/run	Run a model by name or endpoint URL
GET	/mcp/predictions/{id}	Get prediction status and result
GET	/mcp/predictions/{id}/stream	Stream prediction status as SSE
GET	/mcp/resources	List models as MCP resources
GET	/docs	Interactive API docs (Swagger UI)

---

Authentication

Hosted server — pass your API key in the Authorization header:

Authorization: Bearer YOUR_MUAPI_KEY

Self-hosted server — pass via x-api-key header or set MUAPIAPP_API_KEY environment variable.

Get your API key at muapi.ai/dashboard/keys.

---

Links

• muapi.ai — Platform
• API Documentation — Full REST API reference
• muapi CLI — Command-line interface
• Dashboard — Manage keys and credits