Skip to main content
Glama
lweight

@lweight/xbrush-api-mcp

by lweight
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

@lweight/xbrush-api-mcp

MCP server for the XBrush AI media generation API — images, video, speech, music, sound effects, lip-sync (incl. talking photos), video extend/retake, LLM chat, 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"
"Make this portrait photo say the following line"
"Ask GLM 5.2 to summarize this paragraph"

Related MCP server: mcp-fal

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

The one exception is xbrush_chat (LLM chat completions): it is synchronous and returns the completion text directly — the API has no async variant for it. Responses must fit the platform's ~30s gateway limit; if a 504 cuts the connection, the request keeps processing server-side and its result can be recovered via xbrush_list_requests + xbrush_get_request.

Available Tools (21)

Image (4)

Tool

Description

xbrush_image_generate

Generate images from text (e.g. seedream-5.0-pro, nano-banana-pro, flux.2-pro, gpt-image-2, z-image-turbo)

xbrush_image_edit

Edit / inpaint (qwen-image-edit, seedream-5.0-pro-edit, flux.2-pro-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-/text-/reference-to-video (e.g. kling-v3/o3, veo3.1, seedance-2.0, hailuo-02, wan-2.7). seedance-2.0 supports multi-reference via image_urls + @ImageN prompts and model-specific duration (4–15s)

xbrush_video_upscale

Upscale videos (realesrgan, seedvr)

xbrush_video_lip_sync

Lip-sync a face video (pixverse-lipsync, infinite-talk) or animate a still portrait as a talking photo (fabric-1.0) — speech from audio or built-in TTS (text + voice_id)

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, lyria3, lyria3-pro)

xbrush_sound_effect_generate

Generate sound effects for a video — video-driven (pixverse) or prompt-driven (elevenlabs, stable-audio)

Text (1)

Tool

Description

xbrush_chat

LLM chat completions (e.g. GLM 5.2) — synchronous, OpenAI-compatible, billed per token

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, vendor, and per-model duration constraints

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

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • mcp-hailuo

    MCP server for Hailuo (MiniMax) AI video generation

  • mcp-grok

    MCP server for Grok Imagine AI video generation

  • mcp-kling

    MCP server for Kling AI video generation

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/lweight/xbrush-api-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server