Server definition
- Hash
- sha256:e6f4088db0177b184cedc9d7c2a3306b9c528cbbf07d4d3f7e4a0b725d4c63a2
- What it is
- What a remote MCP server returned when asked what it offers: 40 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "trigger AI analysis of a persona's writing style (queued async)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "persona ID",
"format": "uuid",
"type": "string"
},
"include_custom_samples": {
"description": "include custom writing samples in analysis",
"type": "boolean"
},
"platforms": {
"description": "specific platforms to analyze samples from",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "analyze_persona",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ad_account_id": {
"description": "meta ad account id — required for boost_winner recommendations, ignored otherwise",
"type": "string"
},
"recommendation_id": {
"description": "the recommendation to apply",
"type": "string"
}
},
"required": [
"recommendation_id"
],
"type": "object"
},
"name": "apply_recommendation",
"outputSchema": null
},
{
"description": "approve an autopilot draft - schedules it for publishing (a stale scheduled date rolls forward to the next posting slot).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"launch_id": {
"description": "the draft launch id from list_autopilot_review",
"type": "string"
}
},
"required": [
"launch_id"
],
"type": "object"
},
"name": "approve_autopilot_draft",
"outputSchema": null
},
{
"description": "create or update the autopilot config. merge semantics: only the fields you send change. enabling requires at least one platform with a connected account.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"content_pillars": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"description": "themes the engine rotates across (max 10)"
},
"enabled": {
"description": "turn nightly runs on/off",
"type": "boolean"
},
"formats": {
"description": "content formats the engine may produce",
"items": {
"enum": [
"text",
"visual",
"video"
],
"type": "string"
},
"type": "array"
},
"max_posts_per_day": {
"description": "daily posting cap",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"media_source": {
"description": "where image and video posts get media: ai (generated), library (only the user's media library), mixed (library first, AI when nothing fits)",
"enum": [
"ai",
"library",
"mixed"
],
"type": "string"
},
"min_queue": {
"description": "ideas to keep queued",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"mode": {
"description": "review = drafts wait for approval; auto = publishes on schedule",
"enum": [
"review",
"auto"
],
"type": "string"
},
"persona_id": {
"description": "voice persona uuid (null to clear)",
"type": [
"string",
"null"
]
},
"platforms": {
"description": "platforms to post on (must have connected accounts)",
"items": {
"enum": [
"facebook",
"linkedin",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube"
],
"type": "string"
},
"type": "array"
},
"posting_times": {
"additionalProperties": false,
"properties": {
"days": {
"description": "days of week (0 = sunday)",
"items": {
"maximum": 6,
"minimum": 0,
"type": "integer"
},
"type": "array"
},
"times": {
"description": "posting times as \"HH:MM\" in the config timezone",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"times",
"days"
],
"type": "object"
},
"product_brief": {
"description": "what you're building, who it's for (max 2000 chars)",
"type": [
"string",
"null"
]
},
"product_image_url": {
"description": "reference image for slideshow posts; omitted = filled from product_url's page when product_url changes; null clears it",
"type": [
"string",
"null"
]
},
"product_url": {
"description": "product link included in posts",
"type": [
"string",
"null"
]
},
"run_hour": {
"description": "local hour the nightly run fires",
"maximum": 23,
"minimum": 0,
"type": "integer"
},
"timezone": {
"description": "IANA timezone, e.g. America/New_York",
"type": "string"
}
},
"type": "object"
},
"name": "configure_autopilot",
"outputSchema": null
},
{
"description": "create a new launch for publishing to social platforms",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"attribution_mode": {
"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",
"enum": [
"handle",
"anonymous"
],
"type": "string"
},
"custom_content": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"items": {
"type": "string"
},
"maxItems": 6,
"minItems": 1,
"type": "array"
}
],
"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": {
"description": "reddit title (required when custom_content is used with reddit platform)",
"maxLength": 300,
"minLength": 1,
"type": "string"
},
"dropspace_platforms": {
"description": "platforms to post via official dropspace accounts",
"items": {
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"type": "array"
},
"media": {
"description": "inline media (URL or base64, 1-10 items, mutually exclusive with media_assets)",
"items": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"filename": {
"description": "filename",
"maxLength": 255,
"type": "string"
},
"source": {
"const": "url",
"type": "string"
},
"url": {
"description": "media URL",
"format": "uri",
"type": "string"
}
},
"required": [
"source",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"data": {
"description": "base64-encoded data",
"minLength": 1,
"type": "string"
},
"filename": {
"description": "filename (required for base64)",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"mime_type": {
"description": "MIME type (required for base64)",
"enum": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif",
"video/mp4",
"video/quicktime"
],
"type": "string"
},
"source": {
"const": "base64",
"type": "string"
}
},
"required": [
"source",
"data",
"filename",
"mime_type"
],
"type": "object"
}
]
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"media_assets": {
"description": "pre-uploaded media asset references (mutually exclusive with media)",
"items": {
"additionalProperties": false,
"properties": {
"filename": {
"description": "filename",
"minLength": 1,
"type": "string"
},
"generation_id": {
"description": "AI generation ID",
"type": "string"
},
"height": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "height in pixels"
},
"id": {
"description": "asset ID",
"minLength": 1,
"type": "string"
},
"mime_type": {
"description": "MIME type",
"minLength": 1,
"type": "string"
},
"size": {
"description": "file size in bytes",
"minimum": 0,
"type": "number"
},
"thumbnail_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "thumbnail URL"
},
"type": {
"description": "asset type",
"enum": [
"image",
"video"
],
"type": "string"
},
"url": {
"description": "asset URL",
"format": "uri",
"type": "string"
},
"width": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "width in pixels"
}
},
"required": [
"id",
"url",
"type",
"filename",
"size",
"mime_type"
],
"type": "object"
},
"type": "array"
},
"media_attach_platforms": {
"description": "platforms to attach media to",
"items": {
"enum": [
"facebook",
"linkedin",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube"
],
"type": "string"
},
"type": "array"
},
"media_mode": {
"description": "media mode for the launch",
"enum": [
"images",
"video"
],
"type": "string"
},
"persona_id": {
"description": "persona ID for tone/style",
"format": "uuid",
"type": "string"
},
"platform_contents": {
"additionalProperties": {
"additionalProperties": {},
"type": "object"
},
"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",
"type": "object"
},
"platforms": {
"description": "target platforms - required unless dropspace_platforms or user_platform_accounts is provided (inferred from their union)",
"items": {
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"product_description": {
"description": "product description — required unless product_url, custom_content, or platform_contents is provided",
"type": "string"
},
"product_url": {
"description": "product URL — scraped to generate content; can substitute for product_description",
"format": "uri",
"type": "string"
},
"publish": {
"description": "immediately publish after creation (returns 202). mutually exclusive with scheduled_date",
"type": "boolean"
},
"save_to_library": {
"description": "add the launch's uploaded media to the user's media library so autopilot can post it",
"type": "boolean"
},
"scheduled_date": {
"description": "ISO 8601 datetime to schedule (must be at least 15 minutes in the future)",
"type": "string"
},
"title": {
"description": "launch title",
"type": "string"
},
"track_links": {
"description": "swap product_url in post copy for tracked redirects (twitter, linkedin, facebook, reddit, youtube); clicks show as metrics.tracked_clicks in analytics",
"type": "boolean"
},
"user_platform_accounts": {
"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",
"type": "object"
},
"wait": {
"description": "wait for publishing to complete and return post URLs inline (returns 200). requires publish: true",
"type": "boolean"
}
},
"required": [
"title"
],
"type": "object"
},
"name": "create_launch",
"outputSchema": null
},
{
"description": "create a new persona for AI content generation tone/style",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"name": {
"description": "persona name (1-100 characters)",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "create_persona",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"launch_id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"launch_id"
],
"type": "object"
},
"name": "delete_all_posts",
"outputSchema": null
},
{
"description": "delete a launch (cannot delete running launches)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_launch",
"outputSchema": null
},
{
"description": "delete a persona",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "persona ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "delete_persona",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"launch_id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
},
"posting_log_id": {
"description": "posting log ID (from launch status)",
"format": "uuid",
"type": "string"
}
},
"required": [
"launch_id",
"posting_log_id"
],
"type": "object"
},
"name": "delete_post",
"outputSchema": null
},
{
"description": "discard a persona's pending analysis without committing (preserves any previously saved analysis)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "persona ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "discard_persona_analysis",
"outputSchema": null
},
{
"description": "dismiss a pending recommendation so it stops showing everywhere.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"recommendation_id": {
"description": "the recommendation to dismiss",
"type": "string"
}
},
"required": [
"recommendation_id"
],
"type": "object"
},
"name": "dismiss_recommendation",
"outputSchema": null
},
{
"description": "commit a persona's pending analysis after review (the analyzed voice becomes usable)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "persona ID",
"format": "uuid",
"type": "string"
},
"persona_analysis": {
"description": "optionally edited analysis text",
"maxLength": 2000,
"type": "string"
},
"persona_analysis_structured": {
"additionalProperties": {},
"description": "optionally edited structured analysis",
"type": "object"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "finalize_persona",
"outputSchema": null
},
{
"description": "generate AI content for a launch's platforms using Claude",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
},
"platforms": {
"description": "specific platforms to generate for (defaults to all launch platforms)",
"items": {
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "generate_content",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"launch_id": {
"description": "launch ID this media is for",
"format": "uuid",
"type": "string"
},
"options": {
"additionalProperties": false,
"description": "generation options",
"properties": {
"aspect_ratio": {
"description": "aspect ratio",
"enum": [
"1:1",
"16:9",
"9:16",
"4:3",
"3:4",
"3:2",
"2:3",
"5:4",
"4:5",
"21:9"
],
"type": "string"
},
"duration_seconds": {
"description": "video duration in seconds (4, 6, or 8)",
"enum": [
4,
6,
8
],
"type": "number"
},
"negative_prompt": {
"description": "things to avoid in the generation",
"type": "string"
},
"seed": {
"description": "RNG seed for reproducibility",
"type": "number"
}
},
"type": "object"
},
"platform": {
"description": "target platform",
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"product_description": {
"description": "product description (used to derive prompt when no explicit prompt is given)",
"type": "string"
},
"prompt": {
"description": "explicit prompt — required for script_video",
"type": "string"
},
"reference_image_url": {
"description": "reference image URL — guides image style/composition via the edit endpoint",
"format": "uri",
"type": "string"
},
"type": {
"description": "generation type",
"enum": [
"image",
"video",
"script_video"
],
"type": "string"
},
"use_product_image": {
"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)",
"type": "boolean"
}
},
"required": [
"type",
"launch_id",
"platform"
],
"type": "object"
},
"name": "generate_media",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"include_instagram_insights": {
"description": "add instagram growth analytics to each instagram entry (default: false)",
"type": "boolean"
},
"window_days": {
"description": "growth window in days (default: 30, max: 365)",
"maximum": 365,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "get_audience",
"outputSchema": null
},
{
"description": "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).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_autopilot",
"outputSchema": null
},
{
"description": "get cached analytics for multiple launches in one request (no live refresh, max 100 IDs)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"ids": {
"description": "launch IDs to fetch analytics for",
"items": {
"format": "uuid",
"type": "string"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
}
},
"required": [
"ids"
],
"type": "object"
},
"name": "get_batch_launch_analytics",
"outputSchema": null
},
{
"description": "machine-readable release history (public) - version, date, type, summary, migration notes on breaking entries. the X-Notice header's structured backstory.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_changelog",
"outputSchema": null
},
{
"description": "check which platforms have a connected dropspace official account (requires read scope)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_dropspace_status",
"outputSchema": null
},
{
"description": "get a launch by ID with posting status per platform",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_launch",
"outputSchema": null
},
{
"description": "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",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_launch_analytics",
"outputSchema": null
},
{
"description": "get detailed posting status with per-platform logs",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_launch_status",
"outputSchema": null
},
{
"description": "poll the status of a media generation job. Returns the result_url when complete.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"job_id": {
"description": "media job ID returned by generate_media",
"format": "uuid",
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "get_media_job",
"outputSchema": null
},
{
"description": "get a persona by ID with analysis details and writing samples",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "persona ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "get_persona",
"outputSchema": null
},
{
"description": "get your current plan, usage limits, and billing period (requires read scope)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "get_usage",
"outputSchema": null
},
{
"description": "list autopilot drafts awaiting approval (review mode). each item is a draft launch - approve, reject, or edit it via update_launch first.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"page": {
"description": "page number (default: 1)",
"exclusiveMinimum": 0,
"type": "integer"
},
"page_size": {
"description": "items per page (default: 20, max: 50)",
"maximum": 50,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_autopilot_review",
"outputSchema": null
},
{
"description": "recent autopilot run history - one row per run step (refresh_insights, generate_blueprints, schedule_slots) with stats and errors.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"limit": {
"description": "rows to return (default: 9)",
"maximum": 30,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_autopilot_runs",
"outputSchema": null
},
{
"description": "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",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"page": {
"description": "page number (default: 1)",
"exclusiveMinimum": 0,
"type": "integer"
},
"page_size": {
"description": "items per page (default: 50, max: 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_connections",
"outputSchema": null
},
{
"description": "list your launches with pagination",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"page": {
"description": "page number (default: 1)",
"exclusiveMinimum": 0,
"type": "integer"
},
"page_size": {
"description": "items per page (default: 50, max: 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_launches",
"outputSchema": null
},
{
"description": "list your personas with pagination",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"page": {
"description": "page number (default: 1)",
"exclusiveMinimum": 0,
"type": "integer"
},
"page_size": {
"description": "items per page (default: 50, max: 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"type": "object"
},
"name": "list_personas",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"launch_id": {
"description": "only recommendations for this launch",
"type": "string"
},
"page": {
"description": "page number (default: 1)",
"exclusiveMinimum": 0,
"type": "integer"
},
"page_size": {
"description": "items per page (default: 20, max: 100)",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"status": {
"description": "filter by status (default: all)",
"enum": [
"pending",
"applied",
"dismissed",
"expired"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_recommendations",
"outputSchema": null
},
{
"description": "publish a launch to all configured platforms (queued async)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "publish_launch",
"outputSchema": null
},
{
"description": "reject an autopilot draft - deletes it and refunds the launch slot. optional feedback teaches future runs what to avoid.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"feedback": {
"description": "why this doesn't work (feeds future generation)",
"maxLength": 500,
"type": "string"
},
"launch_id": {
"description": "the draft launch id from list_autopilot_review",
"type": "string"
}
},
"required": [
"launch_id"
],
"type": "object"
},
"name": "reject_autopilot_draft",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"account_id": {
"description": "the connected reddit account that owns the destination (its entity_id from list_connections); omit for your primary account. only meaningful with `subreddit`",
"type": "string"
},
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
},
"subreddit": {
"description": "retry only this reddit destination (name without the r/ prefix)",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "retry_launch",
"outputSchema": null
},
{
"description": "retry AI content generation for failed platforms (requires generate scope)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
},
"platforms": {
"description": "specific platforms to retry (defaults to all failed platforms)",
"items": {
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"minItems": 1,
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "retry_launch_content",
"outputSchema": null
},
{
"description": "trigger a manual autopilot run immediately instead of waiting for the nightly run. steps already completed today are skipped (limited to 2 per hour).",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "run_autopilot_now",
"outputSchema": null
},
{
"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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"description": {
"description": "the new profile / channel description (max 1,000 characters)",
"maxLength": 1000,
"type": "string"
},
"platform": {
"description": "platform whose profile to edit (currently only \"youtube\")",
"type": "string"
}
},
"required": [
"platform",
"description"
],
"type": "object"
},
"name": "update_connection_profile",
"outputSchema": null
},
{
"description": "update a launch (cannot update running/completed/partial launches)",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"attribution_mode": {
"description": "how official-account posts credit the author (\"handle\" default, \"anonymous\" for the plain note)",
"enum": [
"handle",
"anonymous"
],
"type": "string"
},
"dropspace_platforms": {
"description": "official dropspace account platforms",
"items": {
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"type": "array"
},
"id": {
"description": "launch ID",
"format": "uuid",
"type": "string"
},
"media": {
"description": "inline media (URL or base64, 1-10 items, mutually exclusive with media_assets)",
"items": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"filename": {
"description": "filename",
"maxLength": 255,
"type": "string"
},
"source": {
"const": "url",
"type": "string"
},
"url": {
"description": "media URL",
"format": "uri",
"type": "string"
}
},
"required": [
"source",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"properties": {
"data": {
"description": "base64-encoded data",
"minLength": 1,
"type": "string"
},
"filename": {
"description": "filename (required for base64)",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"mime_type": {
"description": "MIME type (required for base64)",
"enum": [
"image/jpeg",
"image/png",
"image/webp",
"image/gif",
"video/mp4",
"video/quicktime"
],
"type": "string"
},
"source": {
"const": "base64",
"type": "string"
}
},
"required": [
"source",
"data",
"filename",
"mime_type"
],
"type": "object"
}
]
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"media_assets": {
"description": "pre-uploaded media asset references (mutually exclusive with media)",
"items": {
"additionalProperties": false,
"properties": {
"filename": {
"description": "filename",
"minLength": 1,
"type": "string"
},
"generation_id": {
"description": "AI generation ID",
"type": "string"
},
"height": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "height in pixels"
},
"id": {
"description": "asset ID",
"minLength": 1,
"type": "string"
},
"mime_type": {
"description": "MIME type",
"minLength": 1,
"type": "string"
},
"size": {
"description": "file size in bytes",
"minimum": 0,
"type": "number"
},
"thumbnail_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
],
"description": "thumbnail URL"
},
"type": {
"description": "asset type",
"enum": [
"image",
"video"
],
"type": "string"
},
"url": {
"description": "asset URL",
"format": "uri",
"type": "string"
},
"width": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"description": "width in pixels"
}
},
"required": [
"id",
"url",
"type",
"filename",
"size",
"mime_type"
],
"type": "object"
},
"type": "array"
},
"media_attach_platforms": {
"description": "platforms to attach media to",
"items": {
"enum": [
"facebook",
"linkedin",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube"
],
"type": "string"
},
"type": "array"
},
"media_mode": {
"description": "media mode",
"enum": [
"images",
"video"
],
"type": "string"
},
"name": {
"description": "launch name/title",
"maxLength": 200,
"type": "string"
},
"persona_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"description": "persona ID for content generation, null to clear"
},
"platform_contents": {
"additionalProperties": {
"additionalProperties": {},
"type": "object"
},
"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",
"type": "object"
},
"platforms": {
"description": "target platforms for this launch",
"items": {
"enum": [
"facebook",
"linkedin",
"linkedin-community",
"twitter",
"reddit",
"instagram",
"tiktok",
"youtube",
"substack",
"producthunt",
"hackernews"
],
"type": "string"
},
"maxItems": 10,
"minItems": 1,
"type": "array"
},
"product_description": {
"description": "product description",
"maxLength": 10000,
"type": "string"
},
"product_url": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"const": "",
"type": "string"
}
],
"description": "product URL (empty string to clear)"
},
"scheduled_date": {
"description": "ISO 8601 datetime or null to clear",
"type": [
"string",
"null"
]
},
"status": {
"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",
"enum": [
"draft",
"manual",
"trigger",
"scheduled",
"paused",
"cancelled"
],
"type": "string"
},
"user_platform_accounts": {
"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",
"type": "object"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_launch",
"outputSchema": null
},
{
"description": "update a persona's name or writing samples",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"brand_kit": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"logo_position": {
"enum": [
"top-left",
"top-right",
"bottom-left",
"bottom-right"
],
"type": "string"
},
"logo_url": {
"description": "public http(s) logo image, drawn in a corner",
"format": "uri",
"type": "string"
},
"outline_color": {
"description": "slide text outline color, #RRGGBB",
"type": "string"
},
"text_color": {
"description": "slide text color, #RRGGBB",
"type": "string"
}
},
"type": "object"
},
{
"type": "null"
}
],
"description": "how autopilot image slides look when autopilot posts as this persona; null clears it"
},
"custom_samples": {
"description": "custom writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
},
"facebook_samples": {
"description": "facebook writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
},
"id": {
"description": "persona ID",
"format": "uuid",
"type": "string"
},
"instagram_samples": {
"description": "instagram writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
},
"linkedin_samples": {
"description": "linkedin writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
},
"name": {
"description": "new persona name",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"reddit_samples": {
"description": "reddit writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
},
"tiktok_samples": {
"description": "tiktok writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
},
"twitter_samples": {
"description": "twitter writing samples (max 50)",
"items": {},
"maxItems": 50,
"type": "array"
}
},
"required": [
"id"
],
"type": "object"
},
"name": "update_persona",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:e6f4088db0177b184cedc9d7c2a3306b9c528cbbf07d4d3f7e4a0b725d4c63a2 | sha256sum