ranbot-ai 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
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