# OneUp — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_oneup?ms=1787291160000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `oneup_comment_on_post`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/oneup`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/oneup/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/oneup/comment/on/post` — Publish a new top-level comment on a social post through a connected OneUp social account.
  - body: { comment: string, post_id: string, platform: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/create/image/post` — Create a scheduled, timeslot, or draft image post for selected OneUp social accounts.
  - body: { 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 }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/oneup/create/text/post` — Create a scheduled, timeslot, or draft text post for selected OneUp social accounts.
  - body: { 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 }
- `POST https://api.mcp.ai/api/oneup/create/video/post` — Create a scheduled, timeslot, or draft video post for selected OneUp social accounts.
  - body: { 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 }
- `POST https://api.mcp.ai/api/oneup/delete/comment` — Permanently and irreversibly delete a social-platform comment and its local OneUp record. This action cannot be undone.
  - body: { post_id: string, platform: string, comment_id: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/delete/scheduled/post` — Permanently and irreversibly delete an unpublished scheduled OneUp post. This action cannot be undone.
  - body: { post_id: string }
- `POST https://api.mcp.ai/api/oneup/edit/scheduled/post` — Replace the content and optionally the title of a scheduled OneUp post.
  - body: { title?: string, content: string, post_id: string }
- `POST https://api.mcp.ai/api/oneup/get/analytics/overview` — Get account-level overview metrics and ranked performance for a connected account on a supported social platform.
  - body: { preset?: string, end_date?: string, platform: string, timezone?: string, start_date?: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/get/audience/demographics` — Get audience demographics for a connected Facebook, Instagram, TikTok, or YouTube account for a preset or custom reporting period.
  - body: { preset?: string, end_date?: string, platform: string, timezone?: string, start_date?: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/get/content/analytics` — Get per-post, Reel, or Story analytics for a connected account on a supported social platform.
  - body: { preset?: string, end_date?: string, platform: string, timezone?: string, start_date?: string, content_type?: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/get/google/business/reviews` — Get Google Business Profile reviews and aggregate rating information for a connected account or location.
  - body: { preset?: string, end_date?: string, timezone?: string, start_date?: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/get/meta/ads/analytics` — Get campaign, ad-set, or individual-ad analytics for a connected Meta Ads account.
  - body: { level: string, preset?: string, end_date?: string, timezone?: string, start_date?: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/list/categories` — List OneUp categories used to group connected social accounts.
- `POST https://api.mcp.ai/api/oneup/list/category/accounts` — List social accounts assigned to a OneUp category. An unknown category and a category with no accounts both return an empty list.
  - body: { category_id: integer }
- `POST https://api.mcp.ai/api/oneup/list/comment/replies` — Fetch child replies for a parent social-platform comment.
  - body: { comment_id: string }
- `POST https://api.mcp.ai/api/oneup/list/comment/threads` — 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
  - body: { filter?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/oneup/list/instagram/trending/sounds` — Search Instagram trending sounds for a Facebook-connected Instagram Business or Creator account.
  - body: { search_query: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/list/pinterest/boards` — 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.
  - body: { pinterest_username: string }
- `POST https://api.mcp.ai/api/oneup/list/posts` — List scheduled, published, or failed OneUp posts, one page at a time.
  - body: { status: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/oneup/list/social/accounts` — List all connected OneUp social accounts and their connection health.
- `POST https://api.mcp.ai/api/oneup/list/tiktok/trending/sounds` — Get TikTok trending commercial sounds for a documented country, period, genre, and connected TikTok account.
  - body: { genre: string, date_range: string, country_code: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/list/youtube/playlists` — List playlists for a connected YouTube channel. Use a returned playlist name and ID when targeting a video post.
  - body: { social_account_id: string }
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/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.
- `POST https://api.mcp.ai/api/oneup/reply/to/comment` — Publish a direct reply to an existing social-platform comment.
  - body: { comment: string, post_id: string, platform: string, parent_comment_id: string, social_account_id: string }
- `POST https://api.mcp.ai/api/oneup/reschedule/failed/post` — Move a failed post back into the schedule at a future date and time.
  - body: { post_id: string, scheduled_date_time: string }

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

## More
- Page: https://mcp.ai/oneup
- Agent spec (llms.txt): https://mcp.ai/oneup/llms.txt
- Postman collection: https://mcp.ai/oneup/postman.json