# OneUp — MCP server on mcp.ai
> Connect your OneUp account and use 27 tools for social media marketing straight from your AI agent. Connect with your own API key. OneUp is a social media management platform for scheduling and managing posts, comments, connected accounts, media, and analytics across multiple social networks.

By: mcp.ai · official
Page: https://mcp.ai/oneup

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_oneup?ms=1787293500000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/oneup/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/oneup/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/oneup/skill.md
Postman collection (v2.1): https://mcp.ai/oneup/postman.json

## Tools
- oneup_comment_on_post(comment: string, post_id: string, platform: string, social_account_id: string) — Publish a new top-level comment on a social post through a connected OneUp social account.
- oneup_create_image_post(title?: string, content: string, is_draft?: boolean, image_urls: string[], category_id: integer, first_comment?: string, publish_to_all?: boolean, tiktok_options?: object, facebook_options?: object, snapchat_options?: object, instagram_options?: object, pinterest_options?: object, image_to_gbp_photo?: boolean, social_account_ids?: string[], scheduled_date_time: string, google_business_options?: object) — Create a scheduled, timeslot, or draft image post for selected OneUp social accounts.
- oneup_create_media_upload_url() — Create a temporary OneUp media upload URL and return instructions for a separate direct upload. This tool does not upload media.
- oneup_create_text_post(title?: string, content: string, is_draft?: boolean, category_id: integer, first_comment?: string, publish_to_all?: boolean, facebook_options?: object, social_account_ids?: string[], scheduled_date_time: string, google_business_options?: object) — Create a scheduled, timeslot, or draft text post for selected OneUp social accounts.
- oneup_create_video_post(title?: string, content: string, is_draft?: boolean, video_url: string, category_id: integer, first_comment?: string, thumbnail_url?: string, publish_to_all?: boolean, tiktok_options?: object, youtube_options?: object, facebook_options?: object, snapchat_options?: object, instagram_options?: object, pinterest_options?: object, social_account_ids?: string[], scheduled_date_time: string, google_business_options?: object) — Create a scheduled, timeslot, or draft video post for selected OneUp social accounts.
- oneup_delete_comment(post_id: string, platform: string, comment_id: string, social_account_id: string) — Permanently and irreversibly delete a social-platform comment and its local OneUp record. This action cannot be undone.
- oneup_delete_scheduled_post(post_id: string) — Permanently and irreversibly delete an unpublished scheduled OneUp post. This action cannot be undone.
- oneup_edit_scheduled_post(title?: string, content: string, post_id: string) — Replace the content and optionally the title of a scheduled OneUp post.
- oneup_get_analytics_overview(preset?: string, end_date?: string, platform: string, timezone?: string, start_date?: string, social_account_id: string) — Get account-level overview metrics and ranked performance for a connected account on a supported social platform.
- oneup_get_audience_demographics(preset?: string, end_date?: string, platform: string, timezone?: string, start_date?: string, social_account_id: string) — Get audience demographics for a connected Facebook, Instagram, TikTok, or YouTube account for a preset or custom reporting period.
- oneup_get_content_analytics(preset?: string, end_date?: string, platform: string, timezone?: string, start_date?: string, content_type?: string, social_account_id: string) — Get per-post, Reel, or Story analytics for a connected account on a supported social platform.
- oneup_get_google_business_reviews(preset?: string, end_date?: string, timezone?: string, start_date?: string, social_account_id: string) — Get Google Business Profile reviews and aggregate rating information for a connected account or location.
- oneup_get_meta_ads_analytics(level: string, preset?: string, end_date?: string, timezone?: string, start_date?: string, social_account_id: string) — Get campaign, ad-set, or individual-ad analytics for a connected Meta Ads account.
- oneup_list_categories() — List OneUp categories used to group connected social accounts.
- oneup_list_category_accounts(category_id: integer) — List social accounts assigned to a OneUp category. An unknown category and a category with no accounts both return an empty list.
- oneup_list_comment_replies(comment_id: string) — Fetch child replies for a parent social-platform comment.
- oneup_list_comment_threads(filter?: string, next_cursor?: string) — List social posts with top-level comments and child replies in the requested order, one page at a time. A processing status means OneUp is still preparing the data and the read should be retried later
- oneup_list_instagram_trending_sounds(search_query: string, social_account_id: string) — Search Instagram trending sounds for a Facebook-connected Instagram Business or Creator account.
- oneup_list_pinterest_boards(pinterest_username: string) — List boards available to a connected Pinterest username for post targeting. Use a returned board name and ID when creating an image or video post.
- oneup_list_posts(status: string, next_cursor?: string) — List scheduled, published, or failed OneUp posts, one page at a time.
- oneup_list_social_accounts() — List all connected OneUp social accounts and their connection health.
- oneup_list_tiktok_trending_sounds(genre: string, date_range: string, country_code: string, social_account_id: string) — Get TikTok trending commercial sounds for a documented country, period, genre, and connected TikTok account.
- oneup_list_youtube_playlists(social_account_id: string) — List playlists for a connected YouTube channel. Use a returned playlist name and ID when targeting a video post.
- oneup_refresh_analytics() — Start a background refresh of analytics for all connected social accounts. Returns immediately with the provider's status and progress; it does not poll or retry.
- oneup_refresh_comments() — Start a background refresh of comments from connected social platforms. Returns immediately with started, already_in_progress, or cooldown status; it does not poll or retry.
- oneup_reply_to_comment(comment: string, post_id: string, platform: string, parent_comment_id: string, social_account_id: string) — Publish a direct reply to an existing social-platform comment.
- oneup_reschedule_failed_post(post_id: string, scheduled_date_time: string) — Move a failed post back into the schedule at a future date and time.

## Example prompts
- "What can I do in OneUp?"
- "Show me a summary of my OneUp account"

## Links
Docs: https://mcp.ai/docs/mcps/oneup
Website: https://mcp.ai/mcps/oneup