Skip to main content

[New] Model Context Protocol (MCP) integration explained

Learn what the Agorapulse MCP connector lets your AI agent (Claude, ChatGPT, or Copilot) do with your social media.

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:

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

Facebook

Publishing surface (feed, story, or reel), first comment, link preview title and description, and video title

Instagram

Publishing surface (feed, story, or reel) and first comment

LinkedIn

First comment, link preview title and description, and poll (question plus two to four answers)

Pinterest

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?

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?

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?

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?

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"?

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?

Yes. You can make up to 1,000 requests every 30 minutes. If you reach this limit, wait a few minutes before trying again.

Did this answer your question?