Enables retrieval of Reddit messages via Sprout Social's Listening topics, allowing for the monitoring and analysis of social conversations and mentions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sprout-mcpShow me the engagement analytics for my social profiles"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sprout-mcp
An MCP (Model Context Protocol) server that wraps the Sprout Social Public API, letting Claude and other MCP clients interact with your Sprout Social account directly.
Tools
Metadata
Tool | Description |
| List all customers/accounts accessible with your API token |
| List all social profiles for a customer |
| List all message tags |
| List all profile groups |
| List all active users |
| List all teams |
Analytics
Tool | Description |
| Get aggregated metrics by profile (impressions, engagements, follower growth, etc.) |
| Get metrics for individual published posts — also use this for post counts |
Listening
Tool | Description |
| List all Listening topics and their IDs |
| Fetch messages from a Listening topic, filterable by network (Reddit, Twitter, etc.) |
Smart Inbox
Tool | Description |
| Retrieve inbound inbox messages (mentions, DMs, comments) |
Publishing
Tool | Description |
| List published, scheduled, or draft posts |
| Create a draft or scheduled post |
| Retrieve a specific post by ID |
Note: All tools return structured JSON error details on failure (HTTP status, endpoint, and API error body) instead of raw exceptions.
Setup
Prerequisites
Python 3.11+
uv (recommended) or pip
A Sprout Social account with API access
Install
git clone https://github.com/jmeserve/sprout-mcp.git
cd sprout-mcp
uv syncConfigure
Copy .env.example to .env and fill in your credentials:
cp .env.example .envSPROUT_API_TOKEN=your_api_token_here
SPROUT_CUSTOMER_ID=your_customer_id_hereSPROUT_API_TOKEN — Generate at Sprout Social → Settings → API → OAuth tokens
SPROUT_CUSTOMER_ID — Found in your Sprout Social account URL or via the
list_customerstool
Add to Claude Code
Add to your ~/.claude.json MCP servers config:
{
"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 to Claude Desktop
Add to your claude_desktop_config.json:
{
"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"
}
}
}
}Development
uv sync
uv run sprout-mcp # run the server
uv run mcp dev sprout_mcp/server.py # run with MCP inspectorResources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.