@lweight/xbrush-api-mcp

MCP server for the XBrush AI media generation API — images, video, speech, music, sound effects, lip-sync, video extend/retake, content moderation, and watermarks, directly from Claude Code.

Quick Start

1. Get an API Key

Get your key at xbrush.run/api-keys.

2. Configure Claude Code

Add to your MCP settings:

{
  "mcpServers": {
    "xbrush": {
      "command": "npx",
      "args": ["-y", "@lweight/xbrush-api-mcp"],
      "env": {
        "XBRUSH_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Use It

"Generate an image of a cat sitting on a desk"
"Remove the background from this image"
"Read this script aloud in Korean"
"Create a 30-second upbeat synth track"
"Extend this video by another 5 seconds"

How results work

All generation tools submit asynchronously and return a request_id. Poll it with xbrush_get_request until status is completed, then read the output URL(s). The blocking /sync endpoints are intentionally never called (see CLAUDE.md).

Available Tools (20)

Image (4)

Tool	Description
xbrush_image_generate	Generate images from text (e.g. nano-banana-pro, seedream-4.5, flux.2-pro, z-image-turbo)
xbrush_image_edit	Edit / inpaint (qwen-image-edit) or outpaint (flux-outpaint, qwen-outpaint)
xbrush_image_upscale	Upscale images (2x / 4x)
xbrush_image_remove_bg	Remove background

Video (5)

Tool	Description
xbrush_video_generate	Image-to-video (e.g. kling-v3, veo3.1, seedance-2.0, hailuo-02, wan-2.5)
xbrush_video_upscale	Upscale videos (realesrgan, seedvr)
xbrush_video_lip_sync	Lip-sync a face video to an audio track
xbrush_video_extend	Extend an existing video by 1–20 seconds
xbrush_video_retake	Regenerate a video variation up to a timestamp

Audio (3)

Tool	Description
xbrush_tts_generate	Text-to-speech (e.g. speech-2.8-hd, eleven-v3)
xbrush_music_generate	Music generation from text (lyria2)
xbrush_sound_effect_generate	Generate sound effects for a video

Utility (8)

Tool	Description
xbrush_content_moderate	NSFW moderation + masking for an image or video
xbrush_watermark_add	Add the XBrush watermark to an image/video
xbrush_list_models	List available AI models with pricing
xbrush_list_voices	List TTS voices (use a voice_id with tts_generate)
xbrush_get_request	Check status/result of an async operation
xbrush_list_requests	List recent API requests
xbrush_file_upload	Upload a local file to the XBrush CDN (auto / direct / presign)
xbrush_check_health	Check API server status

Environment Variables

Variable	Required	Description
XBRUSH_API_KEY	Yes	Your XBrush API key
XBRUSH_BASE_URL	No	API base URL. Defaults to https://api.xbrush.run.
XBRUSH_DISABLED_TOOLS	No	Comma-separated tool names to skip. Safety valve for selectively disabling a specific tool without uninstalling. Example: xbrush_music_generate,xbrush_content_moderate

License

MIT