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

1. Connect your GroqCloud account through the Composio MCP server at https://rube.app/mcp
2. The agent will prompt you with an authentication link if no active connection exists
3. 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