MCP Server Overview - Social media studio

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI tools to external services. Social media studio’s MCP server lets AI agents create, schedule, and manage social media posts directly.

Connection details

Property	Value
Full endpoint (Cursor / custom)	`https://api.so-me.studio/mcp`
Directory endpoint (Claude / OpenAI marketplace)	`https://api.so-me.studio/mcp/directory`
Transport	Streamable HTTP (POST only)
Authentication	`X-API-Key` header or OAuth 2.1 (PKCE)
Mode	Stateless (no sessions)

Custom connectors (Cursor, Claude custom connector with a pasted key) can keep using X-API-Key. Claude Connectors Directory and OpenAI marketplace listings should use the directory URL plus OAuth — that surface excludes AI image/video tools.

The directory MCP URL filters out AI image and video generation tools (Claude directory policy). Caption/text AI and scheduling tools remain available. The full catalog stays on /mcp.

OAuth (directory clients)

Social media studio supports MCP OAuth 2.1 with PKCE (S256), protected-resource metadata, and dynamic client registration / CIMD-friendly authorization-server metadata. The agent-readable Auth.md guide describes the complete public-client PKCE flow. Its URL and the supported user_authorization method are also published in the OAuth metadata’s agent_auth block.

Endpoint	Purpose
`GET /.well-known/oauth-protected-resource/mcp/directory`	Protected resource metadata for the directory MCP
`GET /.well-known/oauth-authorization-server`	Authorization server discovery (PKCE S256)
`GET /oauth/authorize`	Authorization + consent
`POST /oauth/token`	Token exchange / refresh
`POST /oauth/register`	Dynamic Client Registration (fallback)

Write tools remain plan-gated (Standard, Advanced, or Lifetime API access) for both API-key and OAuth sessions.

Available tools

Once connected, your AI agent can call 205 tools, grouped below by area. Every tool consumes a small number of MCP credits per call (1 = read, 2 = write/mutate, 3 = analytics, 5 = AI text, 8 = AI image, 10 = compound AI actions). Use list_mcp_tools to fetch the live list with per-tool credit costs, and get_mcp_usage to check your remaining MCP credits.

Posts (11 tools)

Tool	Description
`list_posts`	List scheduled/published posts with filtering by status and platform
`get_post`	Get a single post by ID
`create_post`	Create a new post targeting any connected platform
`update_post`	Update an existing post’s content or schedule
`schedule_post`	Schedule an existing post for future publishing
`unschedule_post`	Remove a post from the schedule (set back to pending)
`delete_post`	Delete a post
`retry_post`	Retry a failed post (resets status from FAILED to PENDING)
`resubmit_post`	Resubmit a rejected post for approval
`bulk_delete_posts`	Delete multiple posts at once
`get_calendar_posts`	Get posts for a date range (calendar view)

Post Comments (5 tools)

Tool	Description
`list_post_comments`	List comments on a post
`add_post_comment`	Add a comment to a post
`update_post_comment`	Update an existing post comment
`delete_post_comment`	Delete a post comment
`mark_comments_as_read`	Mark all comments on a post as read

Drafts (6 tools)

Tool	Description
`list_drafts`	List draft posts in your workspace
`get_draft`	Get a single draft by ID
`create_draft`	Create a new draft post
`update_draft`	Update an existing draft
`delete_draft`	Delete a draft
`convert_draft`	Convert a draft to a scheduled post

Accounts (3 tools)

Tool	Description
`list_accounts`	List connected social media accounts
`get_account`	Get details of a connected social account
`disconnect_account`	Disconnect (remove) a connected social account

Media (13 tools)

Tool	Description
`list_media`	List media files in your library
`search_media`	Search media files by name
`get_media_file`	Get a single media file by ID
`delete_media`	Delete a media file from the library
`bulk_delete_media`	Delete multiple media files at once
`list_media_folders`	List media folders in the library
`create_media_folder`	Create a new media folder
`delete_media_folder`	Delete a media folder (and its contents)
`move_media_file`	Move a media file to a different folder or to root
`move_media_folder`	Move a folder to a different parent or to root
`rename_media_file`	Rename a media file
`rename_media_folder`	Rename a media folder
`presign_media_upload`	Generate presigned S3 PUT URLs to upload files into the library

Inbox (18 tools)

Tool	Description
`list_conversations`	List inbox conversations across all connected platforms
`get_messages`	Get messages in a conversation thread
`reply_to_conversation`	Post a follow-up into a conversation thread
`update_conversation`	Update conversation status (mark as read/seen, resolved, etc.)
`delete_conversation`	Delete a conversation thread
`list_saved_replies`	List saved reply templates
`get_saved_reply`	Get a single saved reply by ID
`create_saved_reply`	Create a new saved reply template
`update_saved_reply`	Update an existing saved reply
`delete_saved_reply`	Delete a saved reply
`subscribe_inbox`	Enable inbox sync for a connected social account
`unsubscribe_inbox`	Disable inbox sync for a connected social account
`edit_inbox_message`	Edit a comment/message in the social inbox (Facebook/Instagram)
`delete_inbox_message`	Delete a comment/message in the social inbox (Facebook/Instagram)
`hide_inbox_message`	Hide or unhide a comment in the social inbox (Facebook/Instagram)
`preview_bulk_reply`	Preview the recipients of a bulk reply before sending
`create_bulk_reply`	Send one reply (with optional `{{name}}` personalization) to many DM conversations
`get_bulk_reply_batch`	Get the status and results of a bulk reply batch

Approvals (4 tools)

Tool	Description
`list_approvals`	List posts pending approval
`approve_post`	Approve a post that is pending approval
`reject_post`	Reject a post that is pending approval (rejection comment required)
`update_review_comment`	Update the review/rejection comment on a post in the approval workflow

Teams (6 tools)

Tool	Description
`list_team_members`	List all team members in your workspace
`invite_team_member`	Invite a new member to the workspace
`remove_team_member`	Remove a member from the workspace
`update_member_role`	Update a team member’s role
`list_team_invitations`	List pending team invitations
`cancel_team_invitation`	Cancel a pending team invitation

Biolinks (19 tools)

Tool	Description
`list_biolinks`	List all biolink pages
`get_biolink`	Get details of a biolink page
`create_biolink`	Create a new biolink page
`update_biolink`	Update an existing biolink page
`delete_biolink`	Delete a biolink page
`publish_biolink`	Toggle the published state of a biolink
`change_biolink_theme`	Switch a biolink to a preset theme
`set_biolink_custom_theme`	Apply custom theme colors to a biolink
`list_biolink_buttons`	List buttons on a biolink page
`create_biolink_button`	Add a button to a biolink page
`update_biolink_button`	Update a button on a biolink page
`delete_biolink_button`	Delete a button from a biolink page
`reorder_biolink_buttons`	Reorder buttons on a biolink page
`list_biolink_posts`	List gallery posts on a biolink page
`create_biolink_post`	Add a gallery post to a biolink
`update_biolink_post`	Update a gallery post on a biolink
`delete_biolink_post`	Delete a gallery post from a biolink
`reorder_biolink_posts`	Reorder gallery posts on a biolink
`get_biolink_analytics`	Get analytics for a biolink page (views, clicks)

AI Content (10 tools)

Tool	Description
`generate_caption`	Generate an AI caption for a specific platform and tone
`generate_content`	Generate or rewrite AI text of any type (post, caption, hashtag, headline, bio, thread, email, etc.)
`generate_image`	Generate an AI image from a text prompt
`generate_and_schedule`	Generate AI content, create a post, and schedule it in one call
`get_ai_history`	Get AI prompt generation history
`get_ai_credits`	Get AI credit balances and limits (text, image, UGC video) for the current plan
`list_ai_image_providers`	List available AI image generation providers allowed by the current plan
`list_generated_images`	List AI-generated images with pagination
`get_generated_image`	Get details of a single AI-generated image by ID
`delete_generated_image`	Delete an AI-generated image

AI Video / UGC (9 tools)

Tool	Description
`generate_video`	Generate an AI UGC video from hook text + avatar
`list_videos`	List generated UGC videos
`get_video`	Get a generated video by ID (includes generation status)
`delete_video`	Delete a generated video
`list_avatars`	List available UGC avatars for video generation
`list_sounds`	List available sounds/music for video generation
`get_sound_genres`	List available background-sound genres for UGC videos
`generate_hook_suggestions`	Generate AI hook/script suggestions for UGC videos
`list_ai_video_providers`	List available AI UGC video providers allowed by the current plan

Analytics (26 tools)

Tool	Description
`get_analytics_summary`	Fetch workspace analytics: post counts by status and platform
`get_platform_analytics`	Get detailed analytics for a specific connected social account
`get_post_analytics`	Get analytics for a specific post
`get_facebook_analytics`	Get Facebook page-level analytics
`get_facebook_posts_analytics`	Get per-post Facebook page analytics
`get_facebook_videos_analytics`	Get per-video Facebook page analytics
`get_instagram_analytics`	Get Instagram account-level analytics
`get_instagram_media_analytics`	Get per-post Instagram media analytics
`get_instagram_stories_analytics`	Get Instagram stories analytics
`get_linkedin_analytics`	Get LinkedIn page-level analytics
`get_linkedin_posts_analytics`	Get per-post LinkedIn page analytics
`get_youtube_analytics`	Get YouTube channel-level analytics
`get_youtube_videos_analytics`	Get per-video YouTube channel analytics
`get_twitter_analytics`	Get Twitter/X account-level analytics
`get_twitter_content_analytics`	Get Twitter/X content-level analytics
`get_tiktok_analytics`	Get TikTok account analytics
`get_whatsapp_analytics`	Get WhatsApp Business account analytics
`get_bluesky_analytics`	Get Bluesky account analytics
`get_mastodon_analytics`	Get Mastodon account analytics
`get_reddit_account_analytics`	Get Reddit account-level analytics
`get_reddit_submissions_analytics`	Get Reddit submissions (posts) analytics
`get_pinterest_analytics`	Get Pinterest account analytics
`get_pinterest_pins_analytics`	Get per-pin Pinterest analytics
`get_pinterest_top_pins_analytics`	Get top-performing Pinterest pins
`get_pinterest_top_video_pins_analytics`	Get top-performing Pinterest video pins
`get_gmb_analytics`	Get Google Business Profile (GMB) location analytics

Best Time to Post (3 tools)

Tool	Description
`get_best_time_recommendations`	List best-time-to-post recommendations for all connected accounts in the workspace
`get_best_time_recommendation`	Get the best-time recommendation (heatmap + top windows) for a single account
`recompute_best_time_recommendation`	Recompute the best-time recommendation for an account from recent engagement history

Templates (3 tools)

Tool	Description
`list_templates`	List available content templates by category
`get_template`	Get a single template by ID
`render_template`	Render a template with provided field values

Knowledge (RAG) (6 tools)

Tool	Description
`list_knowledge`	List knowledge documents used by the AI assistant (RAG)
`get_knowledge`	Get a single knowledge document with extracted text and metadata
`create_knowledge`	Create a knowledge document from an uploaded file or a typed note
`update_knowledge`	Update a knowledge document’s metadata or note body
`reprocess_knowledge`	Retry extraction for a failed PDF/image/text knowledge document
`delete_knowledge`	Delete a knowledge document

Canva (4 tools)

Tool	Description
`get_canva_status`	Check whether Canva is connected for the authenticated user
`list_canva_designs`	List the user’s Canva designs (paginated, searchable)
`export_canva_design`	Export a Canva design to an image (async; returns an export job id)
`get_canva_export_status`	Poll the status of a Canva design export job

Help & Support (5 tools)

Tool	Description
`create_ticket`	Create a support ticket
`list_tickets`	List your support tickets
`get_ticket`	Get a support ticket with details
`send_ticket_message`	Send a message in a support ticket
`list_ticket_messages`	List all messages for a support ticket

Notifications (5 tools)

Tool	Description
`list_notifications`	List in-app notifications for the authenticated user
`get_unread_notification_count`	Get the count of unread notifications, optionally by category
`mark_notification_read`	Mark a single notification as read
`mark_all_notifications_read`	Mark all notifications (optionally within a category) as read
`archive_notification`	Archive (dismiss) a notification

Settings & Account (9 tools)

Tool	Description
`get_profile`	Get your user profile
`update_profile`	Update the authenticated user’s profile (name, password, email)
`get_organization`	Get workspace/organization details
`update_organization`	Update the current workspace (name, description, color, timezone)
`get_usage`	Get usage breakdown for current billing period
`get_user_preferences`	Get the authenticated user preferences (notification settings, timezone, UI prefs)
`update_user_preferences`	Update (merge) the authenticated user preferences
`get_current_tenant`	Get the currently active workspace (tenant) details
`get_billing`	Get subscription and billing information

Plans & Billing (4 tools)

Tool	Description
`get_plans`	Get the plan catalog with pricing and visibility
`get_plan_features`	Get the feature matrix for a specific plan
`get_subscription`	Get the workspace’s current subscription status, plan and limits
`list_invoices`	List invoices for the current subscription

API Keys (3 tools)

Tool	Description
`list_api_keys`	List active API keys for the current workspace
`create_api_key`	Create a new API key (full key returned only once)
`revoke_api_key`	Revoke an API key

Workspaces / Tenants (4 tools)

Tool	Description
`list_tenants`	List workspaces/tenants the authenticated user belongs to
`create_tenant`	Create a new workspace owned by the authenticated user
`delete_tenant`	Delete a workspace
`leave_tenant`	Leave a workspace the user is a member of

Referrals (2 tools)

Tool	Description
`get_referral_code`	Get the authenticated user’s referral code
`get_referral_stats`	Get referral code, referral count, credits earned and share URL

MCP Introspection (2 tools)

Tool	Description
`get_mcp_usage`	Get this workspace’s MCP credit usage, limits and per-tool breakdown for the current period
`list_mcp_tools`	List all available MCP tools and their credit costs

WhatsApp (6 tools)

Tool	Description
`list_whatsapp_templates`	List WhatsApp Business message templates
`get_whatsapp_template`	Get a single WhatsApp message template by name
`create_whatsapp_template`	Create (submit for Meta approval) a WhatsApp message template
`delete_whatsapp_template`	Delete a WhatsApp message template
`send_whatsapp_template`	Send a WhatsApp template message to a recipient
`upload_whatsapp_template_media`	Upload header media (image/video/document) for a template

Webhooks (10 tools)

Tool	Description
`list_webhook_subscriptions`	List webhook subscriptions
`get_webhook_subscription`	Get a single webhook subscription by ID
`create_webhook_subscription`	Create a webhook subscription for event categories
`update_webhook_subscription`	Update a webhook subscription (URL, categories, active state, regenerate secret)
`delete_webhook_subscription`	Delete a webhook subscription
`test_webhook_subscription`	Send a test ping to a webhook subscription
`list_webhook_deliveries`	List webhook delivery logs with optional filters
`get_webhook_delivery`	Get a single webhook delivery log with full payload and status
`retry_webhook_delivery`	Retry a failed webhook delivery
`list_webhook_events`	List all available webhook event types by category

Integration Helpers (9 tools)

These tools resolve platform-specific posting targets (boards, subreddits, channels, locations) so you can pick a destination before creating a post.

Tool	Description
`list_pinterest_boards`	List Pinterest boards for an account (select a board before posting)
`create_pinterest_board`	Create a new Pinterest board
`list_reddit_subreddits`	List subreddits the connected Reddit account is a member of
`list_reddit_flairs`	List available post flairs for a subreddit
`list_gmb_locations`	List Google Business Profile (GMB) locations for an account
`list_discord_channels`	List Discord channels available for a bot-mode account
`list_slack_channels`	List Slack channels for a connected workspace
`list_telegram_chats`	List Telegram chats/groups available for an account
`get_tiktok_creator_info`	Get TikTok creator/account info (validate posting capabilities)

Supported platforms

The socialMedia / platform enum used by the post and AI-content tools (create_post, create_draft, generate_caption, generate_and_schedule, generate_hook_suggestions, etc.) accepts these values:

Platform	Enum Value
Twitter / X	`TWITTER`
Instagram	`INSTAGRAM`
LinkedIn	`LINKEDIN`
LinkedIn Page	`LINKEDIN_PAGE`
Facebook	`FACEBOOK`
TikTok	`TIKTOK`
YouTube	`YOUTUBE`
Threads	`THREADS`
WhatsApp	`WHATSAPP`
Dribbble	`DRIBBBLE`
Pinterest	`PINTEREST`

Analytics and integration-helper tools cover more destinations than the post enum above — including Bluesky, Mastodon, Reddit, Google Business Profile (GMB), Discord, Slack, and Telegram. Use list_accounts to discover every connected account and its accountId, then pass that id to the platform-specific analytics or integration-helper tools.

Post types

The postType parameter on create_post, update_post, create_draft, and update_draft accepts: TEXT, IMAGE, MULTIPLE_IMAGES, VIDEO, CAROUSEL, REEL, STORY (default: TEXT).

Post statuses

The status filter on list_posts accepts: POSTED, SCHEDULED, PENDING, FAILED, PENDING_APPROVAL, REJECTED.

Example requests

The MCP server speaks JSON-RPC 2.0 over Streamable HTTP. Most agents handle this for you, but you can call it directly with curl.

curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "create_post",
      "arguments": {
        "text": "Big news coming Friday!",
        "socialMedia": "TWITTER",
        "postType": "TEXT",
        "scheduledAt": "2026-06-20T15:00:00.000Z"
      }
    }
  }'

curl -X POST https://api.so-me.studio/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-API-Key: sk_live_your_api_key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "generate_and_schedule",
      "arguments": {
        "platform": "LINKEDIN",
        "socialMedia": "LINKEDIN",
        "topic": "Why async standups beat daily meetings",
        "tone": "professional",
        "scheduledAt": "2026-06-21T09:00:00.000Z"
      }
    }
  }'

Setup guides

Choose your AI agent to get started:

Claude Code

Anthropic’s agentic coding tool

Claude Desktop

Anthropic’s desktop application

Cursor

AI-first code editor

OpenAI Codex

OpenAI’s coding agent

Windsurf

AI-powered IDE by Codeium

VS Code (Copilot)

GitHub Copilot agent mode

Gemini CLI

Google’s AI terminal agent

Troubleshooting

401 Unauthorized

Double-check your API key is correct and active. The header must be exactly X-API-Key (case-sensitive). Generate a new key from Settings > API Access if needed.

405 Method Not Allowed on GET/SSE

Social media studio’s MCP server runs in stateless mode using Streamable HTTP. Only POST requests are supported. Make sure your agent is configured with HTTP transport, not SSE.

Rate limit exceeded

MCP tool calls are rate-limited per minute by plan. Check your usage in Settings > MCP and upgrade if needed.

Credits exhausted

Each MCP tool call consumes credits. Check remaining credits in Settings > MCP.

Connection timeout

Increase the timeout in your MCP configuration. A value of 30000ms (30 seconds) is recommended.

​What is MCP?

​Connection details

​OAuth (directory clients)

​Available tools

​Supported platforms

​Post types

​Post statuses

​Example requests

​Setup guides

Claude Code

Claude Desktop

Cursor

OpenAI Codex

Windsurf

VS Code (Copilot)

Gemini CLI

​Troubleshooting

What is MCP?

Connection details

OAuth (directory clients)

Available tools

Supported platforms

Post types

Post statuses

Example requests

Setup guides

Troubleshooting