mcp.film

mcp.film / Model Hubs / PiAPI MCP Server

PiAPI MCP Server

Communityby Community (PiAPI)creditsverified Aug 25, 2026

Midjourney in an agent — plus Kling, Luma, Hailuo, Hunyuan, Wan, Suno via PiAPI.

What it does

TypeScript MCP server over PiAPI's unified API, best known as the practical Midjourney route since Midjourney has no public API or official MCP. Also covers FLUX, Kling video and effects, Luma Dream Machine, Hailuo, Hunyuan/Skyreels/Wan video, Trellis 3D, MMAudio scoring and Suno music. Since Jul 2026 it also generates a contract-backed tool for every committed PiAPI (model, task_type) pair, so the exposed surface tracks the upstream catalog instead of only the hand-written convenience tools.

Connect

Connection is set up through the vendor's flow — follow the official connect instructions.

Local install: Multi-step: git clone https://github.com/apinetwork/piapi-mcp-server, npm install, npm run build, then point your client at node /absolute/path/to/dist/index.js with PIAPI_API_KEY in env. Node 16+.

Auth: api_key · env PIAPI_API_KEYhttps://piapi.ai/workspace/key

Tools you'll see

generate_imagemidjourney_imaginegenerate_video_klinggenerate_video_hailuogenerate_video_lumagenerate_video_wangenerate_music_sunogenerate_music_for_videoimage_upscalegenerate_3d_modelpiapi_qubico_flux1_schnell_txt2img

Field notes

MIT, 74 stars, actively maintained — catalog last refreshed Aug 10 2026 by a drift detector that diffs PiAPI's contract, though the scheduled CI job was switched to manual-only in Jul 2026 and the sync now runs on the maintainer's own machine, so a quiet month here means nobody ran it rather than nothing changed upstream. There is still no published npm package: install is clone plus npm run build, or `npx -y @smithery/cli install piapi-mcp-server --client claude`. Contract tools are named piapi_<model>_<task_type> (e.g. piapi_qubico_flux1_schnell_txt2img) alongside 23 hand-written convenience tools. Caveats: unofficial Midjourney access is a ToS gray area and only `imagine` is implemented, and long video jobs can exceed MCP client timeouts — raise them. Hosted Midjourney alternative: AceDataCloud/MidjourneyMCP.

Pairs well with