Muapi Mcp Server

muapi MCP Server

[](https://muapi.ai?utmsource=github&utmmedium=badge&utm_campaign=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.

[](https://muapi.ai?utmsource=github&utmmedium=readme&utm_campaign=muapi-mcp-server) [](https://modelcontextprotocol.io) [](https://smithery.ai/servers/am-1m1k/muapi)

---

Install via Smithery

The easiest way to install for any MCP client:

npx -y @smithery/cli install am-1m1k/muapi --client claude

Or browse the listing: smithery.ai/servers/am-1m1k/muapi

---

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: SamurAIGPT
• Source: SamurAIGPT/muapi-mcp-server
• License: MIT
• Homepage: https://muapi.ai?utmsource=github&utmmedium=about&utm_campaign=muapi-mcp-server

Install and usage instructions live in the source repository linked above.