Skip to main content

Documentation Index

Fetch the complete documentation index at: https://info.bundle.social/llms.txt

Use this file to discover all available pages before exploring further.

bundlesocial-mcp is a Model Context Protocol server that exposes the bundle.social operations as MCP tools — so Claude Desktop, Claude Code, Cursor and any other MCP client can post, schedule, import, analyze content and manage connected accounts across 14+ platforms. It ships as a local stdio server (npx bundlesocial-mcp). A hosted remote server at mcp.bundle.social is on the roadmap.

npm: bundlesocial-mcp

npx bundlesocial-mcp

MCP Inspector

npx @modelcontextprotocol/inspector npx bundlesocial-mcp

​
Tools

The server covers the whole bundle.social API (the platform-specific edit/delete-after-publish helpers are reached via trigger_integration_tool). Diagnostics & discovery
ToolDescription
check_setupDiagnostic JSON: API key, connectivity, organization API access, team selection, integrations, quotas.
list_integrationsList connected social accounts (ids, platform types, channels).
list_integration_tools / trigger_integration_toolList & call read-only platform helpers — subreddit flairs/requirements, YouTube categories/playlists/regions, LinkedIn mentions, Instagram locations, Google Business categories, TikTok trending music.
Posts
ToolDescription
create_post / schedule_postPublish now (or as a draft) / schedule for a future date.
update_post / retry_postUpdate a post (only changed fields) / re-attempt one that ended in ERROR.
list_posts / get_post / delete_postList with filters / fetch / delete posts.
create_post_import …Import post history from a connected account: create_post_import, list_post_imports, get_post_import, list_imported_posts, delete_imported_posts, retry_post_import.
create_post_csv_import …Bulk-schedule from a CSV (URL or local file): create_post_csv_import, list_post_csv_imports, get_post_csv_import, get_post_csv_import_status, get_post_csv_import_rows.
Comments
ToolDescription
create_comment / list_comments / get_comment / update_comment / delete_commentComment on a post (pass content multiple times for a chain) / list / fetch / update / delete comments.
create_comment_import …Pull existing comments for a post: create_comment_import, list_comment_imports, get_comment_import, list_imported_comments.
Media
ToolDescription
upload_mediaUpload an image/video/document from a URL (or local path in stdio mode); auto-chunks large local files.
init_large_upload / finalize_large_uploadLow-level chunked-upload primitives (for manual control).
list_media / get_media / delete_media / delete_media_manyList / fetch / delete uploads.
Integrations (social accounts)
ToolDescription
connect_integration / disconnect_integrationStart an OAuth connect flow (returns a URL) / disconnect an account.
create_integration_portal_linkHosted portal link for end users to connect accounts.
set_integration_channel / unset_integration_channel / refresh_integration_channelsPick / clear / refresh the channel (page, board, server channel) for an account.
check_integration_connection / refresh_integration_profile / get_integration_by_type / copy_integration / list_integrations_to_deleteConnection check, profile refresh, lookup by platform, copy between teams, list accounts pending deletion.
Analytics
ToolDescription
get_post_analyticsPer-post engagement metrics (raw: true for the unprocessed payload).
get_account_analyticsLatest analytics for a connected account by platform (raw: true for the unprocessed payload).
get_bulk_post_analyticsEngagement metrics for several posts at once.
refresh_analyticsForce a fresh pull — by postId for a post, otherwise platform for an account.
get_analytics_summaryOrg-level usage quotas + latest per-integration analytics snapshot.
Teams & organization
ToolDescription
list_teams / get_team / create_team / update_team / delete_teamManage teams.
get_organization / get_usageYour organization, and posts/comments/uploads/imports usage & quotas.
Errors come back as { "error": { "code", "message", "details"? } } with isError: true. The per-platform fields for posts are documented in Platform parameters.

​
Configuration

Reads BUNDLESOCIAL_API_KEY (required), BUNDLESOCIAL_TEAM_ID (optional — needed only if your org has more than one team) and BUNDLESOCIAL_API_URL (optional). Get an API key in the dashboard.
claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "bundlesocial": {
      "command": "npx",
      "args": ["-y", "bundlesocial-mcp"],
      "env": { "BUNDLESOCIAL_API_KEY": "sk_live_..." }
    }
  }
}

​
Example prompts

  • “List my connected social accounts via bundle.social.”
  • “Post ‘We just shipped dark mode 🌙’ to X and Bluesky.”
  • “Schedule a LinkedIn post for next Monday 9am UTC announcing the launch.”
  • “Post to r/test on Reddit — first check the subreddit’s requirements and flairs, then post with the right flair.”
  • “Reply to post post_abc123 with a 3-comment thread on LinkedIn.”
  • “How did post post_abc123 perform?”
Also see: CLI · SDK.