How to Use the Groq MCP in Mastra AI

Build complex agent workflows in Mastra AI using the raw speed of Groq.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Groq MCP to Mastra AI

Create your Vinkius account to connect Groq to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Groq with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Groq model management

Use `list_models` and `get_model` to dynamically decide which engine to run for a specific step in your Mastra workflow. It lets your agents pick the right tool for the job. Your code stays clean by checking available models before execution. This prevents runtime errors when switching between Llama and Gemma architectures.

Reliable JSON for Mastra workflows

Inject `structured_output` into your agent's chain to ensure consistent data flow between steps. It guarantees the output fits your schema before the next step triggers. This makes your workflows predictable. When a step completes, you know exactly what the data structure looks like.

Safe content moderation for Mastra

Run the `moderate_content` tool as a guardrail in your agent's pipeline. It filters input or output before it hits your internal systems. It acts as an automated gatekeeper. If the content flags, your Mastra workflow can trigger a fallback branch instead of continuing.

Setup guide

Set up Groq MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Groq tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "groq-mcp-client",
  servers: {
    "groq-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Groq Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Groq tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Groq transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Groq. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Groq now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Groq MCP in Mastra AI

You register the MCP server in your agent configuration and spread the tools into your agent's toolset. Mastra then treats the Groq API calls like native local functions.

Yes, you can define your retry strategy in Mastra, and it will re-invoke the Groq tools if a network failure occurs. It keeps your multi-step pipelines alive.

You can set up tool approval for any Groq call. Mastra will pause the workflow and wait for your manual sign-off before executing the inference.

The server is stateless, but it integrates perfectly with your Mastra state management. You pass the necessary context into the tool arguments, and the model processes it immediately.

The server handles your prompts and audio buffers in memory only. It doesn't write your transient request data to persistent storage, ensuring your workflow remains isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript