@agorapulse/mcp

Agorapulse MCP Server

A Model Context Protocol (MCP) server that provides access to the Agorapulse API for social media management and analytics.

Main Features

• Social Profile Management: List and get details of connected social media profiles
• Analytics Data:
  • global performance metrics,
  • content performance,
  • community management data

Available Tools

Organization Management

• get_organizations - List accessible organizations
• get_workspaces - List workspaces for an organization
• get_profiles - List social media profiles in a workspace

Analytics

• get_audience_insights - Get audience analytics for a profile (followers, demographics)
• get_community_management_insights - Get community management metrics (replies, messages, actions)
• get_content_insights - Get content performance analytics (posts, engagement, reach)

Prerequisites

• Node.js 20+
• npm
• Agorapulse API key

Usage

With Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "agorapulse": {
      "command": "npx",
      "args": ["-y", "@agorapulse/mcp"],
       "env": {
          "AGORAPULSE_API_KEY": "your-agorapulse-api-key"
       }
    }
  }
}

Local Development and Testing

• Install dependencies:

  npm install
  

• Build the project:

  npm run build
  

• Test using Claude Code:

  claude mcp remove -s user "agorapulse" # Remove any previous Agorapulse MCP server definition
  claude mcp add agorapulse node ${PATH_TO_REPOSITORY}/dist/index.js --env AGORAPULSE_API_KEY="your-agorapulse-api-key"
  

Testing on preprod

claude mcp remove -s user "agorapulse" # Remove any previous Agorapulse MCP server definition
claude mcp add agorapulse node ${PATH_TO_REPOSITORY}/dist/index.js --env AGORAPULSE_API_KEY="your-agorapulse-preprod-api-key" AGORAPULSE_API_URL="https://preprod.agorapulse.com"