acedatacloud avatar

Mcp Flux Pro

acedatacloud/fluxmcp

Connects Claude and other MCP clients to Flux AI image generation through AceDataCloud's platform. Exposes six tools for generating images from prompts, editing existing images with the Kontext model, listing available Flux models, and querying async task status. Runs as a hosted service at flux.mcp.acedata.cloud with bearer token auth, so you can use it in Claude.ai with OAuth or add it to Claude Desktop, Cursor, and VS Code with your API token. Also ships as a Python package if you want to self-host via stdio or HTTP. Good for when you need AI image generation without leaving your editor or chat interface, with support for multiple Flux model variants and batch task queries.

GitHub stars
3
tools
6
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Nov 7, 2026

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

flux_generate_imageGenerate AI images from a text prompt using Flux. Flux is a family of fast, high-quality image generation models by Black Forest Labs. Different models offer different tradeoffs between speed, quality, and capabilities. Use this when: - You want to create new images from a tex...5 params

Generate AI images from a text prompt using Flux. Flux is a family of fast, high-quality image generation models by Black Forest Labs. Different models offer different tradeoffs between speed, quality, and capabilities. Use this when: - You want to create new images from a tex...

Parameters* required
callback_urlvalue
Webhook callback URL for asynchronous notifications. When provided, the API will POST to this URL when the image is generated.
countvalue
Number of images to generate. Only supported for generate action. Default is 1.
modelstring
Flux model to use for generation. Options: - flux-dev: Fast development model, good balance of speed and quality (default) - flux-pro: Higher quality production model - flux-pro-1.1: Improved produ...one of flux-dev · flux-pro · flux-pro-1.1 · flux-pro-1.1-ultra · flux-kontext-pro · flux-kontext-maxdefault: flux-dev
promptstring
Description of the image to generate. Be descriptive about style, subject, lighting, and composition. Examples: 'A majestic mountain landscape at golden hour, photorealistic', 'Cyberpunk street sce...
sizevalue
Image size. For flux-dev/pro/pro-1.1: pixel dimensions like '1024x1024' (256-1440px, multiples of 32). For flux-pro-1.1-ultra and kontext models: aspect ratios like '1:1', '16:9', '9:16', '4:3', '3...
flux_edit_imageEdit an existing image using Flux with a text prompt. This allows you to modify an existing image based on a text description. The kontext models (flux-kontext-pro, flux-kontext-max) are specifically designed for high-quality image editing and style transfer. Use this when: -...5 params

Edit an existing image using Flux with a text prompt. This allows you to modify an existing image based on a text description. The kontext models (flux-kontext-pro, flux-kontext-max) are specifically designed for high-quality image editing and style transfer. Use this when: -...

Parameters* required
callback_urlvalue
Webhook callback URL for asynchronous notifications.
image_urlstring
URL of the image to edit. Must be a direct image URL (JPEG, PNG, etc.), not a web page containing an image.
modelstring
Flux model to use for editing. Recommended models for editing: - flux-kontext-pro: Best for context-aware editing and style transfer (recommended) - flux-kontext-max: Maximum context for complex ed...one of flux-dev · flux-pro · flux-pro-1.1 · flux-pro-1.1-ultra · flux-kontext-pro · flux-kontext-maxdefault: flux-kontext-pro
promptstring
Description of how to edit the image. Be specific about what changes to make. Examples: 'Change the background to a sunset beach', 'Add sunglasses to the person', 'Make it look like a watercolor pa...
sizevalue
Output image size. For kontext models: aspect ratios like '1:1', '16:9'. For other models: pixel dimensions like '1024x1024'.
flux_list_modelsList all available Flux models and their capabilities. Reference guide for choosing the right Flux model for your use case. Returns: Detailed list of all Flux models with descriptions and recommendations.

List all available Flux models and their capabilities. Reference guide for choosing the right Flux model for your use case. Returns: Detailed list of all Flux models with descriptions and recommendations.

No parameter schema in public metadata yet.

flux_list_actionsList all available Flux tools and their use cases. Reference guide for what each tool does and when to use it. Returns: Categorized list of all tools with descriptions.

List all available Flux tools and their use cases. Reference guide for what each tool does and when to use it. Returns: Categorized list of all tools with descriptions.

No parameter schema in public metadata yet.

flux_get_taskQuery the status and result of a Flux image generation task. Use this to check if a generation is complete and retrieve the resulting image URLs and metadata. Use this when: - You want to check if an image generation has completed - You need to retrieve image URLs from a previ...1 params

Query the status and result of a Flux image generation task. Use this to check if a generation is complete and retrieve the resulting image URLs and metadata. Use this when: - You want to check if an image generation has completed - You need to retrieve image URLs from a previ...

Parameters* required
task_idstring
The task ID returned from a generation or edit request. This is the 'task_id' field from any flux_generate_image or flux_edit_image tool response.
flux_get_tasks_batchQuery multiple Flux image generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling flux_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several...1 params

Query multiple Flux image generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling flux_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several...

Parameters* required
task_idsarray
List of task IDs to query. Maximum recommended batch size is 50 tasks.

Sponsors

Configuration

ACEDATACLOUD_API_TOKEN*secret

API token from Ace Data Cloud (https://platform.acedata.cloud)

Readme

FluxMCP

PyPI version PyPI downloads CI License: MIT MCP Python 3.10+

A Model Context Protocol (MCP) server for AI image generation and editing using Flux through the AceDataCloud platform.


View the full README on GitHub

Details

Repository
github.com/acedatacloud/fluxmcp
Website
platform.acedata.cloud/documents/flux-mcp?utm_source=mcp_registry&utm_medium=referral&utm_campaign=evergreen&utm_content=flux_mcp_listing_guide
Package
mcp-flux-pro
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from acedatacloud