GroqCloud Automation
Automate AI inference workflows using GroqCloud's ultra-fast API -- chat completions, model discovery, audio translation, and TTS voice selection -- all orchestrated through the Composio MCP integration.
Toolkit docs: [composio.dev/toolkits/groqcloud](https://composio.dev/toolkits/groqcloud)
---
Setup
- Connect your GroqCloud account through the Composio MCP server at
https://rube.app/mcp - The agent will prompt you with an authentication link if no active connection exists
- Once connected, all
GROQCLOUD_*tools become available for execution
---
Core Workflows
1. Discover Available Models
List all models available on GroqCloud to find valid model IDs before running inference.
Tool: GROQCLOUD_LIST_MODELS
No parameters required -- returns all available models with metadata.Use this as a prerequisite before any chat completion call to ensure you reference a valid, non-deprecated model ID.
---
2. Run Chat Completions
Generate AI responses for conversational prompts using a specified GroqCloud model.
Tool: GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION
| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | model | string | Yes | Model ID from GROQCLOUD_LIST_MODELS | | messages | array | Yes | Ordered list of {role, content} objects (system, user, assistant) | | temperature | number | No | Sampling temperature 0-2 (default: 1) | | max_completion_tokens | integer | No | Max tokens to generate | | top_p | number | No | Nucleus sampling 0-1 (default: 1) | | stop | string/array | No | Up to 4 stop sequences | | stream | boolean | No | Enable SSE streaming (default: false) |
---
3. Inspect Model Details
Retrieve detailed metadata for a specific model including context window and capabilities.
Tool: GROQCLOUD_GROQ_RETRIEVE_MODEL
| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | model | string | Yes | Model identifier (e.g., groq-1-large) |
---
4. Translate Audio to English
Translate non-English audio files into English text using Whisper models.
Tool: GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION
| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | file_path | string | Yes | Local path, HTTP(S) URL, or base64 data URL for audio | | model | string | No | Model ID (default: whisper-large-v3). Note: whisper-large-v3-turbo may not support translations | | response_format | string | No | json, verbose_json, or text (default: json) | | temperature | number | No | Sampling temperature 0-1 (default: 0) |
---
5. List TTS Voices
Enumerate available text-to-speech voices for Groq PlayAI models to drive voice selection UX.
Tool: GROQCLOUD_LIST_VOICES
Returns the set of supported TTS voices. Note: this is a static list maintained manually.---
Known Pitfalls
| Pitfall | Details | |---------|---------| | Nested model list | GROQCLOUD_LIST_MODELS response may be nested at response['data']['data'] -- do not assume a flat top-level array | | Hard-coded model IDs break | Always fetch model IDs dynamically via GROQCLOUD_LIST_MODELS; hard-coded names can break when models are deprecated or renamed | | Audio format validation | GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION rejects invalid or unsupported audio formats silently -- validate inputs before calling | | Model metadata drifts | Data from GROQCLOUD_GROQ_RETRIEVE_MODEL (context window, features) can change as models update -- do not treat it as static | | TTS voice changes | Voice sets from GROQCLOUD_LIST_VOICES may shrink or rename over time -- handle missing voices gracefully |
---
Quick Reference
| Tool Slug | Purpose | |-----------|---------| | GROQCLOUD_LIST_MODELS | List all available models and metadata | | GROQCLOUD_GROQ_CREATE_CHAT_COMPLETION | Generate chat-based AI completions | | GROQCLOUD_GROQ_RETRIEVE_MODEL | Get detailed info for a specific model | | GROQCLOUD_GROQ_CREATE_AUDIO_TRANSLATION | Translate non-English audio to English text | | GROQCLOUD_LIST_VOICES | Retrieve available TTS voices for PlayAI |
---
*Powered by [Composio](https://composio.dev)*