Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SPROUT_API_TOKEN | Yes | Your Sprout Social API token, generated at Sprout Social → Settings → API → OAuth tokens | |
| SPROUT_CUSTOMER_ID | Yes | Your Sprout Social customer ID, found in your Sprout Social account URL or via the list_customers tool |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_customers | List all customers/accounts accessible with the current API token. Returns customer IDs and names needed for other API calls. |
| list_profiles | List all social profiles for a customer. Args:
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| list_tags | List all message tags for a customer. Args:
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| list_groups | List all profile groups for a customer. Args:
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| list_users | List all active users for a customer. Args:
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| list_teams | List all teams for a customer. Args:
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| get_profile_analytics | Get analytics metrics aggregated by social profile. Args:
profile_ids: Comma-separated Sprout profile IDs.
start_time: Start of period (ISO 8601, e.g. '2024-01-01T00:00:00').
end_time: End of period (ISO 8601, e.g. '2024-01-31T23:59:59').
metrics: Comma-separated metric names. Common options:
impressions, engagements, net_follower_growth, engagement_rate,
video_views, reactions, comments, shares, clicks.
timezone: Timezone for the report (e.g. 'America/Chicago'). Default: UTC.
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| get_post_analytics | Get analytics metrics for individual published posts. Post-level metrics use the 'lifetime.' prefix (e.g. 'lifetime.impressions').
Common metrics: lifetime.impressions, lifetime.reactions, lifetime.engagements,
lifetime.clicks, lifetime.shares, lifetime.comments, lifetime.video_views.
Args:
profile_ids: Comma-separated Sprout profile IDs.
start_time: Start of period (ISO 8601, e.g. '2024-01-01T00:00:00').
end_time: End of period (ISO 8601, e.g. '2024-01-31T23:59:59').
metrics: Comma-separated metric names with lifetime. prefix.
limit: Number of posts to return (default 50, max 100).
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| get_messages | Retrieve inbound inbox messages (Smart Inbox) with optional filtering. This endpoint returns INBOUND messages only (mentions, DMs, comments).
For OUTBOUND post counts and performance metrics, use get_post_analytics instead.
Args:
profile_ids: Comma-separated Sprout profile IDs.
start_time: Start datetime (ISO 8601, e.g. '2024-01-01T00:00:00').
end_time: End datetime (ISO 8601).
tag_ids: Comma-separated tag IDs to filter by (optional).
limit: Number of messages to return (default 50).
page_cursor: Pagination cursor from a previous response (optional).
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| create_post | Create a draft or scheduled post in Sprout Social. Args:
profile_ids: Comma-separated Sprout profile IDs to publish to.
text: Post content/body text.
scheduled_send_time: When to publish (ISO 8601). Leave empty to save as draft.
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
| get_publishing_post | Retrieve a specific publishing post by ID. Args:
post_id: The publishing post ID to retrieve.
customer_id: Sprout customer ID. Defaults to SPROUT_CUSTOMER_ID env var. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |