MCP Server Reference

Manage social media posts from any MCP client (Claude Desktop, Cursor, ChatGPT, and others): connect accounts, upload media, publish or schedule posts, and read analytics on behalf of an authenticated Sharetopus subscriber.

https://sharetopus.com/api/mcp/mcpstreamable httpsse

MCP access requires the Creator plan or higher; every tool is gated at that tier.

Connection

Two transports, both stateless: no persistent sessions. Streamable HTTP is the recommended transport for current MCP clients.

Transport	URL
Streamable HTTP	https://sharetopus.com/api/mcp/mcp
SSE	https://sharetopus.com/api/mcp/sse

Authentication

Two independent paths resolve to the same authenticated principal. Pick the one your client supports.

Method	How it works
API key	Send Authorization: Bearer stp_mcp_... on every request. Create the key at /integrations (shown once, up to 10 active keys, revocable from the UI).
OAuth 2.1	OAuth-capable clients discover the auth server automatically via the RFC 9728 metadata endpoint at /.well-known/oauth-protected-resource and sign in with dynamic client registration. No key needed.

Plan requirement and limits

What gates a tool call before any business logic runs.

Constraint	Value
Plan requirement	Creator plan or higher, for every tool
Rate limit	100 requests per 60 seconds per IP
Monthly quotas	Some tools carry monthly caps that scale with the plan tier; exceeding one returns an error naming the quota

Client configuration

Paste-ready configuration for API-key clients. OAuth-capable clients configure only the URL; the sign-in flow starts automatically.

Claude Desktop / Cursor · API key

{
  "mcpServers": {
    "sharetopus": {
      "url": "https://sharetopus.com/api/mcp/mcp",
      "headers": {
        "Authorization": "Bearer stp_mcp_YOUR_KEY"
      }
    }
  }
}

Read tools

6 of the server's 18 tools.

Tool	What it does
list_connections	List your connected social accounts with platform, display name, and availability status.
list_pinterest_boards	List Pinterest boards for a connected Pinterest account, with pagination via the bookmark cursor.
list_scheduled_posts	List your scheduled posts, with optional platform or status filter.
list_content_history	View your posted content history, with optional platform filter.
list_billing_summary	View your current subscription plan, status, and monthly usage quota counts.
request_account_reauth_link	Get a re-authentication link for a social account with an expired token. The user opens it in a browser.

Write tools

8 of the server's 18 tools.

Tool	What it does
attach_media_from_url	Download media from a public URL into Sharetopus storage. Returns a storage path for posting tools.
request_upload_url	Get a signed URL for uploading media directly to Sharetopus storage.
schedule_post	Schedule one post for a future time. Upload media first; use list_connections to find account ids.
post_now	Publish one post to one platform immediately. Returns an event id; confirm via list_content_history after 30 to 60 seconds.
cancel_scheduled_posts	Cancel scheduled posts. Only posts with status scheduled can be cancelled.
resume_scheduled_posts	Resume cancelled posts. Past-dated posts are rescheduled to one hour from now.
reschedule_posts	Change the scheduled time of up to 50 posts. Cancelled posts are resumed by the move.
delete_scheduled_posts	Permanently delete scheduled posts. Not reversible.

Advanced tools

3 of the server's 18 tools.

Tool	What it does
bulk_schedule	Schedule up to 30 posts in one call, for cross-posting or a content series. Supply batch_id to make retries safe.
bulk_post_now	Publish up to 30 posts immediately across platforms and accounts, reusing one media upload.
get_account_analytics	Fetch performance metrics (views, likes, comments, shares) for your content. Data may lag up to 24 hours.

AI tools

1 of the server's 18 tools.

Tool	What it does
generate_post_draft	Generate a draft post using the connected client's own LLM, at no Sharetopus inference cost.

Prompts (3)

Reusable message templates invocable from the client's prompt picker; each returns structured messages that guide the agent through a workflow.

Prompt	What it does
plan_week_for_platform	Plan a full week of content for a specific social platform around a chosen theme.
repurpose_post	Repurpose an existing post for other social platforms with platform-specific adaptations.
audit_calendar	Review your next 14 days of scheduled posts. Checks for gaps, clustering, and platform balance.

Typical flow

The four-step path from a fresh session to a confirmed post.

Step	Tool	Purpose
1	list_connections	Find social account ids and availability
2	attach_media_from_url	Upload media when the post carries an image or video (or request_upload_url)
3	schedule_post	Schedule (or post_now to publish immediately) with the account id and storage path
4	list_scheduled_posts	Confirm the result (or list_content_history for published posts)