mcp-tokenflux-images_skill

Overview

This skill integrates with the TokenFlux image generation MCP service to produce AI-generated images and artwork. It provides tooling to discover models, inspect model input schemas, submit generation requests, and poll for results. Use it when you need programmatic, schema-driven image creation via the TokenFlux API.

How this skill works

The skill exposes four tools: listModels to discover available VLM models; getModel to retrieve a model's input_schema; generateImage to request image generation (waits up to 30s); and getGeneration to poll a generation request until it succeeds or fails. Always call getModel first to shape the payload according to the model's JSON schema, then call generateImage and use getGeneration if the response is still processing.

When to use it

• Creating AI-generated illustrations, concept art, or marketing visuals programmatically
• Automating image generation workflows that must target a specific model schema
• Integrating image creation into pipelines where polling for completion is required
• Testing and comparing outputs across multiple VLM models discovered via listModels
• Building services that need cost/status visibility for generation requests

Best practices

• Call listModels first to discover supported models and pricing before selecting model_id
• Always call getModel to retrieve the model's input_schema and validate your payload
• Use generateImage for quick requests but poll with getGeneration when status is 'processing'
• Respect the default 30s timeout; increase CLI timeout only when needed for long renders
• Inspect tool schemas with mh inspect before invoking unfamiliar tools to avoid malformed requests

Example use cases

• Batch-generate product mockups using a specific VLM model and then poll for results
• Create on-demand AI artwork for a content platform by validating payloads against getModel input_schema
• Prototype visual concepts by listing available models and comparing outputs and pricing
• Integrate image generation into a CI/CD asset pipeline that stores generated images and cost metadata