Skip to main content
MCP (Model Context Protocol) lets AI agents interact with Groniz directly — listing integrations, scheduling posts, generating images and videos — all through a standardized tool-calling interface. This means you can connect Claude, ChatGPT, Cursor, or any MCP-compatible client to your Groniz account and manage your social media through natural language.

​
How It Works

Groniz exposes an MCP server that provides 9 tools to AI agents. The agent discovers these tools, understands their schemas, and calls them on your behalf.

​
Available Tools

​
Authentication

There are two ways to authenticate with the MCP server:

​
API Key

Get your API key from the API Keys page in Groniz. Use it directly in the MCP endpoint URL or as a Bearer token.

​
OAuth Token

If you’re building an app for other Groniz users, use OAuth2 to obtain tokens. OAuth tokens start with pos_ and work the same way as API keys.

​
Connecting

Use the /mcp endpoint with your API key or OAuth token as a Bearer token:
This method supports both API keys and OAuth tokens (prefixed with pos_).

​
Quick Example

Here’s what a typical interaction looks like when an AI agent uses Groniz MCP:
  1. Agent calls integrationList — gets back your connected accounts (X, LinkedIn, etc.)
  2. Agent calls integrationSchema with platform: "x" — learns X’s character limits, settings, and rules
  3. Agent calls schedulePostTool — schedules your post with the correct format
All of this happens automatically when you tell your AI agent something like:
“Schedule a post to X for tomorrow at 10am: Excited to announce our new feature!”

​
FAQ

​
Do I need an OpenAI key to use Groniz MCP?

No. The MCP server just exposes Groniz’s tools — your AI client (Claude, ChatGPT, Cursor, etc.) provides the model. Groniz only needs an OPENAI_API_KEY if you use Groniz’s own AI features (image generation, copilot) which are separate from the MCP tools surfaced to your client.

​
What happens when my API key expires or is rotated?

Groniz API keys don’t auto-rotate, but if you rotate one on the API Keys page, every MCP client using the old key stops working until you update its config. Update the URL or the Authorization header in your client config and reconnect.

​
Can MCP read or reply to comments?

Not today. The current tool set is read-only on integrations and write-only on posts/media — there’s no getComments or replyToComment exposed via MCP. Comment replies must be triggered through the Groniz UI.