Sprout

You can run Sprout MCP, a server that exposes Sprout Social’s Public API through the Model Context Protocol, enabling Claude and other MCP clients to manage your Sprout Social account directly from your MCP environment.

How to use

To use this MCP server, connect your MCP client to the Sprout Social MCP endpoint as configured in your local environment. You can perform operations such as listing customers, profiles, and teams; retrieving analytics for profiles and posts; fetching listening messages; and publishing or querying posts. Start the server, then issue MCP requests from your client to invoke the available tools. Tools return structured results or error details in a consistent JSON format to help you build automations and workflows.

How to install

Prerequisites: You need Python 3.11 or newer and either uvx or pip installed on your system, plus a Sprout Social account with API access.

Install steps you should follow in order:

Installation commands and configuration details

# 1) Clone the repository
git clone https://github.com/jmeserve/sprout-mcp.git
cd sprout-mcp

# 2) Start the rebuild/run workflow with uv as described in the project
uv sync

# 3) Run the server (as part of development or runtime usage, see below for how to configure Claude)
uv run sprout-mcp

Configure credentials for Sprout Social access

# Copy the example environment file and fill in your credentials
cp .env.example .env

SPROUT_API_TOKEN=your_api_token_here
SPROUT_CUSTOMER_ID=your_customer_id_here

Add Sprout MCP server to Claude configuration

{
  "mcpServers": {
    "sprout_social": {
      "command": "uv",
      "args": ["--directory", "/path/to/sprout-mcp", "run", "sprout-mcp"],
      "env": {
        "SPROUT_API_TOKEN": "your_api_token_here",
        "SPROUT_CUSTOMER_ID": "your_customer_id_here"
      }
    }
  }
}

Add Sprout MCP server to Claude Desktop configuration

{
  "mcpServers": {
    "sprout_social": {
      "command": "uv",
      "args": ["--directory", "/path/to/sprout-mcp", "run", "sprout-mcp"],
      "env": {
        "SPROUT_API_TOKEN": "your_api_token_here",
        "SPROUT_CUSTOMER_ID": "your_customer_id_here"
      }
    }
  }
}

Available tools

list_customers

List all customers/accounts accessible with your API token

list_profiles

List all social profiles for a customer

list_tags

List all message tags

list_groups

List all profile groups

list_users

List all active users

list_teams

List all teams

get_profile_analytics

Get aggregated metrics by profile (impressions, engagements, follower growth, etc.)

get_post_analytics

Get metrics for individual published posts — also use this for post counts

list_listening_topics

List all Listening topics and their IDs

get_listening_messages

Fetch messages from a Listening topic, filterable by network (Reddit, Twitter, etc.)

get_messages

Retrieve inbound inbox messages (mentions, DMs, comments)

list_publishing_posts

List published, scheduled, or draft posts

create_post

Create a draft or scheduled post

get_publishing_post

Retrieve a specific post by ID