io.github.AceDataCloud/mcp-grok

List all available Grok models (chat + video) and their capabilities. Shows the chat models and the Grok Imagine video models with their features and input rules. Use this to understand which model to choose. Returns: Tables of all models with their capabilities.

List all available Grok Imagine tools and workflows. Reference guide for what each tool does and how they fit together. Returns: Categorized list of all tools and example workflows.

Get guidance on writing effective prompts for Grok Imagine video generation. Shows how to structure prompts for best video generation results. Returns: Complete guide with prompt structure, examples, and tips.

Generate AI video from a text prompt using Grok Imagine. This creates a video from scratch based on your text description. Grok Imagine will interpret your prompt and generate a matching video clip. Use this when: - You want to create a video from a text description - You don't have a reference image to use - You want maximum creative freedom Only the 'grok-imagine-video-1.5-fast:reverse', 'grok-imagine-video:reverse', and 'grok-imagine-video:official' models support text-to-video. For generating a video from a reference image, use grok_image_to_video instead. Returns: Task ID and generated video information including URLs and state.

Generate AI video from a reference image using Grok Imagine. This animates your input image into a video clip. Provide a prompt to describe the motion you want, and optional reference images to guide style. Use this when: - You have a specific image you want to animate - You want consistent visual style from a reference - You want to turn a still photo into a short video For video generation from text only, use grok_text_to_video instead. Returns: Task ID and generated video information including URLs and state.

Create a Grok (xAI) chat completion via the AceDataCloud Grok API. Sends messages to a Grok chat model and returns the generated response in the OpenAI-compatible chat completion format. Use this when: - You want to chat/reason with a Grok model (grok-4 / grok-3 family) - You need vision/image understanding - You need tool/function calling with Grok For generating videos, use grok_text_to_video / grok_image_to_video instead. Returns: JSON response containing the chat completion result.

Query the status and result of a video generation task. Use this to check if a generation is complete and retrieve the resulting video URLs and metadata. Use this when: - You want to check if a generation has completed - You need to retrieve video URLs from a previous generation - You want to get the full details of a generated video Task states: - 'pending'/'processing': Generation is still in progress - 'succeeded': Generation finished successfully - 'failed': Generation failed (check error message) Returns: Task status and generated video information including URLs and state.

Query multiple video generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling grok_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several videos at once - You're tracking a batch of generations Returns: Status and video information for all queried tasks.