Skip to main content

Model Context Protocol (MCP) integration explained

Learn how Agorapulse's MCP allows you to integrate with AI tools

Agorapulse's Model Context Protocol (MCP) Connector allows you to integrate Agorapulse with conversational AI assistants like Claude, ChatGPT, and Microsoft Copilot, 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:

Please note: The MCP is currently accessible on current subscriptions.

Eligibility and requirements

The MCP connector is available to all Agorapulse users, excluding Legacy plan holders.

To use the connector, you must have an active subscription to one of the following AI services:

  • Claude: Pro, Max, Team, or Enterprise.

  • ChatGPT: Go, Plus, Pro, or Team.

  • Copilot: Copilot Studio

You will also need to have an Admin role on your Claude, ChatGPT, or Copilot 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:

  1. Go to chatgpt.com and log in to your account

  2. 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

  3. Under Advanced Settings, toggle on Developer Mode

  4. Back on the Connectors page, select Custom Connectors and add the following details:

  5. You will be prompted to authorize the connection by logging in to your Agorapulse account

  6. 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 can connect to Agorapulse's MCP by searching Claude's directory for Agorapulse under Connectors or adding it as a custom connector.

To add Agorapulse from Claude's directory, you will need to:

  1. Go to claude.ai and log in to your account

  2. Click on your profile image in the bottom left corner

  3. Select Settings and click Connectors

  4. At the top of the window, click Discover

  5. In the search bar, type Agorapulse

  6. Click Connect

  7. If you are not logged in to Agorapulse, you will be asked to log in. Once you have logged in, click Authorize

After authorizing the connection, you will be taken back to Claude, where Agorapulse will now appear under your list of connectors.

To add Agorapulse as a custom connector, you will need to:

  1. Go to claude.ai and log in to your account

  2. Click on your profile image in the bottom left corner

  3. Select Settings

  4. Click Connectors and select Add Connector

  5. You'll need to provide:

  6. Next, you will need to decide who can use this connector:

    • All members

    • Specific teams

    • Manual approval

  7. 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.


Connecting to Copilot

  1. Sign in to Microsoft Copilot Studio at copilotstudio.microsoft.com

  2. Navigate to your Agent and select the Tools tab

  3. Click Add a tool, then select New tool

  4. Choose Model Context Protocol from the options

  5. Fill in the required information:

    • Server name: Agorapulse (or your preferred name)

    • Server description: Access Agorapulse social media management capabilities

    • Server URL: https://api.openmcp.agorapulse.com/mcp

  6. Select the authentication type:

    • For OAuth authentication: Choose OAuth 2.0 and follow the dynamic discovery or manual configuration steps

  7. Click Create to add the server

  8. When prompted, authorize the connection by logging into your Agorapulse account

  9. Review the permissions and authorize Copilot Studio to access your Agorapulse data

Once connected, the Agorapulse MCP server will appear as a tool in your agent's Tools tab. All MCP tools and resources from Agorapulse will be automatically available for your agent to use.
​


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 disconnect your Agorapulse connector in ChatGPT:

  1. 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

  2. Click on Agorapulse in your list of connectors.

  3. Finally, click Disconnect


In Claude

To disconnect your Agorapulse connector in Claude:

  1. Click on your profile image in the bottom left corner

  2. Select Settings

  3. Click Connectors

  4. Click the three dots next to Agorapulse.

  5. Select Disconnect
    ​

In Copilot

To manage your Agorapulse connector in Copilot:

  1. Go to the Tools tab in your agent

  2. Select the Agorapulse MCP server from the list

  3. Toggle off Allow all to see individual tool controls

  4. Use the individual toggles to enable only the tools you need

To delete the connector from Copilot:

  1. Go to the Tools tab in your agent

  2. Select the Agorapulse MCP server from the list

  3. Find the tool on the list of tools and hover over the tool name. Select the three dots (…).

  4. Select Delete. A confirmation window appears.

  5. Select Delete to remove the connector.


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

Please note: The information that the MCP returns is based on what permissions have been given to you in the Agorapulse app.

The Agorapulse MCP connector enables you to perform several key actions across five main categories:

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 it belongs 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 will ask you to confirm a reply before sending it.

Listening

  • 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 will be retrieved.

  • View Listening metrics: volume, engagement, sentiment, and word clouds, for Standard and Competitive searches.

Publishing and content management

  • Create draft posts for your social media profiles. Images and videos added to your posts must be shared as public URLs
    ​Note: Each draft is created for one profile. To post on three networks, your AI agent creates three drafts

  • Search and create calendar notes

Please note: Network-specific options (first comment, threads, Pinterest board, Google Business events) are not supported through the MCP.

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, 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, neutral)

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

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 tables in the drop-downs below show some example prompts you can use:

Organization

Example prompt

"Which organizations and workspaces do I have access to, and how many profiles are connected in each?"

"Sort all my connected social profiles into regional groups."

"List my profile groups and the profiles inside each one, so I can see how my clients or brands are organized."

List the profiles in my [client] group, then show me last month's results for each one.

Anatlycis & Reporting

Example prompt

"Compare [client]'s performance this month with last month. Highlight the most useful changes, explain what the data supports, and recommend three priorities for our next client meeting."

"Which post formats and labels performed best over the last 90 days? Give me the top three and tell me what to do more of next month."

"Build a one-page summary of this quarter's results across all my profiles: reach, engagement, audience growth, and the posts that drove them. Write it for a manager who has two minutes."

"How is my team doing on response time this week? Show me who replies fastest and where messages wait the longest."

Inbox

Example prompt

"Go through this week's inbox across all my profiles. Tell me what needs a reply today, what's a complaint, and what can wait."

"What are people asking us most this week? Group the messages by topic and show me the three questions that keep coming back."

"Show me the comments no one on the team has reviewed yet, oldest first, and summarize what each one is about."

Listening

Example prompt

"How is our brand talked about this month? Give me the main topics, the overall sentiment, and the three mentions with the most engagement."

"Compare our sentiment score with [competitor]'s over the last 30 days and tell me which topics they own that we don't."

"What topics come up most alongside mentions of [product]? Which ones are growing and worth a post?"

"Which networks drive the most conversation about [topic], and how has the volume moved week by week over the last two months?"

Content

Example prompt

"Create a draft on our LinkedIn and Facebook pages from this announcement: [paste]. Adapt the tone for each network."

"Look at what worked best last month, then draft a post on [topic] for our [network] page in the same style."

"Add a calendar note on [date] to remind the team to prep assets for [campaign], and list the notes we already have that week."

Limitations

The MCP connector can create drafts, but it does not publish or schedule content. Drafts never go out on their own: review, schedule, and publish them from Agorapulse.

Security and privacy

The connection uses OAuth, meaning 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 from your AI agent at any time in your AI agent’s settings.

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 the questions that will assist in troubleshooting the Model Context Protocol Connector.

Can I view which AI agents can be connected inside of Agorapulse?

Currently supported AI agents can be viewed inside Agorapulse by:

  1. Click on your avatar and select Personal Settings

  2. Choose the Connectors sub-menu

  3. Under AI agents that can act on your account, you will see the AI agents that are currently supported by Agorapulse

  4. Click Connect under the relevant AI agent

  5. On the next page, you will see two sections:

    • Configure your MCP client: In this section, you will be able to copy the MCP Server URL that can be used to connect your AI agent to Agorapulse's MCP

    • Try out some prompts: Copy and paste these prompts to get started with our MCP

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.

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 the time period needs to be clearly specified "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 name). Example: facebook_644340 
​Label: Name of the label
Date range: since **** until ***** (ex. since 2026-01-01 until 2026-06-26)

Why does my AI agent ask for permission before listing my organizations or profiles?

Some AI agents ask for confirmation before using certain tools. The tools that list your organizations, workspaces, profiles, and groups only read data and never change anything in your account. You can approve them, or allow them permanently in your AI agent’s settings.

Is there a usage limit?

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

Did this answer your question?