KosmoKrator

ai

Groq MCP Integration for OpenAI Agents SDK

Connect Groq to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 5 read 2 write API key auth
Submit Groq feedback View package source

Connect Groq to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Groq MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-groq": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=groq",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=groq --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Groq instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Groq Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Groq integration catalog.

MCP toolSource functionTypeDescription
integration__groq__groq_list_models groq.groq_list_models Read List available Groq AI models. Returns model IDs, ownership, and other metadata for models accessible via the Groq API.
integration__groq__groq_create_completion groq.groq_create_completion Write Create a chat completion using a Groq model. Send a list of messages and receive an AI-generated response with ultra-low latency. Supports configurable parameters like temperature, max_tokens, and top_p.
integration__groq__groq_list_messages groq.groq_list_messages Read List messages in a Groq Cloud conversation. Returns message content, role, and metadata for each message in the conversation.
integration__groq__groq_create_message groq.groq_create_message Write Create a message in a Groq Cloud conversation. Send a message with a specified role and content to a conversation.
integration__groq__groq_list_files groq.groq_list_files Read List files uploaded to the Groq Files API. Returns file IDs, filenames, purposes, sizes, and upload timestamps.
integration__groq__groq_get_file groq.groq_get_file Read Get metadata for an uploaded file in Groq, including its ID, filename, purpose, size in bytes, and processing status.
integration__groq__groq_get_current_user groq.groq_get_current_user Read Get information about the currently authenticated Groq user, including user ID, email, and organization details.

Related Groq Pages

Groq CLIUse direct JSON commands instead of MCP discovery. Groq MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.