GroqCloud Automation

# 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

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](https://composio.dev)*