Agorapulse's Model Context Protocol (MCP) Connector allows you to integrate Agorapulse with conversational AI assistants like Claude and ChatGPT, enabling you to manage your social media directly from these AI tools.
This integration enables you to access your social media data, analyze performance, create content, and manage your calendar using natural language commands within the AI interface.
In this article, we will cover the following:
Eligibility and requirements
The MCP connector is available to all Agorapulse users, excluding Legacy plan and Free plan holders.
Please Note: The MCP connector is currently in beta, and pricing is subject to change.
To use the connector, you must have an active subscription to one of the following AI services:
Claude: Pro, Max, Team, or Enterprise.
ChatGPT: Plus, Pro, or Team.
You will also need to have an Admin role on your Claude or ChatGPT accounts.
Connecting Agorapulse to AI assistants
The connection process uses OAuth authentication to access your Agorapulse account. You must review the permissions before authorizing the connection.
Connecting to ChatGPT
You must be the Owner of the ChatGPT account to connect. As the account owner, you will need to:
Go to chatgpt.com and log in to your account
Navigate to the Connectors section:
For ChatGPT Business: Go to Workspace and then Apps
For ChatGPT Plus or Pro: Go to Settings and then Apps
Under Advanced Settings, toggle on Developer Mode
Back on the Connectors page, select Custom Connectors and add the following details:
A name for your MCP connection
Icon/logo (optional)
A Description (optional)
The MCP server URL (https://api.openmcp.agorapulse.com/mcp)
Authentication type (Select OAuth)
You will be prompted to authorize the connection by logging in to your Agorapulse account
Review the permissions and authorize ChatGPT to access your Agorapulse data
Your Agorapulse account will now be connected to ChatGPT, and you will be able to use your custom MCP connector in your conversations.
Connecting to Claude
You must be the Owner of the Claude account to connect. As the account owner, you will need to:
Go to claude.ai and log in to your account
Click on your profile image in the bottom left corner
Select Settings
Click Connectors and select Add Connector
You'll need to provide:
A name for your MCP connection
The MCP server URL (https://api.openmcp.agorapulse.com/mcp)
A Description (optional)
Icon/logo (optional)
Next, you will need to decide who can use this connector:
All members
Specific teams
Manual approval
Once configured, you will want to make sure:
The MCP server responds correctly
Authentication (if required) works properly
The connector returns expected data
Once connected, you can start using Agorapulse commands directly in your conversations with Claude.
Managing your connection
Each team member can independently connect to Agorapulse through their own user, and each connection is personal and secure. You can disconnect the connector at any time from your Claude or ChatGPT settings.
In ChatGPT
To manage or disconnect your Agorapulse connector in ChatGPT:
Navigate to the Connectors section:
For ChatGPT Business: Go to Workspace and then Apps
For ChatGPT Plus or Pro: Go to Settings and then Apps
Click on Agorapulse in your list of connectors.
Finally, click Disconnect
In Claude
To manage or disconnect your Agorapulse connector in Claude:
Click on your profile image in the bottom left corner
Select Settings
Click Connectors
Click the three dots next to Agorapulse.
Select Disconnect
Using the connector
Once connected, you can interact with Agorapulse using natural language. The AI assistant will automatically call the appropriate Agorapulse tools to fulfill your request and present the results in a clear, conversational format.
Please note: The MCP connector works with Claude and ChatGPT mobile apps, as long as you have a compatible subscription. The connector also works with Claude Desktop, web, and mobile.
Capabilities of the MCP Connector
The Agorapulse MCP connector enables you to perform several key actions across three main categories:
Publishing and content management
Create draft posts for your social media profiles
Search and create calendar notes
Analytics and insights
Get audience demographics and follower insights for your profiles
Analyze content performance metrics, including engagement, reach, and impressions
Track brand performance across multiple social accounts
Identify your top-performing content by specific metrics
Monitor community management metrics, including replies, messages, and response times
Analyze the performance of posts with specific labels
Organization management
List all your organizations and workspaces.
Access your connected social profiles.
View workspace and organization settings.
Please note: The number of available MCP tools will increase over time
Example prompts
Once the AI Assistant is connected, you can interact with Agorapulse using natural language. The AI assistant will automatically call the appropriate Agorapulse tools to fulfil your request and present the results in a clear, conversational format.
The table below shows some example prompts you can use:
Category | Example Prompt |
Publishing & Calendar | "Create a draft post for my Facebook page about our new product launch."
|
Publishing & Calendar | "Show me all calendar notes for next week."
|
Analytics & Reporting | "What are my top five performing posts this month by engagement?"
|
Analytics & Reporting | "Show me audience demographics for my Instagram profile."
|
Organization Management | "List all my Agorapulse organizations."
|
Limitations
The MCP connector allows you to create draft posts, but it does not automatically publish content to your social accounts. So you will need to schedule and publish these drafts from Agorapulse.
Security and privacy
The AI assistant can only access data that your user has permission to view in Agorapulse. No data is stored permanently by the MCP connector; it only retrieves data when you make requests
Best Practice: Only connect the MCP connector in accounts you trust.
MCP Connector - Frequently Asked Questions
In this section, we cover the questions that will assist in troubleshooting the Model Context Protocol Connector.
Why is the Connector not showing my data?
If the MCP Connector is not showing your data, ensure that the following conditions are met:
You are logged into the correct Agorapulse account.
You have the necessary permissions in Agorapulse to access the data you are requesting.
Your Agorapulse subscription is active
Why does the connection fail during authorization?
If the connection fails during authorization, try the following steps:
Clear your browser cache and cookies.
Make sure you are using a supported browser (Chrome, Firefox, Safari, or Edge).
Check that pop-ups are not blocked for claude.ai or chatgpt.com.
Try disconnecting and reconnecting the integration.
What are "Permission Denied" errors?
If you are seeing "Permission Denied" errors, this usually indicates that you do not have the correct role in Agorapulse. Check with your Organization Owner or Manager to ensure you have appropriate permissions.