Dropspace
Create, schedule, and publish social media launches across platforms, then read the analytics.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWget_media_job에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"dropspace": {
"url": "https://api.dropspace.dev/mcp"
}
}
}원격 엔드포인트
https://api.dropspace.dev/mcpstreamable-http할 수 있는 일
도구 목록
도구 (40)
🟢list_launches(page, page_size)
list your launches with pagination
입력 스키마
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default: 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default: 50, max: 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴create_launch(title, product_description, platforms, product_url, save_to_library, ...)
create a new launch for publishing to social platforms
입력 스키마
{
"type": "object",
"properties": {
"title": {
"type": "string",
"description": "launch title"
},
"product_description": {
"type": "string",
"description": "product description — required unless product_url, custom_content, or platform_contents is provided"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
]
},
"minItems": 1,
"maxItems": 10,
"description": "target platforms - required unless dropspace_platforms or user_platform_accounts is provided (inferred from their union)"
},
"product_url": {
"type": "string",
"format": "uri",
"description": "product URL — scraped to generate content; can substitute for product_description"
},
"save_to_library": {
"type": "boolean",
"description": "add the launch's uploaded media to the user's media library so autopilot can post it"
},
"track_links": {
"type": "boolean",
"description": "swap product_url in post copy for tracked redirects (twitter, linkedin, facebook, reddit, youtube); clicks show as metrics.tracked_clicks in analytics"
},
"scheduled_date": {
"type": "string",
"description": "ISO 8601 datetime to schedule (must be at least 15 minutes in the future)"
},
"persona_id": {
"type": "string",
"format": "uuid",
"description": "persona ID for tone/style"
},
"dropspace_platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
]
},
"description": "platforms to post via official dropspace accounts"
},
"attribution_mode": {
"type": "string",
"enum": [
"handle",
"anonymous"
],
"description": "how official-account posts credit the author: \"handle\" (default) signs with the connected @handle on that platform when one exists, \"anonymous\" always uses the plain \"posted from dropspace user\" note"
},
"media_mode": {
"type": "string",
"enum": [
"images",
"video"
],
"description": "media mode for the launch"
},
"user_platform_accounts": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "map of platform key to token_id (UUID). a simple key targets your primary/only account: \"twitter\", \"reddit\", \"instagram\", \"tiktok\", \"youtube\". to target a SPECIFIC account when you have more than one on the same platform, use a composite key: Instagram/TikTok/YouTube/Twitter/Reddit use \"instagram:<account_id>\" / \"tiktok:<account_id>\" / \"youtube:<account_id>\" / \"twitter:<account_id>\" / \"reddit:<account_id>\" where <account_id> is the account entity_id from list_connections; LinkedIn uses \"linkedin:personal\" or \"linkedin:organization:<org_id>\"; Facebook posts go to a Page: a bare \"facebook\" key works when you have exactly one Page, using any connection id from list_connections as the value (the Page row id or the person row id) so dropspace resolves the Page; to target a specific Page among several, use a composite key, \"facebook:page:<page_id>\" or \"facebook:<page_id>\", where <page_id> is that Page row entity_id from list_connections; with several Pages and no page_id the API returns a 400 listing them. multiple keys allowed (e.g. post to two Instagram accounts at once). for Reddit, each targeted account runs its own subreddit fan-out"
},
"platform_contents": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {}
},
"description": "per-platform content — each value needs \"content\" (string). Instagram takes \"instagram_settings\": { \"post_type\": \"feed\" (default) | \"carousel\" | \"story\" | \"trial_reel\", \"graduation_strategy\"?: \"MANUAL\" (default) | \"SS_PERFORMANCE\" } and Facebook takes \"facebook_settings\": { \"post_type\": \"feed\" | \"story\" } - \"carousel\" (Instagram only) posts every attached image and the launch video as ONE carousel in media order, 2 to 10 items, where \"feed\" would post the video as a reel and leave the images out; \"story\" posts each image as a 24-hour story frame with no caption; \"trial_reel\" (Instagram only) posts the video as a reel shown to non-followers first, off the profile until it graduates - \"MANUAL\" when the creator shares it in the Instagram app, \"SS_PERFORMANCE\" when Instagram sees it performing well; Instagram allows trial reels from professional accounts with 200 or more followers, so a connected account below that bar is refused with the reason; a trial reel needs a video and leaves photos out. Reddit also requires \"title\" (max 300) and supports \"metadata\": { \"subreddits\": string[] (max 10, names without the r/ prefix — posts the launch once per subreddit, each tracked and retryable on its own; omit to post to the default community), \"first_comment\": string (max 1500 — posted as a comment under each reddit post once it goes live) }. for multi-account reddit, each connected account can target its own subreddits via \"reddit:<account_id>\" content keys (falls back to the base \"reddit\" block); a subreddit is posted by at most one of your accounts per launch (first wins, others skipped as SUBREDDIT_ALREADY_TARGETED). each subreddit has its own rules: many restrict or ban promotional posts and posting where the account has no history gets filtered, so target a few genuinely relevant subreddits rather than blasting. Twitter supports \"thread\" (string[], max 6, each ≤280 or ≤25,000 for X Premium) instead of \"content\". TikTok supports \"tiktok_settings\": { \"publish_mode\"?: \"direct\"|\"draft\" (default \"direct\"; \"draft\" uploads to the TikTok inbox to finish and publish in-app), \"privacy_level\": \"PUBLIC_TO_EVERYONE\"|\"FOLLOWER_OF_CREATOR\"|\"MUTUAL_FOLLOW_FRIENDS\"|\"SELF_ONLY\" (required before publish in direct mode; not required for draft), \"allow_comments\"?, \"allow_duet\"?, \"allow_stitch\"?, \"is_commercial\"?, \"is_your_brand\"?, \"is_branded_content\"?, \"auto_add_music\"? (booleans, direct mode), \"cover_timestamp_ms\"? (integer 0-600000 — which frame TikTok uses as the cover, in ms from the start; VIDEO posts only, photo posts take their cover by index; omit for the first frame) }. YouTube requires video and supports \"title\" (max 100 chars). character limits: Twitter 280/tweet (25,000 for X Premium), LinkedIn 3000, Instagram 2200, Reddit 3000, Facebook 3000, TikTok 4000, YouTube 5000 (description). X Premium status is auto-detected from the connected account. mutually exclusive with custom_content"
},
"custom_content": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 6
}
],
"description": "single content string for all platforms, or array of tweet strings for twitter thread mode (each ≤280 chars or ≤25,000 for X Premium, mutually exclusive with platform_contents)"
},
"custom_content_reddit_title": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "reddit title (required when custom_content is used with reddit platform)"
},
"media": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "url"
},
"url": {
"type": "string",
"format": "uri",
"description": "media URL"
},
"filename": {
"type": "string",
"maxLength": 255,
"description": "filename"
}
},
"required": [
"source",
"url"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "base64"
},
"data": {
"type": "string",
"minLength": 1,
"description": "base64-encoded data"
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "filename (required for base64)"
},
"mime_type": {
"type": "string",
"enum": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif",
"video/mp4",
"video/quicktime"
],
"description": "MIME type (required for base64)"
}
},
"required": [
"source",
"data",
"filename",
"mime_type"
],
"additionalProperties": false
}
]
},
"minItems": 1,
"maxItems": 10,
"description": "inline media (URL or base64, 1-10 items, mutually exclusive with media_assets)"
},
"media_assets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "asset ID"
},
"url": {
"type": "string",
"format": "uri",
"description": "asset URL"
},
"type": {
"type": "string",
"enum": [
"image",
"video"
],
"description": "asset type"
},
"filename": {
"type": "string",
"minLength": 1,
"description": "filename"
},
"size": {
"type": "number",
"minimum": 0,
"description": "file size in bytes"
},
"mime_type": {
"type": "string",
"minLength": 1,
"description": "MIME type"
},
"width": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "width in pixels"
},
"height": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "height in pixels"
},
"thumbnail_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "thumbnail URL"
},
"generation_id": {
"type": "string",
"description": "AI generation ID"
}
},
"required": [
"id",
"url",
"type",
"filename",
"size",
"mime_type"
],
"additionalProperties": false
},
"description": "pre-uploaded media asset references (mutually exclusive with media)"
},
"media_attach_platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube"
]
},
"description": "platforms to attach media to"
},
"publish": {
"type": "boolean",
"description": "immediately publish after creation (returns 202). mutually exclusive with scheduled_date"
},
"wait": {
"type": "boolean",
"description": "wait for publishing to complete and return post URLs inline (returns 200). requires publish: true"
}
},
"required": [
"title"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_launch(id)
get a launch by ID with posting status per platform
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴update_launch(id, scheduled_date, status, platforms, name, ...)
update a launch (cannot update running/completed/partial launches)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
},
"scheduled_date": {
"type": [
"string",
"null"
],
"description": "ISO 8601 datetime or null to clear"
},
"status": {
"type": "string",
"enum": [
"draft",
"manual",
"trigger",
"scheduled",
"paused",
"cancelled"
],
"description": "launch status. \"paused\" holds a scheduled launch: it keeps its scheduled_date and does not publish until \"scheduled\" is sent to resume it (send a new scheduled_date too if the time has passed). \"cancelled\" clears the date"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
]
},
"minItems": 1,
"maxItems": 10,
"description": "target platforms for this launch"
},
"name": {
"type": "string",
"maxLength": 200,
"description": "launch name/title"
},
"product_description": {
"type": "string",
"maxLength": 10000,
"description": "product description"
},
"product_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "string",
"const": ""
}
],
"description": "product URL (empty string to clear)"
},
"persona_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
],
"description": "persona ID for content generation, null to clear"
},
"platform_contents": {
"type": "object",
"additionalProperties": {
"type": "object",
"additionalProperties": {}
},
"description": "per-platform content update (deep-merged with existing). each value can include \"content\" (string). Instagram takes \"instagram_settings\": { \"post_type\": \"feed\" | \"carousel\" | \"story\" | \"trial_reel\", \"graduation_strategy\"?: \"MANUAL\" | \"SS_PERFORMANCE\" } (\"carousel\" posts every attached image and the launch video as ONE carousel, 2 to 10 items; \"trial_reel\" posts the video as a reel shown to non-followers first, graduating per graduation_strategy; needs a professional account with 200 or more followers, or the update is refused with the reason) and Facebook takes \"facebook_settings\": { \"post_type\": \"feed\" | \"story\" }. Twitter supports \"thread\" (string[]) instead. Reddit \"title\" is optional on update, and \"metadata\" accepts \"subreddits\" (string[], max 10, no r/ prefix — one post per subreddit) and \"first_comment\" (string, max 1500). TikTok \"tiktok_settings\" is deep-merged — you can update individual fields (e.g. just \"privacy_level\") without overwriting the rest. see create_launch for full field details"
},
"dropspace_platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
]
},
"description": "official dropspace account platforms"
},
"attribution_mode": {
"type": "string",
"enum": [
"handle",
"anonymous"
],
"description": "how official-account posts credit the author (\"handle\" default, \"anonymous\" for the plain note)"
},
"user_platform_accounts": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "map of platform key to token_id (UUID). a simple key targets your primary/only account: \"twitter\", \"reddit\", \"instagram\", \"tiktok\", \"youtube\". to target a SPECIFIC account when you have more than one on the same platform, use a composite key: Instagram/TikTok/YouTube/Twitter/Reddit use \"instagram:<account_id>\" / \"tiktok:<account_id>\" / \"youtube:<account_id>\" / \"twitter:<account_id>\" / \"reddit:<account_id>\" where <account_id> is the account entity_id from list_connections; LinkedIn uses \"linkedin:personal\" or \"linkedin:organization:<org_id>\"; Facebook posts go to a Page: a bare \"facebook\" key works when you have exactly one Page, using any connection id from list_connections as the value (the Page row id or the person row id) so dropspace resolves the Page; to target a specific Page among several, use a composite key, \"facebook:page:<page_id>\" or \"facebook:<page_id>\", where <page_id> is that Page row entity_id from list_connections; with several Pages and no page_id the API returns a 400 listing them. multiple keys allowed (e.g. post to two Instagram accounts at once). for Reddit, each targeted account runs its own subreddit fan-out"
},
"media": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "url"
},
"url": {
"type": "string",
"format": "uri",
"description": "media URL"
},
"filename": {
"type": "string",
"maxLength": 255,
"description": "filename"
}
},
"required": [
"source",
"url"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"source": {
"type": "string",
"const": "base64"
},
"data": {
"type": "string",
"minLength": 1,
"description": "base64-encoded data"
},
"filename": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "filename (required for base64)"
},
"mime_type": {
"type": "string",
"enum": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif",
"video/mp4",
"video/quicktime"
],
"description": "MIME type (required for base64)"
}
},
"required": [
"source",
"data",
"filename",
"mime_type"
],
"additionalProperties": false
}
]
},
"minItems": 1,
"maxItems": 10,
"description": "inline media (URL or base64, 1-10 items, mutually exclusive with media_assets)"
},
"media_assets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "asset ID"
},
"url": {
"type": "string",
"format": "uri",
"description": "asset URL"
},
"type": {
"type": "string",
"enum": [
"image",
"video"
],
"description": "asset type"
},
"filename": {
"type": "string",
"minLength": 1,
"description": "filename"
},
"size": {
"type": "number",
"minimum": 0,
"description": "file size in bytes"
},
"mime_type": {
"type": "string",
"minLength": 1,
"description": "MIME type"
},
"width": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "width in pixels"
},
"height": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"description": "height in pixels"
},
"thumbnail_url": {
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
],
"description": "thumbnail URL"
},
"generation_id": {
"type": "string",
"description": "AI generation ID"
}
},
"required": [
"id",
"url",
"type",
"filename",
"size",
"mime_type"
],
"additionalProperties": false
},
"description": "pre-uploaded media asset references (mutually exclusive with media)"
},
"media_attach_platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube"
]
},
"description": "platforms to attach media to"
},
"media_mode": {
"type": "string",
"enum": [
"images",
"video"
],
"description": "media mode"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_launch(id)
delete a launch (cannot delete running launches)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴publish_launch(id)
publish a launch to all configured platforms (queued async)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴retry_launch(id, subreddit, account_id)
retry failed platforms for a launch. by default every failed platform is retried; pass `subreddit` to retry ONE reddit destination (leaving its siblings — succeeded or failed — untouched), and add `account_id` when that destination belongs to a secondary connected reddit account rather than your primary.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
},
"subreddit": {
"type": "string",
"description": "retry only this reddit destination (name without the r/ prefix)"
},
"account_id": {
"type": "string",
"description": "the connected reddit account that owns the destination (its entity_id from list_connections); omit for your primary account. only meaningful with `subreddit`"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪generate_content(id, platforms)
generate AI content for a launch's platforms using Claude
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
]
},
"minItems": 1,
"maxItems": 10,
"description": "specific platforms to generate for (defaults to all launch platforms)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_launch_analytics(id)
get publishing analytics with per-post engagement metrics (likes, views, shares, etc.). metric fields vary by platform: facebook reports reactions, likes (mirroring reactions.total), comments and shares - it has no impressions or reach, and facebook story metrics are unavailable. an instagram story reports views, reach, replies and frames only while it is live (24 hours, no backfill); under 5 viewers it returns story_insights_withheld instead of numbers
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_batch_launch_analytics(ids)
get cached analytics for multiple launches in one request (no live refresh, max 100 IDs)
입력 스키마
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"minItems": 1,
"maxItems": 100,
"description": "launch IDs to fetch analytics for"
}
},
"required": [
"ids"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_launch_status(id)
get detailed posting status with per-platform logs
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪retry_launch_content(id, platforms)
retry AI content generation for failed platforms (requires generate scope)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
]
},
"minItems": 1,
"description": "specific platforms to retry (defaults to all failed platforms)"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_post(launch_id, posting_log_id)
Delete a single published post from its platform. Only works for Twitter, Facebook, LinkedIn, Reddit, and YouTube. Instagram and TikTok do not support API deletion.
입력 스키마
{
"type": "object",
"properties": {
"launch_id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
},
"posting_log_id": {
"type": "string",
"format": "uuid",
"description": "posting log ID (from launch status)"
}
},
"required": [
"launch_id",
"posting_log_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_all_posts(launch_id)
Delete all published posts for a launch from their platforms. Only deletes from Twitter, Facebook, LinkedIn, Reddit, and YouTube. Instagram and TikTok posts are skipped (require manual deletion).
입력 스키마
{
"type": "object",
"properties": {
"launch_id": {
"type": "string",
"format": "uuid",
"description": "launch ID"
}
},
"required": [
"launch_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_personas(page, page_size)
list your personas with pagination
입력 스키마
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default: 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default: 50, max: 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡create_persona(name)
create a new persona for AI content generation tone/style
입력 스키마
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "persona name (1-100 characters)"
}
},
"required": [
"name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_persona(id)
get a persona by ID with analysis details and writing samples
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "persona ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_persona(id, name, custom_samples, twitter_samples, reddit_samples, ...)
update a persona's name or writing samples
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "persona ID"
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "new persona name"
},
"custom_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "custom writing samples (max 50)"
},
"twitter_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "twitter writing samples (max 50)"
},
"reddit_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "reddit writing samples (max 50)"
},
"facebook_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "facebook writing samples (max 50)"
},
"instagram_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "instagram writing samples (max 50)"
},
"tiktok_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "tiktok writing samples (max 50)"
},
"linkedin_samples": {
"type": "array",
"items": {},
"maxItems": 50,
"description": "linkedin writing samples (max 50)"
},
"brand_kit": {
"anyOf": [
{
"type": "object",
"properties": {
"text_color": {
"type": "string",
"description": "slide text color, #RRGGBB"
},
"outline_color": {
"type": "string",
"description": "slide text outline color, #RRGGBB"
},
"logo_url": {
"type": "string",
"format": "uri",
"description": "public http(s) logo image, drawn in a corner"
},
"logo_position": {
"type": "string",
"enum": [
"top-left",
"top-right",
"bottom-left",
"bottom-right"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "how autopilot image slides look when autopilot posts as this persona; null clears it"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴delete_persona(id)
delete a persona
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "persona ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢analyze_persona(id, platforms, include_custom_samples)
trigger AI analysis of a persona's writing style (queued async)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "persona ID"
},
"platforms": {
"type": "array",
"items": {
"type": "string"
},
"description": "specific platforms to analyze samples from"
},
"include_custom_samples": {
"type": "boolean",
"description": "include custom writing samples in analysis"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪finalize_persona(id, persona_analysis, persona_analysis_structured)
commit a persona's pending analysis after review (the analyzed voice becomes usable)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "persona ID"
},
"persona_analysis": {
"type": "string",
"maxLength": 2000,
"description": "optionally edited analysis text"
},
"persona_analysis_structured": {
"type": "object",
"additionalProperties": {},
"description": "optionally edited structured analysis"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪discard_persona_analysis(id)
discard a persona's pending analysis without committing (preserves any previously saved analysis)
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"description": "persona ID"
}
},
"required": [
"id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_connections(page, page_size)
list your connected social media accounts. each row has a "platform" and an "entity_id" (null for your primary account on that platform, set for additional accounts). to target a specific account in create_launch when you have more than one on instagram / tiktok / youtube / twitter / reddit, pass "{platform}:{entity_id}" as a user_platform_accounts key (the bare "{platform}" key targets your primary). the same entity_id is what disconnect_connection and retry_launch take as account_id
입력 스키마
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default: 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default: 50, max: 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴update_connection_profile(platform, description)
edit the connected account's profile ON the platform. youtube only today: sets the channel description (max 1,000 characters; an empty string clears it) via channels.update. instagram's api can read a profile but not write it, facebook page "about" needs a permission dropspace does not hold, and tiktok / x / linkedin expose no profile write - those return an error with the reason. requires the write scope.
입력 스키마
{
"type": "object",
"properties": {
"platform": {
"type": "string",
"description": "platform whose profile to edit (currently only \"youtube\")"
},
"description": {
"type": "string",
"maxLength": 1000,
"description": "the new profile / channel description (max 1,000 characters)"
}
},
"required": [
"platform",
"description"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_dropspace_status
check which platforms have a connected dropspace official account (requires read scope)
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_usage
get your current plan, usage limits, and billing period (requires read scope)
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_changelog
machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡generate_media(type, launch_id, platform, prompt, product_description, ...)
submit an AI image or video generation job for a launch. Returns 202 with a job_id; poll get_media_job for completion. Requires generate scope. script_video requires platform=instagram|tiktok and prompt is required (not just product_description). video and script_video only support 16:9 and 9:16 aspect ratios.
입력 스키마
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"image",
"video",
"script_video"
],
"description": "generation type"
},
"launch_id": {
"type": "string",
"format": "uuid",
"description": "launch ID this media is for"
},
"platform": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"description": "target platform"
},
"prompt": {
"type": "string",
"description": "explicit prompt — required for script_video"
},
"product_description": {
"type": "string",
"description": "product description (used to derive prompt when no explicit prompt is given)"
},
"reference_image_url": {
"type": "string",
"format": "uri",
"description": "reference image URL — guides image style/composition via the edit endpoint"
},
"use_product_image": {
"type": "boolean",
"description": "use the first image from the launch's product page as the reference (image type only; ignored when reference_image_url is set; errors when the launch has no product image)"
},
"options": {
"type": "object",
"properties": {
"aspect_ratio": {
"type": "string",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"5:4",
"4:5",
"21:9"
],
"description": "aspect ratio"
},
"duration_seconds": {
"type": "number",
"enum": [
4,
6,
8
],
"description": "video duration in seconds (4, 6, or 8)"
},
"seed": {
"type": "number",
"description": "RNG seed for reproducibility"
},
"negative_prompt": {
"type": "string",
"description": "things to avoid in the generation"
}
},
"additionalProperties": false,
"description": "generation options"
}
},
"required": [
"type",
"launch_id",
"platform"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_media_job(job_id)
poll the status of a media generation job. Returns the result_url when complete.
입력 스키마
{
"type": "object",
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"description": "media job ID returned by generate_media"
}
},
"required": [
"job_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_autopilot
get autopilot status: config, queued ideas, and drafts pending review. autopilot is the autonomous content engine that drafts and schedules posts nightly (pro/premium plans).
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴configure_autopilot(enabled, mode, platforms, formats, persona_id, ...)
create or update the autopilot config. merge semantics: only the fields you send change. enabling requires at least one platform with a connected account.
입력 스키마
{
"type": "object",
"properties": {
"enabled": {
"type": "boolean",
"description": "turn nightly runs on/off"
},
"mode": {
"type": "string",
"enum": [
"review",
"auto"
],
"description": "review = drafts wait for approval; auto = publishes on schedule"
},
"platforms": {
"type": "array",
"items": {
"type": "string",
"enum": [
"facebook",
"linkedin",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube"
]
},
"description": "platforms to post on (must have connected accounts)"
},
"formats": {
"type": "array",
"items": {
"type": "string",
"enum": [
"text",
"visual",
"video"
]
},
"description": "content formats the engine may produce"
},
"persona_id": {
"type": [
"string",
"null"
],
"description": "voice persona uuid (null to clear)"
},
"posting_times": {
"type": "object",
"properties": {
"times": {
"type": "array",
"items": {
"type": "string"
},
"description": "posting times as \"HH:MM\" in the config timezone"
},
"days": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0,
"maximum": 6
},
"description": "days of week (0 = sunday)"
}
},
"required": [
"times",
"days"
],
"additionalProperties": false
},
"run_hour": {
"type": "integer",
"minimum": 0,
"maximum": 23,
"description": "local hour the nightly run fires"
},
"timezone": {
"type": "string",
"description": "IANA timezone, e.g. America/New_York"
},
"product_url": {
"type": [
"string",
"null"
],
"description": "product link included in posts"
},
"media_source": {
"type": "string",
"enum": [
"ai",
"library",
"mixed"
],
"description": "where image and video posts get media: ai (generated), library (only the user's media library), mixed (library first, AI when nothing fits)"
},
"product_image_url": {
"type": [
"string",
"null"
],
"description": "reference image for slideshow posts; omitted = filled from product_url's page when product_url changes; null clears it"
},
"product_brief": {
"type": [
"string",
"null"
],
"description": "what you're building, who it's for (max 2000 chars)"
},
"content_pillars": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"description": "themes the engine rotates across (max 10)"
},
"min_queue": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "ideas to keep queued"
},
"max_posts_per_day": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "daily posting cap"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_autopilot_review(page, page_size)
list autopilot drafts awaiting approval (review mode). each item is a draft launch - approve, reject, or edit it via update_launch first.
입력 스키마
{
"type": "object",
"properties": {
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default: 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "items per page (default: 20, max: 50)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴approve_autopilot_draft(launch_id)
approve an autopilot draft - schedules it for publishing (a stale scheduled date rolls forward to the next posting slot).
입력 스키마
{
"type": "object",
"properties": {
"launch_id": {
"type": "string",
"description": "the draft launch id from list_autopilot_review"
}
},
"required": [
"launch_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reject_autopilot_draft(launch_id, feedback)
reject an autopilot draft - deletes it and refunds the launch slot. optional feedback teaches future runs what to avoid.
입력 스키마
{
"type": "object",
"properties": {
"launch_id": {
"type": "string",
"description": "the draft launch id from list_autopilot_review"
},
"feedback": {
"type": "string",
"maxLength": 500,
"description": "why this doesn't work (feeds future generation)"
}
},
"required": [
"launch_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴run_autopilot_now
trigger a manual autopilot run immediately instead of waiting for the nightly run. steps already completed today are skipped (limited to 2 per hour).
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_autopilot_runs(limit)
recent autopilot run history - one row per run step (refresh_insights, generate_blueprints, schedule_slots) with stats and errors.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "rows to return (default: 9)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_recommendations(status, launch_id, page, page_size)
list actionable recommendations computed from your organic post performance: winners to repost, cross-post, or boost, autopilot promote signals, and underperformer pause signals. dropspace sweeps post metrics every 30 minutes and compares each post to your own per-platform baseline.
입력 스키마
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"pending",
"applied",
"dismissed",
"expired"
],
"description": "filter by status (default: all)"
},
"launch_id": {
"type": "string",
"description": "only recommendations for this launch"
},
"page": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "page number (default: 1)"
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "items per page (default: 20, max: 100)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡apply_recommendation(recommendation_id, ad_account_id)
apply a recommendation's one-click action. repost_winner and cross_post create a DRAFT launch seeded with the winning content (nothing publishes until scheduled); boost_winner creates a PAUSED meta boost and requires ad_account_id (activation, and therefore spend, is a separate step); promote_winner queues the winner into autopilot; pause_underperformer adds a standing directive to the autopilot config.
입력 스키마
{
"type": "object",
"properties": {
"recommendation_id": {
"type": "string",
"description": "the recommendation to apply"
},
"ad_account_id": {
"type": "string",
"description": "meta ad account id — required for boost_winner recommendations, ignored otherwise"
}
},
"required": [
"recommendation_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪dismiss_recommendation(recommendation_id)
dismiss a pending recommendation so it stops showing everywhere.
입력 스키마
{
"type": "object",
"properties": {
"recommendation_id": {
"type": "string",
"description": "the recommendation to dismiss"
}
},
"required": [
"recommendation_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_audience(window_days, include_instagram_insights)
follower counts + growth for every connected instagram / youtube / tiktok / twitter account and facebook page. one entry per ACCOUNT, not per platform: "entity_id" is null for your primary account on a platform and set for each additional one, so a user with two instagram accounts returns two instagram entries. counts come from each platform's official API and are cached for 15 minutes. youtube works differently: each youtube read spends a shared daily quota, so while you keep reading a creator's audience, their youtube count is refreshed in the background about once an hour, and an on-demand read re-fetches at most every 6 hours if that refresh is delayed; if the daily quota is exhausted, a youtube read returns the most recent successful count instead of null. "current.captured_at" is always when that count was actually read from the platform, never when it was served: use it to judge freshness. "series" is the stored history; youtube history is kept for 30 days (youtube's API storage limit), so youtube growth reaches back about 30 days whatever window_days says, while other platforms keep full history. growth is measured from the OLDEST stored point inside the window, which — because history points are recorded when you read, at most one per account per day — can be much younger than window_days: read "effective_window_days" (the span the delta actually covers) and "baseline_captured_at" before comparing growth across accounts. linkedin is not covered (its API exposes no personal-profile follower count). set include_instagram_insights to add instagram growth analytics to each instagram entry: follows, unfollows, net, and reach split into followers and non-followers per pacific-time day (the last 7 days are settled: false because instagram still revises them), followers_over_time (an estimate rebuilt back from the current count), weekly velocity with a trend, non_follower_reach_share, and contact-button taps. it reads up to 31 days per call, newest first, so a longer window fills over a few calls (days_pending says how many are left); instagram reports none of it for accounts under 100 followers (available: false).
입력 스키마
{
"type": "object",
"properties": {
"window_days": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"description": "growth window in days (default: 30, max: 365)"
},
"include_instagram_insights": {
"type": "boolean",
"description": "add instagram growth analytics to each instagram entry (default: false)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거