KosmoKrator

productivity

Sprout Social CLI for AI Agents

Use the Sprout Social CLI from KosmoKrator to call Sprout Social tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

Sprout Social CLI Setup

Sprout Social can be configured headlessly with `kosmokrator integrations:configure sproutsocial`.

Install, configure, and verify
# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure sproutsocial --set access_token="$SPROUTSOCIAL_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor sproutsocial --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

KeyEnv varTypeRequiredLabel
access_token SPROUTSOCIAL_ACCESS_TOKEN Secret secret yes Access Token
url SPROUTSOCIAL_URL URL url no API Base URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

Generic CLI call
kosmo integrations:call sproutsocial.sproutsocial_list_profiles '{}' --json
Provider shortcut
kosmo integrations:sproutsocial sproutsocial_list_profiles '{}' --json

Discovery

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

Discovery commands
kosmo integrations:docs sproutsocial --json
kosmo integrations:docs sproutsocial.sproutsocial_list_profiles --json
kosmo integrations:schema sproutsocial.sproutsocial_list_profiles --json
kosmo integrations:search "Sprout Social" --json
kosmo integrations:list --json

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

sproutsocial.sproutsocial_list_profiles

List all social media profiles connected to the Sprout Social account. Returns profile IDs, service types (e.g., Twitter, Facebook, LinkedIn), and display names.

Read read
Parameters
none
Generic call
kosmo integrations:call sproutsocial.sproutsocial_list_profiles '{}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_list_profiles '{}' --json

sproutsocial.sproutsocial_get_profile

Get details of a specific social media profile in Sprout Social by its ID. Returns profile service type, display name, and account metadata.

Read read
Parameters
profileId
Generic call
kosmo integrations:call sproutsocial.sproutsocial_get_profile '{"profileId":"example_profileId"}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_get_profile '{"profileId":"example_profileId"}' --json

sproutsocial.sproutsocial_list_posts

List posts across social profiles in Sprout Social. Optionally filter by status (sent, scheduled, draft) and paginate results.

Read read
Parameters
count, page, status
Generic call
kosmo integrations:call sproutsocial.sproutsocial_list_posts '{"count":1,"page":1,"status":"example_status"}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_list_posts '{"count":1,"page":1,"status":"example_status"}' --json

sproutsocial.sproutsocial_create_post

Create and schedule a new social media post in Sprout Social. Provide the text content, target profile IDs, and optionally a scheduled time or media attachments.

Write write
Parameters
text, profileIds, scheduledAt, media
Generic call
kosmo integrations:call sproutsocial.sproutsocial_create_post '{"text":"example_text","profileIds":"example_profileIds","scheduledAt":"example_scheduledAt","media":"example_media"}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_create_post '{"text":"example_text","profileIds":"example_profileIds","scheduledAt":"example_scheduledAt","media":"example_media"}' --json

sproutsocial.sproutsocial_list_messages

List inbox messages and conversations in Sprout Social. Returns message IDs, sender info, and content snippets with pagination support.

Read read
Parameters
count, page
Generic call
kosmo integrations:call sproutsocial.sproutsocial_list_messages '{"count":1,"page":1}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_list_messages '{"count":1,"page":1}' --json

sproutsocial.sproutsocial_get_message

Get details of a specific message in Sprout Social by its ID. Returns sender info, message content, attachments, and conversation metadata.

Read read
Parameters
messageId
Generic call
kosmo integrations:call sproutsocial.sproutsocial_get_message '{"messageId":"example_messageId"}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_get_message '{"messageId":"example_messageId"}' --json

sproutsocial.sproutsocial_get_current_user

Get the currently authenticated Sprout Social user profile. Returns the user name, email, and account info.

Read read
Parameters
none
Generic call
kosmo integrations:call sproutsocial.sproutsocial_get_current_user '{}' --json
Shortcut
kosmo integrations:sproutsocial sproutsocial_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

sproutsocial.sproutsocial_list_profiles 0 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_list_profiles --json
ParameterTypeRequiredDescription
No parameters.
sproutsocial.sproutsocial_get_profile 1 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_get_profile --json
ParameterTypeRequiredDescription
profileId string yes The social profile ID to retrieve.
sproutsocial.sproutsocial_list_posts 3 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_list_posts --json
ParameterTypeRequiredDescription
count integer no Number of posts to return per page.
page integer no Page number for pagination.
status string no Filter by post status: "sent", "scheduled", or "draft".
sproutsocial.sproutsocial_create_post 4 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_create_post --json
ParameterTypeRequiredDescription
text string yes The text content of the post.
profileIds array yes Array of Sprout Social profile IDs to publish the post to.
scheduledAt string no ISO 8601 timestamp for when the post should be sent (e.g., "2025-02-01T09:00:00Z").
media object no Media attachments such as photo URL, link, or thumbnail.
sproutsocial.sproutsocial_list_messages 2 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_list_messages --json
ParameterTypeRequiredDescription
count integer no Number of messages to return per page.
page integer no Page number for pagination.
sproutsocial.sproutsocial_get_message 1 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_get_message --json
ParameterTypeRequiredDescription
messageId string yes The message ID to retrieve.
sproutsocial.sproutsocial_get_current_user 0 parameters
Schema command
kosmo integrations:schema sproutsocial.sproutsocial_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.