Groq MCP Server
Query models hosted on Groq for lightning-fast inference directly from Claude and other MCP clients through the Model Context Protocol (MCP).
Use MCP to access vision models for interpreting visual data from images, instantly generate speech from text, process thousands of requests through Groq's batch processing, and even build apps with full access to Groq's documentation.
With the Groq MCP server you can try tasks like:
Agentic Tasks, Code Generation & Web Search
- What is Groq's Compound Beta? Use the compound tool. Summarize with one line then turn into voice
- Please retrieve the current Bitcoin price from CoinGecko API and calculate the value of 0.38474 bitcoins?
- What is the weather in SF right now?
- Generate and run code, which means you can make API calls, get data from webpages, and much more
- This feature uses the new
compound-beta agentic tools system
Vision & Understanding
- "Describe this image [URL to image]"
- "Analyze this image and extract key information as JSON [URL to image]"
Speech & Audio
- "Convert this text to speech using the Arista-PlayAI voice: [text]"
- "Read this text aloud in Arabic: [text]"
- "Transcribe this audio file using whisper-large-v3: [url to mp3]"
- "Translate this foreign language audio to English [url to mp3]"
Batch Processing
- "Process the following batch of prompts: [location of a jsonlines file]" (read more here)
Other MCP Clients
For other clients like Cursor and Windsurf:
-
Install the package:
# Using UV (recommended)
uvx install groq-mcp
# Or using pip
pip install groq-mcp
-
Generate configuration:
# Print config to screen
groq-mcp-config --api-key=your_groq_api_key --print
# Or save directly to config file (auto-detects location)
groq-mcp-config --api-key=your_groq_api_key
# Optional: Specify custom output path
groq-mcp-config --api-key=your_groq_api_key --output-path=/path/to/outputs
That's it! Your MCP client can now use these Groq capabilities:
- 🗣️ Text-to-Speech (TTS): Fast, natural-sounding speech synthesis
- 👂 Speech-to-Text (STT): Accurate transcription and translation
- 🖼️ Vision: Advanced image analysis and understanding
- 💬 Chat: Ultra-fast LLM inference with Llama 4 and more
- 📦 Batch: Process large workloads efficiently
Contributing
If you want to contribute or run from source:
Available Scripts
The scripts directory contains several utility scripts for different Groq API functionalities:
Vision & Image Analysis
./scripts/groq_vision.sh <image_file> [prompt] [temperature] [max_tokens] [output_directory]
# Example:
./scripts/groq_vision.sh "./input/image.jpg" "What is in this image?"
Text-to-Speech (TTS)
./scripts/groq_tts.sh "Your text" [voice_name] [model] [output_directory]
# Example:
./scripts/groq_tts.sh "Hello, world!" "Arista-PlayAI"
Speech-to-Text (STT)
./scripts/groq_stt.sh <audio_file> [model] [output_directory]
Utility Scripts
list_groq_voices.sh: Display available TTS voices
list_groq_stt_models.sh: Show available STT models
groq_batch.sh: Process batch operations
groq_translate.sh: Translate text or audio
Development Scripts
# Run tests
./scripts/test.sh
# Run with options
./scripts/test.sh --verbose --fail-fast
# Run integration tests
./scripts/test.sh --integration
# Debug and test locally
mcp install server.py
mcp dev server.py
Troubleshooting
Logs when running with Claude Desktop can be found at:
- Windows:
%APPDATA%\Claude\logs\groq-mcp.log
- macOS:
~/Library/Logs/Claude/groq-mcp.log
Acknowledgments
This project is inspired by the ElevenLabs MCP Server. Thanks!