Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

We ship official MCP (Model Context Protocol) servers for every core service. Claude Desktop, Cursor, Windsurf, Continue, and any MCP-aware AI tool can call XHuoAPI APIs directly — no more pasting cURL commands; the AI assistant picks the right endpoint, passes parameters, and parses results.

​
When to use MCP

✅ Inside IDE / desktop AI

You want Claude / Cursor to generate images, search the web, transcode video for you

✅ Agent / workflow

Expose XHuoAPI as a toolset to an AI agent

❌ Web / mobile production

Use the REST API directly — more flexible

❌ Mass inference

Call api.xhuoapi.ai directly

​
All MCP Servers

Midjourney

AI image generation

Seedream

ByteDance image

Sora

OpenAI video

Veo

Google video

Luma

Luma Dream Machine

Seedance

ByteDance video

Suno

AI music

Serp

Google web search

ShortURL

URL shortener

​
Prerequisites

  1. An API Token (see Authentication)
  2. Python 3.10+ (or pipx / uvx)
  3. The MCP config file of your AI tool

​
Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows): 
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    },
    "suno": {
      "command": "uvx",
      "args": ["mcp-suno"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    },
    "serp": {
      "command": "uvx",
      "args": ["mcp-serp"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
Restart Claude Desktop — a 🔌 icon will appear in the input box once tools are loaded.

​
Cursor / Windsurf

In Cursor: Settings → Tools & Integrations → Add new MCP server, or edit ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "midjourney": {
      "command": "uvx",
      "args": ["mcp-midjourney"],
      "env": {
        "XHuoAPI_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}
Windsurf supports the same mcp.json format.

​
HTTP Transport

Every server supports both stdio (default) and streamable-http: 
# stdio (default, for desktop tools)
uvx mcp-midjourney

# HTTP (remote / multi-client)
uvx mcp-midjourney --transport streamable-http --host 0.0.0.0 --port 8000
In HTTP mode, AI clients connect to http://your-host:8000/mcp.

​
pip Installation

If you don’t want uvx: 
pip install mcp-midjourney mcp-suno mcp-serp
# then in your MCP config:
{
  "command": "mcp-midjourney",
  "args": [],
  "env": { "XHuoAPI_API_TOKEN": "..." }
}

​
Billing

Calls made via MCP tools are calls to the XHuoAPI API — same billing rules apply. The MCP server itself is free; your token gets charged normally. See Pricing.

​
Troubleshooting

  • AI doesn’t see tools: check MCP server logs (Claude Desktop: ~/Library/Logs/Claude/); confirm the token isn’t a typo
  • uvx not found: pip install uv, or use plain pip install
  • HTTP rejected: check firewall; listen on 0.0.0.0, not 127.0.0.1
  • Behind a proxy: set HTTPS_PROXY env var

​
Resources