Formal JSON Schema definitions, input parameter specifications, and response payloads for all Model Context Protocol (MCP) tools provided by the DreamBees MLX MCP Server.
Execute local Apple Silicon Metal GPU image generation with real-time TAESD preview and step telemetry.
{
"type": "object",
"properties": {
"prompt": {
"type": "string",
"description": "The textual prompt description for the image to generate"
},
"model_id": {
"type": "string",
"default": "flux2-klein-4b",
"description": "MLX model ID (e.g. z-image-turbo, flux2-klein-4b, sana-2-sprint, wan2.1-1.3b)"
},
"width": {
"type": "integer",
"default": 512,
"description": "Image width in pixels"
},
"height": {
"type": "integer",
"default": 512,
"description": "Image height in pixels"
},
"steps": {
"type": "integer",
"default": 2,
"description": "Number of inference diffusion steps"
},
"seed": {
"type": "integer",
"description": "Optional entropy seed integer"
}
},
"required": ["prompt"]
}{
"status": "success",
"output_path": "/tmp/dreambees_mcp_1721815000000_42.png",
"duration_ms": 15847,
"model_id": "flux2-klein-4b",
"seed": 42,
"width": 512,
"height": 512,
"metal_accelerated": true,
"preview_data_url": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
}List available Apple Silicon MLX models, readiness status, precision, and VRAM requirements.
{ "type": "object", "properties": {} }{
"models": [
{
"id": "flux2-klein-4b",
"name": "FLUX.2 Klein 4B",
"provider": "Black Forest Labs / MLX",
"precision": "4-bit Quantized",
"status": "ready",
"vram_required_gb": 3.1
},
{
"id": "sana-2-sprint",
"name": "Sana 2.0 Sprint",
"provider": "SceneWorks / MLX",
"precision": "4-bit Quantized",
"status": "ready",
"vram_required_gb": 2.8
}
]
}Run the 12-test MLX Metal benchmark suite for a target model ID or fetch recent benchmark results report.
{
"type": "object",
"properties": {
"model_id": {
"type": "string",
"default": "flux2-klein-4b",
"description": "Target model ID to benchmark (e.g. flux2-klein-4b, z-image-turbo)"
},
"run_fresh": {
"type": "boolean",
"default": false,
"description": "Run fresh benchmark suite or return cached report"
}
}
}Fetch Apple Silicon Metal GPU hardware diagnostics, active VRAM, peak memory, and cache limits.
{ "type": "object", "properties": {} }{
"status": "ready",
"diagnostics": {
"mlx_available": true,
"metal_available": true,
"device": "metal",
"backend": "apple_mlx",
"active_vram_mb": 2087,
"peak_vram_mb": 3569,
"cache_vram_mb": 3047
}
}Transform raw user prompt intent into a target model-card-optimized image generation prompt using the packaged onboard Gemma 4 Prompt Rewriter Engine.
{
"type": "object",
"properties": {
"intent": {
"type": "string",
"description": "Raw user prompt intent (e.g. 'cyberpunk street at night')"
},
"target_model_id": {
"type": "string",
"default": "sana-2-sprint",
"description": "Target image model card ID (e.g. sana-2-sprint, flux2-klein-4b, wan2.1-t2i-1.3b, sd-3.5-large)"
}
},
"required": ["intent"]
}{
"id": "gemma_1721815000000_12",
"original_intent": "cyberpunk street at night",
"rewritten_prompt": "Expansive wide-angle landscape depicting cyberpunk street at night, hyper-aesthetic artwork, vibrant studio lighting, crisp subject isolation, pristine color grading",
"reasoning": "Gemma 4 evaluated target model card specs for 'Sana 2.0 Sprint'. Applied spatial composition and high aesthetic clarity.",
"target_model_id": "sana-2-sprint",
"model_card_name": "Sana 2.0 Sprint",
"duration_ms": 34,
"timestamp": 1721815000000
}