Agorapulse's Model Context Protocol (MCP) connector allows you to integrate Agorapulse with AI agents like Claude, ChatGPT, and Microsoft Copilot, so you can manage your social media directly from these AI tools.
Once connected, your AI agent can access your social media data, analyze performance, create and schedule content, and manage your calendar using natural language. This article explains what your AI agent can and cannot do with Agorapulse.
Agorapulse MCP articles: The Agorapulse MCP connector is covered in three articles:
(this article) Model Context Protocol (MCP) integration explained: what the MCP connector is, what your AI agent can and cannot do, limits, security, and FAQs
How to connect Agorapulse to Claude, ChatGPT, and Copilot: requirements, connection steps, managing and disconnecting your connection, and connection troubleshooting
MCP Prompt and Workflow Library Explained: ready-to-use prompts and multi-step workflows
In this article, we will cover the following:
Eligibility and requirements
The MCP connector is available on all current Agorapulse subscription plans. It is not available on Legacy plans.
You also need a paid subscription to a supported AI agent (Claude, ChatGPT, or Microsoft Copilot Studio). For the plans and roles required, see How to connect Agorapulse to Claude, ChatGPT, and Copilot.
Connecting your AI agent
The connection uses OAuth authentication: you log in with your own Agorapulse account and authorize your AI agent. Each team member connects with their own user, and you can disconnect at any time.
For step-by-step instructions for Claude, ChatGPT, and Copilot, including how to disconnect, see the article How to connect Agorapulse to Claude, ChatGPT, and Copilot.
Using the connector
Once connected, you can interact with Agorapulse using natural language. Your AI agent automatically calls the appropriate Agorapulse tools to complete your request and presents the results in a clear, conversational format.
Please note: The MCP connector works with the Claude and ChatGPT mobile apps, as long as you have a compatible subscription. The connector also works with Claude Desktop and Claude on the web.
Capabilities of the MCP connector
Please note: The information that the MCP returns is based on the permissions you have in Agorapulse.
The Agorapulse MCP connector enables you to perform actions across five main categories: Inbox, Listening, Publishing and content management, Analytics and insights, and Organization management.
Inbox
Read Inbox items across one or several social profiles, newest first: organic comments, ad comments, reel comments, private conversations, mentions, story mentions, and reviews for Facebook, Instagram, LinkedIn, TikTok, X (Twitter), and Threads Note: Retrieved items display the moderation history and, for comments, the post they belong to.
Filter items by Inbox state, for example, items still to review
Filter items still waiting for approval
Read a private conversation, message by message, with date filtering
Reply to an item publicly, or privately to a public item (Facebook, Instagram, or X), with control over who gets mentioned on X
Please note: Replies follow Inbox approval workflows. If an active workflow covers the profile and your user, the reply is queued for a Manager's approval instead of being published straight away. You cannot reply to an item whose reply is already waiting for approval. Your AI agent asks you to confirm a reply before sending it.
Please note: Labeling, assigning, hiding, and deleting Inbox items are actions that stay in Agorapulse. An item is marked as reviewed only when a reply is published.
YouTube comments are not available in the Inbox through the MCP.
Listening
Please note: Social Listening must be included in your subscription. Your AI agent analyzes existing searches; create and edit searches in Agorapulse.
Read the items a Listening search retrieved, newest first: social posts and comments, as well as news articles, blog posts, and forum posts
Filter by search, publication date range, source (Facebook, Instagram, X, LinkedIn, TikTok, YouTube, Reddit, web news, blogs, and forums), and sentiment Note: If a date range is not set, the last seven days are retrieved.
View Listening metrics (volume, engagement, sentiment, and word clouds) for Standard and Competitive searches
Publishing and content management
Reading the calendar
View the posts created in Agorapulse (drafts, scheduled, published, and failed), filtered by profile, status, and date range
Open a single post to see its full content
View everything your Calendar shows, including posts published directly on the social network
Please note: Posts published directly on the social network (for example, from a phone) are read-only. Your AI agent can read them, but it cannot change or delete them. A new post can take 10 to 20 seconds to appear in the calendar.
Creating drafts and scheduling posts
Create draft posts for your social profiles
Schedule posts on a profile at a specific date and time. Scheduled posts are published automatically at that date
Add network-specific options, such as a first comment, an X thread, or a Pinterest board (see Per-network options below)
List the boards of a Pinterest profile, so a pin can be sent to the correct board
Each draft or scheduled post covers one profile and one date. To post on three networks, your AI agent creates three posts. Images and videos must be shared as public URLs (JPEG, PNG, GIF, MP4, or MOV).
Please note: Your AI agent asks you to confirm the content, profile, and date before it schedules a post. Scheduling checks every network rule (message length, number of images, video requirements) and your workspace's mandatory label policy, so a post can be refused with a reason. Drafts skip these checks, so a draft can still be refused later when it is scheduled.
Please note: If your role requires approval before publishing, scheduling is refused. Ask your AI agent to create drafts instead, then send them for approval in Agorapulse.
Editing and deleting posts
Edit the text, media, link, publishing date, and network options of a post that has not been published yet
Delete any post that has not been published yet
Please note: Your AI agent can only edit posts that it created. It cannot edit posts composed in the Agorapulse app, or posts that target several profiles or dates, or are customized per profile. Edit those posts directly in Agorapulse.
Calendar notes
Search, create, edit, and delete calendar notes
Please note: Editing a note replaces the whole note. Your AI agent reads the note first and resends everything it needs to keep. Notes cover whole days and are never published.
Per-network options
When your AI agent creates a draft, schedules a post, or edits a post, it can use the following options for each network:
Network | Supported options |
Publishing surface (feed, story, or reel), first comment, link preview title and description, and video title | |
Publishing surface (feed, story, or reel) and first comment | |
First comment, link preview title and description, and poll (question plus two to four answers) | |
Board (required), pin title, and destination link | |
TikTok | Who can see the post, comments, duets, stitches, and automatic soundtrack |
YouTube | Video title (required), visibility, tags, made for kids, notify subscribers, embeddable, and licence |
Google Business | Post type (standard, event, or offer), event or offer title, button and link, start and end dates and times, coupon code, redemption link, and terms |
X (Twitter) | Threads, with text and media for each post |
Threads | Threads, with text and media for each post |
Bluesky | Link preview title and description |
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
Build any report available in Agorapulse Reports: your AI agent finds the metrics available for your profiles and computes the one you need
Get the demographics of your video viewers (age, gender, country, region, and city), where the network provides them
Compare paid and organic performance for posts with specific labels
Analyze the sentiment of the messages you received (positive, negative, or neutral)
Please note: Analytics cover up to one year per request and do not include future dates. Analytics are not available for Google Business, Pinterest, or Bluesky profiles, and available metrics vary by network. Social ROI and custom report layouts are not available through the MCP.
Organization management
List all your organizations and workspaces
Access your connected social profiles
View workspace and organization settings
List your profile groups, the folders used to organize your profiles (for example, by client or brand)
Please note: The number of available MCP tools will increase over time.
Looking for prompts to get started? The MCP Prompt and Workflow Library Explained article has more than 60 ready-to-use prompts and multi-step workflows for analytics, the Inbox, Social Listening, and publishing.
Limitations
Your AI agent can schedule posts, but it cannot publish them immediately. Scheduled posts are published automatically at the scheduled date, which leaves time for a person to step in. To publish a post immediately, use Agorapulse.
The MCP does not cover every Agorapulse feature. For example, you cannot set up Listening searches, upload media files, label, assign, or moderate Inbox items, or build custom report layouts through the MCP. Do these in Agorapulse.
Security and privacy
The connection uses OAuth, so you log in with your own Agorapulse account and never share an API key. Your AI agent sees exactly what your user can see in Agorapulse, with your role and permissions. You can disconnect your AI agent at any time in your AI agent's settings.
Your AI agent always asks you to confirm before it sends a reply or schedules a post. Review AI-generated content and analysis before you use or share it.
No data is stored permanently by the MCP connector; it only retrieves data when you make a request. How your AI provider (Anthropic, OpenAI, or Microsoft) processes the data shared in your conversations depends on your settings and agreement with that provider.
MCP Connector - Frequently Asked Questions
In this section, we cover questions about using the MCP connector. For setup, connection, and permission issues, see How to connect Agorapulse to Claude, ChatGPT, and Copilot.
Why was my scheduled post refused?
Why was my scheduled post refused?
When your AI agent schedules a post, Agorapulse checks it against the network's rules (such as message length, number of images, and video requirements) and your workspace's mandatory label policy. If the post does not meet a rule, it is refused with a reason. Ask your AI agent to fix the issue and try again.
If your role requires approval before publishing, scheduling is always refused. Ask your AI agent to create a draft instead, then send it for approval in Agorapulse.
Why can my AI agent not edit a post?
Why can my AI agent not edit a post?
Your AI agent can only edit unpublished posts that it created. It cannot edit:
Posts composed in the Agorapulse app
Posts that target several profiles or several dates
Posts customized per profile
Posts that are already published
Edit these posts directly in Agorapulse. Your AI agent can delete any unpublished post.
Why can my AI agent not publish a post right now?
Why can my AI agent not publish a post right now?
This is by design. Your AI agent can schedule a post for a future date, but it cannot publish immediately. The delay keeps a person able to review or stop the post before it goes out.
Why does a post I just created not appear in the calendar?
Why does a post I just created not appear in the calendar?
A new post can take 10 to 20 seconds to appear. Wait a moment, then ask your AI agent again.
Why am I receiving a 502 error when using "get_labeled_post_performance"?
Why am I receiving a 502 error when using "get_labeled_post_performance"?
The get_labeled_post_performance endpoint needs the exact name of the label and a clearly specified date range ("since -> until").
Example:
Use Agorapulse, get_labeled_post_performance for: Organization: (name of the organization) Profile: Social network_profile number (the profile number is in the Agorapulse URL when checking your reports or profile). Example: facebook_644340 Label: Name of the label Date range: since 2026-01-01 until 2026-06-26
Is there a usage limit?
Is there a usage limit?
Yes. You can make up to 1,000 requests every 30 minutes. If you reach this limit, wait a few minutes before trying again.
